Engenharia de Prompt
Ir para notas que citam estaEngenharia de prompt é a prática de estruturar a instrução de um agente em partes previsíveis — papel, objetivo, regras e formato de saída — para que o comportamento dele seja estável de uma execução para a outra.
O prompt é o que define o agente. Uma chamada a um modelo de linguagem sem instrução estruturada não tem objetivo, não tem persona e não tem limite: ela responde qualquer coisa, de um jeito diferente a cada vez, e acaba entregando menos do que uma conversa direta em um chat comum. Estruturar o prompt é a diferença entre um modelo que improvisa e um componente que se pode encaixar num fluxo maior, e é o primeiro passo para que uma chamada a um modelo vire de fato um Agente de IA. Essa lógica vale igualmente em plataformas visuais e em frameworks de código: em ambos, escrever a instrução em linguagem natural substitui o que antes seria programado em condicionais.
Os quatro pilares de um prompt de agente
- Papel. Quem o agente é. É a camada mais próxima da Persona do Agente e determina o tom e o repertório das respostas — um agente didático explica com exemplos e linguagem acessível, um agente analista responde seco.
- Objetivo. O que ele deve fazer e de que forma. Algumas referências chamam essa parte de tarefa; a ideia é a mesma.
- Regras. O que ele pode e não pode fazer durante as respostas. Essa é a porta de entrada dos Guardrails no prompt.
- Formato de resposta. Como a saída deve vir. Quando a resposta será lida por uma pessoa, o formato pode ficar solto; quando ela alimenta o próximo passo de um fluxo ou é consumida por código, definir a estrutura (JSON, por exemplo) é o que garante a previsibilidade de quem vai processar aquilo.
Separar o que é do sistema do que é do usuário
Um erro fácil de cometer, e de não perceber, é jogar toda a instrução dentro do mesmo campo em que entra a mensagem do usuário. O prompt continua correto como texto, mas o modelo passa a tratar as regras como se fossem parte da pergunta, e a resposta simplesmente falha ou devolve outra pergunta.
O certo é usar a opção de mensagem de sistema para tudo que é fixo — papel, objetivo, regras, formato — e deixar no campo do usuário apenas a mensagem que chegou. Em ferramentas visuais essa separação é uma opção do nó de agente que precisa ser ativada explicitamente; em código, é a distinção entre as mensagens de sistema e as de usuário na chamada ao modelo.
Ajustar o prompt é trabalho iterativo
Consistência de resposta é o problema operacional mais comum de quem constrói agentes, e boa parte dele se resolve reescrevendo o prompt em vez de trocar de modelo. Vale pedir explicitamente o que se quer, com contexto suficiente: instruções vagas não dizem ao modelo qual é o resultado certo, e ele preenche a lacuna por conta própria. Fornecer um exemplo do artefato esperado — uma peça já pronta que serve de referência de estrutura e estilo — costuma alinhar a saída mais rápido do que descrever o formato em palavras.
Às vezes vale mais refazer a instrução inteira do que corrigi-la aos poucos: uma sequência de pedidos pontuais de ajuste tende a produzir um texto remendado, enquanto uma reescrita com o aprendizado acumulado entrega um comportamento mais limpo.
Nada considerado confidencial deve entrar no texto do prompt. E antes de queimar crédito de API testando variações, vale experimentar o prompt em uma interface de chat gratuita: como o modelo se comporta conforme a instrução recebida, o teste barato já revela a maior parte dos problemas.