Como escrever boas instruções para um agente de IA

As instruções do agente, também chamadas de prompt, são o manual de trabalho que a IA lê a cada conversa. Instruções ruins produzem agentes confusos, repetitivos ou fora do escopo. Instruções boas fazem a diferença entre um assistente confiável e um que exige correção constante. Neste artigo, você entenderá uma estrutura simples para escrever instruções e os erros que mais atrapalham. --- ## 1. Estrutura recomendada 1. **Papel:** quem o agente é e a quem atende. 2. **Objetivo:** o que ele deve alcançar na conversa. 3. **Escopo:** o que faz e o que não faz. 4. **Tom de voz:** como se comunica. 5. **Fluxo:** passos esperados, como acolher, entender a necessidade e conduzir ao próximo passo. 6. **Regras e exceções:** o que fazer em casos específicos e quando transferir para uma pessoa. 7. **Exemplos:** respostas boas e ruins para calibrar. --- ## 2. Escreva com clareza - **Frases diretas e afirmativas:** "Faça uma pergunta por vez" funciona melhor do que "tente não fazer muitas perguntas". - **Prioridades explícitas:** indique o que é mais importante quando regras entram em conflito. - **Evite ambiguidade:** "às vezes", "talvez" e "se achar necessário" deixam o agente sem critério. - **Uma regra por linha** facilita a revisão. --- ## 3. Erros comuns - Instruções longas demais, com informações repetidas e contraditórias. - Misturar conhecimento da empresa com comportamento. Preços e políticas ficam melhor na base de conhecimento, que é mais fácil de atualizar. - Esquecer de definir o que fazer quando o agente não sabe. - Não prever tentativas de desviar o assunto. --- ## 4. Teste com casos reais Depois de escrever, teste com conversas parecidas com as que acontecem no dia a dia: perguntas confusas, clientes impacientes, pedidos fora do escopo. Cada falha mostra uma regra que faltou ou ficou ambígua. --- ## 5. Revise por versões Mantenha registro das mudanças e, ao alterar, entregue o texto completo atualizado em vez de remendos soltos, para que a leitura continue coerente. Ajustes pequenos e frequentes funcionam melhor do que reescritas grandes. **Dica prática:** depois de escrever as instruções, peça a alguém da equipe que leia o texto e descreva, com as próprias palavras, o que o agente deve fazer. Se a explicação divergir do que você pretendia, há ambiguidade a corrigir. Essa leitura por uma segunda pessoa encontra falhas que o autor dificilmente percebe. --- ## Conclusão Boas instruções são claras, enxutas e testadas. Trate o prompt como um documento vivo: ele melhora a cada conversa analisada e é a base do comportamento do seu agente.