O que é o Framework CO-STAR
O Framework CO-STAR é um padrão de prompt engineering para instruções complexas onde você precisa que os modelos entendam não apenas o que fazer, mas como, para quem e em que estilo. Em vez de escrever uma única frase vaga, você divide seu prompt em componentes CO-STAR explícitos para que todos os modelos de linguagem recebam um briefing completo.
O acrônimo se expande tipicamente como:
- Contexto: Informações de fundo e fatos relevantes.
- Objetivo: O único objetivo principal da tarefa.
- Estilo: Preferências estruturais ou retóricas (por exemplo "explicação passo a passo").
- Tom: O sabor emocional ou a voz (por exemplo "formal", "amigável", "direto").
- Audiência: Quem irá ler ou usar a saída.
- Resposta: O formato exato de saída que você espera.
Por que o Framework CO-STAR funciona
O Framework CO-STAR funciona porque reflete como os humanos escrevem bons briefings: torna o modelo ciente do contexto, objetivo e audiência antes de começar a gerar. Quando esses elementos são explícitos, o modelo não precisa inferi-los de uma instrução curta e ambígua.
Isso leva a vários benefícios práticos:
- Maior consistência entre execuções, porque a mesma estrutura é reutilizada.
- Colaboração mais fácil, pois o prompt se lê como uma especificação compartilhada.
- Melhor comparabilidade entre modelos, porque todos os provedores veem o mesmo detalhamento.
Os Componentes CO-STAR em Detalhe
Um prompt CO-STAR sólido inclui os seis componentes, cada um escrito como uma instrução ou frase curta e clara. Você pode formatá-los como linhas rotuladas ou como um parágrafo estruturado.
Descrições típicas dos componentes:
- Contexto: Do que trata a tarefa, o que já aconteceu e quaisquer restrições ou fontes de dados.
- Objetivo: Uma declaração concisa de como é o sucesso.
- Estilo: Se você quer uma narrativa, uma lista, um guia passo a passo ou outra estrutura.
- Tom: Se a voz deve ser formal, neutra, conversacional ou outra.
- Audiência: O grupo específico ao qual você está se dirigindo, incluindo seu papel e nível de conhecimento.
- Resposta: O formato necessário, como cabeçalhos, marcadores, limite de comprimento ou campos JSON.
Exemplo: Prompt CO-STAR ruim vs bom
O valor do Framework CO-STAR fica claro quando você compara um prompt não estruturado com um prompt baseado em CO-STAR para a mesma tarefa.
Prompt Ruim
"Explique as APIs para nossos clientes."
Prompt Bom
"Contexto: Oferecemos uma plataforma SaaS e estamos adicionando uma API para que os clientes possam integrar nosso produto com suas ferramentas internas. Muitos deles são usuários empresariais não técnicos. Objetivo: Explicar o que é uma API e por que importa para o nosso produto, de uma forma que reduza o medo e incentive a adoção. Estilo: Use seções curtas com cabeçalhos H2 e marcadores para ideias-chave. Inclua uma analogia simples do mundo real. Tom: Claro, tranquilizador e não técnico. Evite jargão onde possível e explique os termos técnicos necessários. Audiência: Usuários empresariais e gerentes sem experiência em programação. Resposta: Artigo de 700-900 palavras com introdução, 3-4 seções principais e uma conclusão curta que os convide a falar com seu gerente de conta."
Quando usar o Framework CO-STAR
Você deve usar o Framework CO-STAR quando enfrenta tarefas com múltiplas restrições onde audiência, estrutura e tom importam ao mesmo tempo. Isso inclui muitos fluxos de trabalho comuns em produto, marketing, sucesso do cliente e educação.
Casos de uso típicos:
- Escrever documentação de produtos ou guias de integração.
- Criar artigos educacionais ou explicadores para audiências não especializadas.
- Redigir memorandos internos estruturados, notas de estratégia ou documentos de políticas.
- Preparar macros de suporte ou conteúdo do centro de ajuda que deve ser consistente em tom.
Como escrever um prompt CO-STAR na prática
Escrever um prompt CO-STAR é simples se você pensar nisso como preencher seis linhas de um briefing e depois enviá-las juntas como uma instrução.
Um modelo genérico se parece com isso:
- Contexto: O que está acontecendo, sobre o que é, contexto relevante.
- Objetivo: Único objetivo principal para este prompt.
- Estilo: Estrutura preferida, como marcadores, narrativa ou passo a passo.
- Tom: Voz e sensação emocional que você deseja.
- Audiência: Quem lerá isso e o que eles sabem.
- Resposta: Formato exato, comprimento e requisitos especiais.
Como o PromptQuorum implementa o Framework CO-STAR
O PromptQuorum é uma ferramenta de despacho de IA multi-modelo que inclui o Framework CO-STAR como uma de suas opções de prompt integradas para que os usuários possam aplicar o prompting Contexto–Objetivo–Estilo–Tom–Audiência–Resposta sem memorizar o padrão.
Dentro do PromptQuorum, você pode:
- Preencher os campos CO-STAR para uma tarefa e despachar o prompt resultante para múltiplos modelos de linguagem, incluindo opções proprietárias e de código aberto.
- Salvar prompts CO-STAR como modelos para fluxos de trabalho recorrentes, como atualizações de documentação, anúncios de recursos ou resumos trimestrais.
- Compartilhar esses modelos com sua equipe para que todos usem a mesma estrutura, mesmo que sejam novos em prompt engineering.
Usar CO-STAR junto a outros frameworks
Você deve posicionar o Framework CO-STAR junto a outros frameworks de prompt atribuindo a cada um um papel claro no seu fluxo de trabalho.
Uma estratégia simples é:
- Use CO-STAR para explicações estruturadas, guias e peças de comunicação.
- Use CRAFT quando focar em marketing puro e voz da marca para canais específicos.
- Use frameworks de uma etapa ou estilo especificação para saídas com formato estrito como relatórios ou JSON.
- Use frameworks orientados ao raciocínio como Analisar–Planejar–Executar quando quiser que o modelo exponha seu pensamento intermediário.
Dados rápidos
- CO-STAR = Contexto, Objetivo, Estilo, Tom, Audiência, Resposta
- Melhor para: Tarefas de comunicação com múltiplas restrições (documentação, explicadores, integração, memorandos)
- Componentes: 6 — mais que APE (3), comparável a CRAFT (5) e SPECS (5)
- Mínimo viável: Contexto + Objetivo + Resposta (3 de 6)
- Ponto forte: Consciência de Audiência e Tom — CO-STAR é o framework mais centrado na audiência
- Funciona em: Todos os modelos de linguagem — nuvem e local
CO-STAR vs Outros Frameworks de Prompt
| Framework | Componentes | Foco | Melhor Para |
|---|---|---|---|
| CO-STAR | 6 (Contexto, Objetivo, Estilo, Tom, Audiência, Resposta) | Comunicação centrada na audiência | Documentação, explicadores, conteúdo para clientes |
| CRAFT | 5 (Contexto, Papel, Ação, Formato, Objetivo) | Execução de tarefas definida por papel | Marketing, conteúdo específico por canal |
| SPECS | 5 (Situação, Problema, Exemplos, Restrições, Estilo) | Resolução de problemas com exemplos | Tarefas analíticas, resolução de problemas |
| APE | 3 (Analisar, Planejar, Executar) | Raciocínio visível | Análise complexa, estratégia, revisão de código |
| RTF | 3 (Papel, Tarefa, Formato) | Estrutura mínima | Tarefas rápidas, saídas simples |
| Single-Step | 1 (uma instrução) | Velocidade | Tarefas simples e bem definidas |
Erros comuns com o Framework CO-STAR
- 1Escrever o Contexto como uma única frase vaga. Por que prejudica: "Somos uma empresa SaaS" diz ao modelo quase nada. Solução: Inclua contexto específico: que produto, que problema, o que já aconteceu, quais dados estão disponíveis.
- 2Confundir Estilo e Tom. Por que prejudica: Estilo = estrutura (marcadores, cabeçalhos, passo a passo). Tom = voz (formal, amigável, urgente). Solução: Estilo responde "como parece?" Tom responde "como soa?" Mantenha-os em linhas separadas.
- 3Omitir a Audiência para documentos internos. Por que prejudica: "Interno" não é uma audiência. Um memorando para engenheiros se lê diferente de um memorando para o CFO. Solução: Nomeie o papel do leitor, seu nível de conhecimento e o que ele fará com a saída.
- 4Tornar a Resposta vaga demais ("um documento"). Por que prejudica: O modelo escolhe seu próprio comprimento, estrutura e formato — que muda em cada execução. Solução: Especifique o formato (marcadores, cabeçalhos, JSON), comprimento (número de palavras ou seções) e requisitos estruturais (introdução, conclusão, CTA).
Perguntas frequentes
O que significa CO-STAR?
CO-STAR significa Contexto, Objetivo, Estilo, Tom, Audiência e Resposta. Cada letra representa um componente de um prompt de IA estruturado. Juntos, os seis componentes dão ao modelo um briefing completo — equivalente ao que um escritor humano precisaria para produzir a saída correta na primeira tentativa.
Quando devo usar CO-STAR em vez de um prompt mais simples?
Use CO-STAR quando múltiplas dimensões importam ao mesmo tempo — quando a saída precisa de uma estrutura específica E tom E deve ser calibrada para uma audiência particular. Se você só precisa de uma resposta factual ou um formato simples, um prompt mais curto ou abordagem de uma etapa é suficiente.
Em que o CO-STAR difere do CRAFT?
Ambos são frameworks de prompt estruturados mas com ênfases diferentes. CO-STAR (Contexto, Objetivo, Estilo, Tom, Audiência, Resposta) foca nas dimensões de comunicação — quem lê, como deve se sentir. CRAFT (Contexto, Papel, Ação, Formato, Objetivo) foca na execução de tarefas — qual papel o modelo desempenha e que ação realiza.
Em que o CO-STAR difere do SPECS?
SPECS (Situação, Problema, Exemplos, Restrições, Estilo) está orientado à resolução de problemas — começa de um problema e trabalha em direção a uma solução. CO-STAR está orientado à comunicação — começa de uma audiência e trabalha em direção à mensagem correta.
Posso usar CO-STAR com modelos locais via Ollama?
Sim. CO-STAR é uma técnica no nível do prompt — funciona com qualquer modelo que siga instruções. Os modelos locais respondem à mesma estrutura de seis componentes.
Preciso dos seis componentes CO-STAR em cada prompt?
Não. Contexto e Objetivo são essenciais. Estilo, Tom, Audiência e Resposta melhoram a qualidade mas podem ser omitidos para tarefas simples. Comece com Contexto + Objetivo + Resposta como o prompt CO-STAR mínimo viável.
Posso combinar CO-STAR com Chain-of-Thought ou APE?
Sim. CO-STAR define O QUE o modelo deve produzir e COMO deve se sentir. Chain-of-Thought ou APE definem como o modelo deve PENSAR. Você pode usar CO-STAR para o briefing e adicionar "Pense passo a passo antes de produzir a resposta final" como instrução adicional.
Fontes
Leituras relacionadas
Como usar o Framework CO-STAR
- 1Contexto: Forneça informações de fundo relevantes que o modelo precisa. Exemplo: "Oferecemos uma plataforma SaaS adicionando uma API. Muitos clientes são usuários empresariais não técnicos."
- 2Objetivo: Diga o que você quer em uma frase. Exemplo: "Explique o que é uma API e por que importa, de uma forma que reduza o medo e incentive a adoção."
- 3Estilo: Especifique a estrutura. Exemplo: "Use seções curtas com cabeçalhos H2 e marcadores. Inclua uma analogia simples do mundo real."
- 4Tom: Defina a voz e o registro emocional. Exemplo: "Claro, tranquilizador e não técnico. Evite jargão; explique os termos técnicos necessários."
- 5Audiência: Nomeie quem lerá a saída e seu nível de conhecimento. Exemplo: "Usuários empresariais e gerentes sem experiência em programação."
- 6Resposta: Indique o formato exato, o comprimento e o entregável. Exemplo: "Artigo de 700-900 palavras com introdução, 3-4 seções principais e uma conclusão convidando-os a contatar seu gerente de conta."
Perguntas frequentes
O que significa CO-STAR?
CO-STAR significa Contexto, Objetivo, Estilo, Tom, Audiência e Resposta. É um framework de seis partes que ajuda você a escrever prompts claros e estruturados ao definir explicitamente cada elemento que influencia como o modelo produz a saída.
Em que o CO-STAR difere do Chain-of-Thought?
Chain-of-Thought pede ao modelo "pensar passo a passo". CO-STAR define O QUE deve ser a saída e COMO deve se sentir. Eles resolvem problemas diferentes: CoT melhora o raciocínio; CO-STAR melhora a consistência da saída e o alinhamento com a audiência.
Quando devo usar CO-STAR em vez de prompts mais simples?
Use CO-STAR quando a qualidade da saída depende do alinhamento com a audiência, o tom, o estilo ou o formato. Para perguntas factuais simples, prompts mais simples são suficientes.
Posso usar CO-STAR com qualquer modelo de linguagem?
Sim. CO-STAR funciona com todos os principais modelos de linguagem: APIs proprietárias, modelos de código aberto e modelos locais como Ollama. O framework é agnóstico ao modelo.
Devo seguir CO-STAR exatamente?
Não. CO-STAR é um guia, não um modelo rígido. Omita componentes que não se aplicam à sua tarefa, reordene-os ou combine-os com outros frameworks.
Como sei se meu prompt CO-STAR é eficaz?
Teste-o em 3-5 entradas representativas e verifique: (1) A saída corresponde ao estilo especificado? (2) O tom é consistente com seu briefing? (3) A resposta aborda a audiência que você nomeou?
Posso combinar CO-STAR com outros frameworks?
Sim. CO-STAR define O QUE e COMO deve se sentir a saída. Chain-of-Thought ou APE definem COMO o modelo deve PENSAR.
Devo colocar os elementos CO-STAR em uma ordem específica?
Não é exigida uma ordem estrita. Comece com Objetivo para que o modelo saiba o que você quer. Depois adicione Contexto, Audiência, Estilo e Tom conforme necessário.
Preciso dos seis componentes CO-STAR?
Não. Contexto e Objetivo são essenciais. Estilo, Tom, Audiência e Resposta melhoram a qualidade mas podem ser omitidos para tarefas simples.
O CO-STAR funciona com modelos locais como Ollama?
Sim, absolutamente. CO-STAR é uma técnica no nível do prompt — funciona com qualquer modelo que siga instruções.