Como escrever as instruções do seu agente de IA para que responda bem
Um agente de IA responde tão bem quanto suas instruções. As práticas que a Anthropic recomenda: clareza, contexto, exemplos, tags e um papel definido.
Você contrata um atendente novo e no primeiro dia diz apenas: “Atenda o WhatsApp”. Sem explicar os produtos, os preços, como cumprimentar, o que fazer se alguém reclamar nem quando passar o caso para um supervisor. Quão bem você acha que ele vai se sair?
Com um agente de IA acontece exatamente o mesmo. O modelo pode ser brilhante, mas sem boas instruções ele improvisa. A boa notícia: escrever instruções eficazes tem técnica, e a Anthropic, a empresa por trás do Claude, a documenta em detalhe.
Por que as instruções importam tanto?
Porque são o manual de treinamento do seu agente. Segundo o resumo de engenharia de prompts da Anthropic, ajustar o prompt é muito mais rápido do que outros métodos de controle do comportamento do modelo e muitas vezes gera grandes melhorias em pouco tempo.
Antes de escrever, tenha claro o que seu agente faz; se ainda não tem um, leia o que é um agente de IA para WhatsApp.
Quais técnicas a Anthropic recomenda?
Cinco, ordenadas das mais eficazes em geral às mais específicas:
| Técnica | O que significa no seu agente |
|---|---|
| Ser claro e direto | Dizer exatamente o que fazer, sem supor que ele adivinhe |
| Dar exemplos | Mostrar duas ou três conversas modelo |
| Deixar raciocinar | Pedir que pense antes de responder em casos complexos |
| Usar tags XML | Separar instruções, dados e exemplos com marcações claras |
| Atribuir um papel | Definir quem ele é: “consultora comercial de uma clínica em Bogotá” |
Segundo o guia de boas práticas da Anthropic, as tags XML ajudam o modelo a interpretar sem ambiguidade prompts que misturam instruções, contexto, exemplos e dados variáveis.
Como é um bom conjunto de instruções?
Uma estrutura prática para um agente de WhatsApp:
- Papel: quem ele é e quem representa.
- Objetivo: o que deve alcançar (tirar dúvidas, qualificar, agendar).
- Informações do negócio: produtos, preços vigentes, horários, áreas de cobertura.
- Regras com o porquê: “não prometa datas de entrega, porque dependem do estoque do dia”.
- Quando passar para uma pessoa: reclamações, pagamentos, casos fora das informações.
- Exemplos: duas ou três conversas bem resolvidas.
- Formato: mensagens curtas, uma única mensagem por resposta, tratamento por você.
Erro comum: escrever só proibições (“não faça isso, não diga aquilo”). Funciona melhor dizer o que fazer no lugar e explicar o porquê: assim o agente aplica o critério em casos que você não previu.
Por que pedir respostas em uma só mensagem?
Por experiência do cliente e por custo. Um agente que divide cada ideia em cinco balões cansa o cliente e, desde outubro de 2026, cada resposta pela API do WhatsApp conta para a cobrança; explicamos em a nova cobrança do WhatsApp.
Como sei se minhas instruções funcionam?
Testando com conversas reais e corrigindo o que falha.
- Revise toda semana uma amostra de conversas.
- Anote onde respondeu mal, inventou ou não passou o caso a tempo.
- Ajuste a instrução ou adicione um exemplo que cubra esse caso.
- Mantenha as informações do negócio atualizadas: um preço antigo nas instruções é um preço antigo em cada resposta.
Atenção: as instruções não substituem os dados. Se o agente precisa consultar estoque ou agenda em tempo real, deve se conectar a esses sistemas, por exemplo com MCP ou com fluxos do n8n.
Em resumo
Um agente de IA é tão bom quanto suas instruções: papel claro, objetivo, informações do negócio, regras explicadas, exemplos e um formato definido. É o mesmo onboarding que você daria a um atendente novo, escrito para que a IA o siga sempre. Projetamos, testamos e ajustamos as instruções do seu agente no nosso serviço de agentes de IA.
Perguntas frequentes
O que é um prompt de sistema?
São as instruções permanentes que um agente de IA recebe: quem ele é, quem atende, o que pode e o que não pode fazer, e como deve responder.
Vale a pena dar exemplos de conversas ao agente?
Sim. A Anthropic inclui o uso de exemplos entre as técnicas mais eficazes para orientar as respostas.
O que são tags XML em um prompt?
São marcações como <instrucoes> ou <exemplo> que separam as partes do prompt. Segundo a Anthropic, ajudam o modelo a interpretar sem ambiguidade prompts que misturam instruções, contexto e exemplos.
Com que frequência devo revisar as instruções?
Sempre que encontrar respostas que falham. Revisar conversas reais toda semana no começo é uma boa prática.
Não fique só na teoria: aplique no seu negócio
Implementamos agentes de IA de ponta a ponta, com a sua operação real. A primeira conversa não tem custo.
