Anatomia de um prompt claro: tarefa, contexto e saída

Nesta aula, você vai montar um prompt como quem prepara uma ficha de trabalho. Ao final, qualquer pessoa deverá conseguir localizar cinco partes: a tarefa, o contexto, os dados de entrada, as regras e o formato de saída. Nem todo prompt precisa exibir esses títulos, mas pensar nas partes evita esconder decisões importantes numa frase longa e difícil de revisar.

Imagine uma cozinha profissional. O pedido informa o prato; a comanda traz quantidade e mesa; os ingredientes disponíveis limitam o que pode ser usado; as restrições registram alergias; a apresentação define como o prato sai. Misturar tudo num bilhete como “faça algo gostoso para a mesa seis” aumenta a chance de erro. A analogia termina na responsabilidade: um modelo não prova que um dado é seguro nem verifica uma alergia no mundo real. A estrutura organiza informação, mas sistemas e pessoas continuam responsáveis pela validação.

Comece pela tarefa, não pela personalidade

A tarefa usa um verbo observável: classificar, extrair, comparar, resumir, reescrever, planejar ou revisar. “Você é brilhante e muito experiente” descreve uma personagem, mas não diz o que entregar. Papéis podem ajudar a escolher vocabulário e perspectiva, porém não substituem a ação nem os critérios.

Compare duas aberturas:

Você é um especialista incrível. Analise isso para mim.

Compare as duas propostas de fornecedor usando preço total, prazo de entrega,
garantia e condições de cancelamento.

A segunda permite conferir se os quatro critérios apareceram. Ainda falta dizer onde estão as propostas e como apresentar o resultado, mas o trabalho já ficou visível. Um bom teste é perguntar: “qual ação concreta o modelo deve realizar?” Se a resposta depender de explicar oralmente o que você quis dizer, a tarefa ainda está vaga.

Dê somente o contexto que muda a resposta

Contexto explica por que a tarefa existe, quem usará a entrega e quais limites do cenário importam. Para adaptar um comunicado, saber que o público são novos clientes e que o envio ocorrerá por aplicativo pode alterar tom e tamanho. Conhecer a cor do escritório provavelmente não muda nada.

Contexto demais também atrapalha. Documentos enormes aumentam custo, ocupam a janela disponível e escondem o trecho relevante. Antes de colar informação, pergunte qual decisão ela modifica. Se não houver resposta, remova. Se houver, nomeie o vínculo: “use a política abaixo para verificar se cada solicitação está dentro do prazo”. Isso é mais útil do que apenas anexar material e esperar que o modelo adivinhe seu papel.

Separe dados de instruções

Dados de entrada são o conteúdo sobre o qual a tarefa atua: anotações, texto, registros, requisitos ou código. Delimitadores simples ajudam leitores e ferramentas a perceber onde começam e terminam. Títulos Markdown, marcadores ou tags consistentes funcionam; não existe um símbolo universalmente mágico.

## Instruções
Extraia decisões e pendências. Não invente responsáveis.

## Anotações da reunião
[conteúdo fornecido pelo usuário]

## Formato
Tabela com decisão, responsável e pendência.

A separação não torna o dado confiável. Um documento externo pode conter informações falsas ou até frases tentando mudar a tarefa. Mais adiante, você vai tratar prompt injection. Por enquanto, guarde a regra mental: instrução define o trabalho; dado é material a ser analisado. Quando uma aplicação profissional mistura os dois, precisa manter a prioridade fora do alcance do conteúdo do usuário.

Transforme preferências em regras verificáveis

“Seja claro” é uma preferência ampla. “Use frases de até vinte palavras e explique cada sigla na primeira ocorrência” descreve sinais observáveis. “Não invente” é uma direção útil, mas pode ficar mais operacional: “quando o material não trouxer responsável ou prazo, escreva ‘a confirmar’”. A segunda formulação oferece uma saída segura para a ausência de dados.

Evite regras em conflito. “Explique em detalhes” e “responda em uma frase” podem ser impossíveis ao mesmo tempo. Quando houver prioridade, declare-a. Em um resumo executivo, preservar alertas obrigatórios pode ser mais importante do que respeitar um limite exato de palavras. A ordem deveria refletir a decisão real do produto, não uma tentativa de tornar toda frase igualmente absoluta.

Feche com o formato de saída

O formato conecta geração e uso. Uma pessoa pode ler parágrafos; uma planilha precisa de colunas estáveis; uma integração pode exigir estrutura validada por código. Pedir “em JSON” não garante que campos, tipos e regras estejam corretos. Quando a saída alimenta software, use os recursos de saída estruturada do fornecedor e valide o resultado. Nesta aula, nosso foco é definir o contrato em linguagem simples.

Use o laboratório para retirar uma seção por vez do prompt de reunião. Sem a tarefa, ainda fica claro o que fazer? Sem as regras, como tratar prazo ausente? Sem o formato, duas pessoas imaginariam a mesma entrega? Depois restaure e remova detalhes decorativos. Esse contraste mostra a função de cada parte sem atribuir ao laboratório uma resposta de modelo: ele apenas organiza o texto.

O erro comum é confundir tamanho com qualidade. Um prompt de três páginas pode repetir a mesma instrução e esconder o dado principal; um prompt curto pode faltar uma restrição decisiva. A medida correta é funcional: cada seção ajuda a executar ou avaliar o trabalho? Você concluiu a aula quando consegue responder essa pergunta linha por linha e entregar o prompt para revisão sem explicações fora do documento.