Escrevendo Prompts Melhores para Agentes de IA

Depois de construir agentes de IA no último ano, aprendi que a qualidade do prompt é a maior alavanca para confiabilidade. Um prompt bem elaborado pode transformar um chatbot alucinante em uma ferramenta confiável.

A Mensagem de Sistema É Tudo

A maioria das pessoas foca na mensagem do usuário. Isso é inverso. A mensagem de sistema define todo o limite comportamental. Pense nela como a descrição do cargo do agente, expectativas pouco claras produzem resultados pouco claros.

Três regras que sigo:

  1. Defina o papel explicitamente. "Você é um desenvolvedor Python sênior revisando pull requests" supera "Você é um assistente prestativo."
  2. Declare as restrições antecipadamente. "Sugira apenas mudanças que afetem corretude ou segurança. Ignore preferências de estilo."
  3. Especifique o formato de saída. "Retorne um objeto JSON com as chaves: resumo, problemas e recomendação."

Chain-of-Thought Realmente Funciona

Dizer ao modelo para "pensar passo a passo" não é superstição, melhora mensuravelmente a precisão em tarefas de raciocínio. Mas a mágica está em como você estrutura:

Analise este código em busca de bugs. Siga estes passos:
1. Rastreie o fluxo de dados para cada entrada
2. Verifique casos limite (nulo, vazio, valores de fronteira)
3. Liste problemas potenciais com severidade (crítico, alerta, informativo)

Passos explícitos superam instruções vagas sempre.

O Que Não Funciona

  • Preâmbulos longos sobre "ser prestativo e honesto", o modelo já assume isso por padrão
  • Perguntar por "melhores práticas" sem contexto, o que é melhor depende da situação
  • Encenar cenários elaborados, o modelo não precisa de uma história de fundo

O Padrão Que Mais Uso

Depois de muitas iterações, aqui está o template que uso por padrão:

Sistema: Você é [papel específico]. [Restrição chave]. [Formato de saída].

Usuário: [Contexto: no que estou trabalhando, por que importa]
[Tarefa: solicitação específica e acionável]
[Restrições: o que NÃO fazer]

Simples. Específico. Testável. Esse é o jogo todo.