Prompt de agente de IA: como escrever a instrução (system prompt) que define o comportamento

O system prompt é a instrução fixa que define quem o agente de IA é, o que ele deve alcançar, como deve falar, o que pode fazer e onde deve parar. Ele fica ativo em toda conversa e funciona como o contrato de trabalho do agente: a mensagem do cliente muda a cada interação, mas o system prompt permanece igual e guia todo o comportamento. Uma instrução boa não é a mais longa — é a mais clara, com papel, objetivo, regras, limites e exemplos. É ela que faz o agente parecer parte da sua empresa em vez de um robô genérico.

Eu escrevo essas instruções todos os dias para os agentes que coloco em produção. Então vou direto ao que funciona — e ao que faz o agente sair do trilho.

O que é o system prompt (e por que ele decide tudo)

Todo agente de IA tem dois tipos de texto entrando no modelo: a mensagem do usuário, que muda a cada interação, e a instrução do sistema, que você escreve uma vez e fica valendo para sempre. Essa instrução é o system prompt. É onde você diz ao modelo qual papel ele assume, qual o objetivo daquela conversa e quais são as regras da casa. Se a mensagem do cliente é a pergunta, o system prompt é o manual que o atendente estudou antes de responder.

Por isso ele decide tudo. O mesmo modelo — GPT, Claude ou Gemini — se comporta como um vendedor agressivo ou como um consultor paciente dependendo só do que você escreveu ali. Trocar de modelo raramente resolve um agente ruim; reescrever a instrução quase sempre resolve. Se você ainda está entendendo as peças, vale ler antes a anatomia de um agente de IA, porque o prompt é uma dessas peças — não a única.

Qual a diferença entre prompt e system prompt?

Muita gente confunde. O prompt comum é o que o usuário digita: "quanto custa o frete pra Santos?". O system prompt é o que o desenvolvedor escreveu: "Você é o atendente da loja X, responde em português, consulta o frete no sistema antes de informar valor e nunca promete prazo que não pode cumprir". O primeiro é volátil e você não controla. O segundo é fixo e é 100% seu trabalho. Quem constrói o agente vive no segundo.

O que uma boa instrução de agente de IA precisa ter

Uma instrução que funciona tem blocos claros. Não precisa de nome bonito, precisa de estar lá:

• Papel: quem o agente é e para quem ele trabalha. "Você é o assistente de vendas da [empresa], que vende [produto] para [público]".
• Objetivo: o que ele deve alcançar naquela conversa. Qualificar? Recuperar uma venda? Agendar? Um objetivo só, bem definido, por agente.
• Tom de voz: como a empresa fala. Formal ou próximo, com ou sem emoji, direto ou consultivo. É aqui que a marca aparece na conversa.
• Regras do que fazer: os passos que ele sempre segue — consultar o sistema antes de dar preço, confirmar o nome, oferecer o próximo passo.
• Regras do que nunca fazer: não inventar preço, não prometer prazo, não falar de concorrente, não dar desconto sem autorização.
• Limites e handoff: quando ele para e chama um humano. Esse ponto merece atenção — veja o guia de handoff humano em agentes de IA.
• Exemplos: uma ou duas conversas modelo, mostrando uma resposta boa e uma resposta ruim. Exemplo ensina mais que dez linhas de regra.

A pergunta certa ao escrever a instrução não é "o que eu quero que ele diga". É "o que eu não quero que ele faça de jeito nenhum". É o limite que protege a operação.

Os erros mais comuns ao escrever o prompt

Depois de escrever muitos, os erros se repetem:

• Regras contraditórias: "seja breve" e "explique tudo em detalhe" na mesma instrução. O modelo não sabe qual obedecer e escolhe errado na hora errada.
• Vago demais: "atenda bem o cliente" não diz nada. "Responda em até 3 frases, sempre termine com uma pergunta" diz.
• Sem limites: instrução que só fala do que fazer e nunca do que não fazer produz agente que promete o que a empresa não entrega.
• Prompt gigante: tamanho não é qualidade. Instrução enorme e confusa dilui as regras importantes. Corte o que não muda o comportamento.
• Confundir prompt com conhecimento: tabela de preços e política de troca não vão dentro da instrução — vão na base de conhecimento. Misturar os dois deixa o prompt impossível de manter.

Como estruturar o prompt na prática (esqueleto)

Uma ordem que costumo seguir, do geral ao específico:

1. Identidade: papel, empresa, público, objetivo da conversa.
2. Tom: como falar, com exemplos de frase.
3. Fluxo: os passos que ele segue do início ao fim da conversa.
4. Regras rígidas: o que nunca fazer, em lista curta e sem ambiguidade.
5. Handoff: os gatilhos que passam a conversa para um humano.
6. Exemplos: um diálogo bom e um diálogo ruim comentado.

Depois de escrever, teste com conversas reais antes de soltar em produção — instrução no papel parece perfeita e desmorona no primeiro cliente atípico. Eu detalho esse processo em como testar um agente de IA antes de colocar em produção.

O prompt não resolve tudo (e é importante saber disso)

Aqui é onde muita gente se frustra: acha que basta caprichar na instrução e o agente vira perfeito. Não vira. O prompt define comportamento, mas não fornece informação. Para o agente responder o preço certo, ele precisa consultar a sua base — é o papel da base de conhecimento e RAG. E para ele não inventar quando não sabe, você precisa de guardrails técnicos, não só de uma frase pedindo "não alucine" — o assunto de alucinação e guardrails.

A conta é simples: prompt + conhecimento + limites. O prompt dá a personalidade e as regras, o conhecimento dá a informação correta, os limites impedem o estrago. Falhou um dos três e o agente decepciona. Se você quer o passo a passo de montar isso do zero, tem o guia de como criar agentes de IA para empresas.

É assim que eu trabalho: instrução clara e enxuta, conhecimento conectado e limites que protegem a operação. Agente bom não é o que fala bonito — é o que se comporta igual todos os dias, do jeito da empresa. E isso começa no prompt. Se quiser, veja como aplico IA e performance no meu trabalho.

Perguntas frequentes