Arquivo Como fazer

Como escrever prompt de agente de atendimento

As cinco partes de um prompt de sistema que sustentam comportamento consistente num agente de atendimento, com exemplo de frase vaga e frase específica em cada parte.

O prompt de sistema é a instrução permanente que define como um agente de atendimento se comporta em toda conversa, antes mesmo de o cliente escrever a primeira mensagem. Prompt mal escrito produz agente que ora responde certo, ora inventa informação, ora esquece a própria regra no meio da conversa. Este guia mostra como escrever um prompt de sistema que sustenta comportamento consistente.

Ao final você vai ter a estrutura de um prompt de sistema pronta para adaptar ao seu caso. Antes de começar, tenha em mãos o escopo do agente já definido por escrito, descrito em como escrever o escopo de um agente de IA, porque prompt bom não compensa escopo mal definido.

Por que o mesmo prompt produz respostas diferentes em dias diferentes?

Porque prompt vago deixa espaço para interpretação, e modelo de linguagem preenche esse espaço de forma um pouco diferente a cada execução. Prompt específico, com regra explícita e exemplo concreto, reduz essa variação. A meta não é eliminar toda variação, que é impossível, é garantir que o comportamento fique dentro de um limite aceitável em qualquer execução.

As cinco partes de um prompt de sistema completo

Parte 1, o papel

Defina em uma frase quem o agente é e para quem ele trabalha. Não é personagem fictício, é a função real, “você é o agente de atendimento da empresa X, que responde dúvida sobre pedido já feito”. Papel vago, como “você é um assistente útil”, produz agente sem direção clara sobre o que está fora do próprio trabalho.

Parte 2, o que ele sabe e o que não sabe

Declare explicitamente a fonte de informação que o agente pode usar, e diga com todas as letras que ele não deve inventar nada fora dessa fonte. Essa instrução reduz o principal risco de um agente de atendimento, que é responder com confiança algo que não é verdade.

Parte 3, o tom

Descreva o tom com exemplo, não só com adjetivo. Dizer “seja educado” é vago. Mostrar duas frases, uma no tom certo e outra no tom errado para aquela marca, ensina muito mais rápido do que qualquer adjetivo isolado.

Parte 4, os limites

Liste explicitamente o que o agente nunca deve fazer. Nunca prometer prazo que não está confirmado no sistema. Nunca oferecer desconto sem autorização. Nunca continuar a conversa se o cliente pedir para falar com humano. Essa lista é a parte que mais evita problema em produção.

Parte 5, quando transbordar para humano

Defina o critério exato de quando parar e passar a conversa adiante. “Transborda quando o assunto for fora do escopo” é vago demais. “Transborda quando o cliente pedir cancelamento, reclamar de cobrança indevida, ou repetir a mesma pergunta duas vezes sem ficar satisfeito” é específico o suficiente para o agente aplicar de forma consistente.

As cinco partes de um prompt de sistema, do papel ao critério de transbordo Papeldo agente O que sabee não sabe Tom comexemplo Limitesexplícitos Critério detransbordo
  1. Defina o papel do agente numa frase clara e específica da empresa.
  2. Declare a fonte de informação permitida e proíba invenção fora dela.
  3. Descreva o tom com exemplo de frase certa e frase errada.
  4. Liste os limites explícitos do que o agente nunca deve fazer.
  5. Defina o critério exato de quando transbordar para humano.

Exemplo de frase boa e frase ruim em cada parte

A tabela abaixo compara uma versão vaga com uma versão específica para cada uma das cinco partes. O padrão que se repete é sempre o mesmo, a versão específica nomeia uma situação real em vez de descrever um comportamento em abstrato.

ParteVersão vagaVersão específica
PapelVocê é um assistente útilVocê é o agente de atendimento da loja X, que responde dúvida sobre pedido já feito
Fonte de informaçãoResponda com seu conhecimentoResponda só com base no status retornado pelo sistema de pedidos
TomSeja simpáticoUse frase curta e direta, sem gíria, do jeito que a marca fala no Instagram
LimiteNão prometa nada impossívelNunca informe prazo de entrega sem consultar o sistema, mesmo que o cliente insista
TransbordoPasse para humano se precisarTransborde quando o cliente pedir cancelamento ou repetir a pergunta duas vezes

Repare que a versão vaga não está errada, ela só deixa espaço demais para interpretação. É esse espaço que o modelo preenche de forma inconsistente entre uma conversa e outra, e é exatamente esse espaço que a versão específica fecha.

Como testar se o prompt está funcionando

Depois de escrever as cinco partes, rode uma bateria simples antes de considerar o prompt pronto. Pergunte a mesma dúvida de três formas diferentes, educada, mal escrita e impaciente, e confira se a resposta central continua consistente nas três. Peça uma informação fora da fonte permitida e confira se o agente admite não saber em vez de inventar. Simule o cenário de transbordo definido na parte cinco e confira se o agente realmente para e passa adiante, em vez de continuar tentando resolver sozinho.

Esse teste não substitui a bateria completa antes de produção, ele é um primeiro filtro rápido, feito ainda durante a escrita do prompt, antes mesmo de chegar na etapa formal de teste.

Vale reservar um tempo específico para esse primeiro filtro, mesmo que pareça repetitivo. É comum encontrar, já nessa etapa inicial, uma instrução que parecia clara na hora de escrever e se revela ambígua assim que testada com uma pergunta real, formulada de um jeito que quem escreveu o prompt não tinha imaginado. Quanto mais cedo essa ambiguidade aparece, mais barato é corrigir, porque o custo de ajustar um prompt antes de ir ao ar é muito menor do que o custo de corrigir depois que o agente já respondeu errado para um cliente de verdade.

Erros comuns

Na hora de escrever

  1. Escrever o prompt inteiro em uma frase genérica. “Você é um assistente simpático que ajuda o cliente” não dá conta de nenhuma das cinco partes descritas acima, e o agente improvisa o resto sozinho.
  2. Colocar exemplo contraditório. Dois exemplos que ensinam comportamentos opostos confundem mais do que ajudam. Revise o prompt inteiro procurando esse tipo de contradição antes de considerar pronto.
  3. Escrever o prompt sem quem atende o cliente hoje. Quem já atende o cliente manualmente sabe as nuances reais da conversa, a objeção comum, o jeito de falar que a marca usa. Escrever o prompt sem essa pessoa produz um agente tecnicamente correto e culturalmente deslocado.

Depois de publicado

  1. Confiar só no prompt para impedir invenção. Mesmo com instrução clara de não inventar, o modelo ainda pode errar. Por isso o teste prático, descrito em como testar um agente de IA antes de produção, é obrigatório antes de qualquer agente atender cliente de verdade.
  2. Nunca revisar o prompt depois de publicado. Prompt não é documento estático. Conforme o agente atende conversa real, padrão de erro aparece, e o prompt precisa de ajuste com base nesse padrão observado.

Esse trabalho entra no pilar de tecnologia e automação.

Vale registrar o histórico de versões do prompt, com data de cada mudança e o motivo. Quando um comportamento estranho aparece em produção, esse histórico ajuda a identificar se a causa foi uma alteração recente no prompt ou algo em outro ponto do sistema, o que economiza tempo de investigação numa hora em que velocidade de resposta importa.

Perguntas frequentes

Quantas palavras um prompt de sistema bom costuma ter?

Não existe número fixo. O que importa é cobrir as cinco partes com clareza, não atingir um tamanho específico. Prompt curto demais costuma pular alguma das partes, prompt longo demais sem estrutura fica difícil de manter.

Posso usar o mesmo prompt para agente de atendimento e de vendas?

Não é recomendado. Os dois têm papel, limites e critério de transbordo diferentes. Um agente de vendas pode oferecer condição comercial, um de atendimento normalmente não deveria. Misturar os dois papéis no mesmo prompt tende a confundir o comportamento em ambas as frentes.

Preciso reescrever o prompt toda vez que a empresa muda uma política?

Sim, sempre que a mudança afeta o que o agente pode prometer ou informar. Política de prazo, de desconto ou de cancelamento que muda e não é atualizada no prompt produz agente informando regra antiga para o cliente. Por isso recomendamos que alguém do time de atendimento, não só o time técnico, tenha acesso fácil para revisar o prompt sempre que uma política muda, em vez de depender de abrir um chamado técnico para uma mudança de texto.

Vale a pena ter um prompt diferente para cada canal, como WhatsApp e e-mail?

Depende do quanto o comportamento esperado muda entre os canais. Se o tom e o limite são os mesmos, um único prompt de sistema serve para os dois, com pequenas adaptações de formato, como mensagem mais curta no WhatsApp e mais estruturada no e-mail. Se o canal muda o tipo de conversa, por exemplo um canal só para dúvida simples e outro para negociação, vale considerar prompts separados, cada um com seu próprio conjunto das cinco partes.

O prompt de sistema é a mesma coisa que a pergunta que o usuário digita?

Não. O prompt de sistema é a instrução fixa que define o comportamento do agente em toda conversa, escrita por quem constrói o sistema. A pergunta do usuário é o que muda a cada conversa. Os dois entram juntos, mas cumprem função diferente.

Próximo passo

Pegue o escopo já definido do seu agente e escreva as cinco partes descritas acima, uma de cada vez. Depois, teste o resultado com pergunta real, das mais comuns às mais difíceis, antes de considerar o prompt pronto para atender qualquer cliente de verdade.

Se quiser ajuda para escrever, revisar e testar esse prompt de sistema junto com o seu time de atendimento, fale com a gente no WhatsApp.