Como instruir um agente de IA para não errar

Equipe Viver de IA · 2026-11-07

A instrução vaga é a causa número um de agente imprevisível. Veja como escrever uma que a máquina executa igual toda vez.

A instrução curta parece melhor, e é a que mais dá problema

Quase todo mundo acha que uma instrução boa para IA é uma instrução enxuta: "responda as dúvidas dos clientes com simpatia". Soa limpo, soa profissional, e funciona lindamente nos três primeiros testes. Aí entra o quarto cliente, com uma pergunta que você não imaginou, e o agente inventa uma política de troca que a sua empresa nunca teve. Instrução curta não é instrução clara. É instrução que delega pra máquina decidir o que você não escreveu, e a máquina decide pelo caminho que ela achar mais plausível, não pelo que a sua operação faz.

Você trouxe exatamente essa dúvida: como instruir um agente de IA pra ele executar sem sair do script. A gente responde do jeito que resolve isso nos projetos, porque esse é um dos pontos que mais separa um agente que vira ferramenta de um que vira dor de cabeça. E não tem nada de técnico aqui. É escrita. É você conseguir descrever uma tarefa de um jeito que não sobre buraco.

O que "instruir um agente" realmente quer dizer

Antes de tudo, vamos alinhar o termo, porque ele carrega uma confusão. Um agente de IA é um software que recebe uma tarefa, decide os passos pra cumprir ela e executa, às vezes consultando dados, às vezes mandando mensagem, às vezes preenchendo um sistema. A "instrução" (no jargão você vai ouvir "prompt de sistema" ou "system prompt") é o texto fixo que define quem ele é, o que pode fazer, o que não pode, e como deve se comportar em cada situação. É o manual do funcionário, só que o funcionário lê o manual inteiro antes de cada tarefa e segue ao pé da letra.

Isso muda tudo. Um funcionário humano preenche as lacunas do manual com bom senso e com o que aprendeu no corredor. O agente não tem corredor. Ele tem o texto que você escreveu e o padrão estatístico com que foi treinado. Quando o seu texto cala, o padrão fala. E o padrão foi treinado na internet inteira, não na sua empresa.

Por isso a regra que a gente repete em todo projeto: tudo que você não escrever, o agente improvisa. A clareza da instrução é literalmente o limite do controle que você tem sobre o comportamento dele.

Um caso real: o agente que respondia pergunta difícil sem inventar

Deixa a gente mostrar isso num case que documentamos, porque é mais útil que teoria. A Digital Presenc X, uma agência, colocou no ar um agente de atendimento ao cliente desenhado especificamente pra responder perguntas de alta complexidade. Não era o chatbot de "qual o horário de funcionamento". Era pra encarar as dúvidas que normalmente iam parar na mesa de alguém sênior.

R$ 144.000: economia anual da Digital Presenc X com o agente de atendimento

O que faz um agente desses não descarrilar na pergunta difícil não é um modelo mais esperto. É a instrução. Pergunta complexa é exatamente onde o buraco da instrução vaga aparece, porque é onde a resposta certa depende de contexto que só a empresa tem. Um agente mal instruído, diante da pergunta que não sabe, não fica quieto. Ele preenche. Inventa um número, cria uma exceção, promete um prazo. E numa operação de atendimento isso não é um erro bonitinho, é um compromisso que a empresa vai ter que honrar ou desdizer na frente do cliente.

A diferença entre o agente que gerou essa economia por cinco meses e o agente que vira retrabalho está em três coisas que a instrução precisava carregar: o que ele pode afirmar com certeza, o que ele precisa buscar antes de responder, e o que ele faz quando não tem a resposta. Essa terceira é a que a maioria esquece.

As quatro camadas que uma instrução precisa ter

Quando a gente escreve a instrução de um agente que vai pra produção, ela não é um parágrafo. É uma estrutura. E ela se sustenta em quatro camadas, nessa ordem de importância:

1. Papel e escopo. Quem o agente é e, principalmente, o que está fora do trabalho dele. "Você é o atendente de pós-venda da loja X. Você não trata de assuntos financeiros nem de reclamações trabalhistas." O escopo negativo vale mais que o positivo: dizer o que ele NÃO faz fecha porta.
2. Regras duras. As coisas que nunca podem acontecer, escritas como lei, não como sugestão. "Nunca prometa prazo de entrega. Nunca ofereça desconto. Nunca confirme estoque sem consultar o sistema." Regra dura é curta, imperativa e não deixa margem de interpretação.
3. Procedimento. O passo a passo pra tarefa típica. Se o cliente pergunta sobre um pedido, qual a ordem: pede o número, consulta, responde o status, pergunta se resolveu. Agente sem procedimento escolhe a ordem na hora, e muda de resposta dependendo de como a pergunta chega.
4. Comportamento na dúvida. O que fazer quando a resposta não está ao alcance dele. Essa camada é a vacina contra o agente que inventa. "Se você não tiver a informação no sistema, diga que vai transferir para um atendente e não arrisque uma resposta."

Na nossa leitura, a camada 4 é onde mora a maior parte da imprevisibilidade que assusta os donos. O agente não erra porque é incapaz. Erra porque ninguém disse a ele que "não sei" é uma resposta permitida. Aí ele faz o que o treinamento manda: produz algo que pareça uma resposta. Pareça é a palavra-chave, e é o perigo.

Por que o exemplo ensina o que a regra não consegue

Aqui entra a parte que muda o jogo e a maioria não usa direito. Você pode escrever a regra mais clara do mundo e, mesmo assim, o agente erra o tom, o formato, o nível de detalhe. Regra em texto é abstrata, e o agente é péssimo em abstrato. Ele é excelente em imitação.

Então em vez de escrever "responda de forma objetiva e educada", você mostra:

Cliente: Meu pedido não chegou.

Resposta ideal: Sinto muito pelo transtorno. Me passa o número do pedido que eu verifico agora pra você.

Um exemplo desses vale mais que três parágrafos de adjetivo. O agente lê aquilo e calibra tom, tamanho e próximo passo de uma vez. É o que no mundo técnico chamam de few-shot, e o nome assusta mais que o conceito: significa simplesmente dar alguns exemplos de entrada e a saída que você quer.

E tem um uso dos exemplos que é ouro: corrigir erro específico. Quando o agente já está rodando e você pega ele errando numa situação, você não reescreve a instrução inteira. Você adiciona o exemplo daquela situação com a resposta certa. É cirúrgico. A cada exemplo de erro corrigido, o comportamento imprevisível encolhe um pouco. Esse é o verdadeiro trabalho de afinar um agente, e ele é contínuo, não acontece no dia do lançamento.

O exemplo não explica pro agente o que fazer. Ele mostra, e máquina aprende muito mais rápido por imitação do que por definição.

O fluxo de uma instrução que não deixa buraco

Pra você visualizar como essas peças se encaixam quando o agente recebe uma tarefa de verdade:

Tarefa chega → Escopo confere → Consulta o dado real → Resposta no formato do exemplo → Na dúvida, transfere

Repare que "consulta o dado real" vem antes de responder. Esse é um detalhe que define se o agente mente ou não. Um agente de atendimento que responde status de pedido sem bater no sistema está chutando. A instrução precisa amarrar a resposta ao dado: "só afirme o status depois de consultar." Sem essa amarra, ele responde pela memória do treinamento, que não sabe nada do pedido daquele cliente.

E o último nó, "na dúvida, transfere", é o que impede o chute quando o dado não existe ou a pergunta foge do escopo. Agente bom sabe a hora de parar. Isso não nasce sozinho, você escreve.

O erro que a maioria comete: instrução que contradiz a si mesma

Tem um erro que a gente vê repetir e que pouca gente percebe sozinha. A instrução cresce com o tempo, você vai adicionando regra em cima de regra, e em algum ponto elas brigam entre si. "Seja sempre breve" na linha 10 e "explique detalhadamente o processo de troca" na linha 40. O agente recebe as duas e resolve do jeito dele, que muda a cada conversa. Pra você, parece que ele é instável. A instrução é que está instável.

Todo agente que começa a dar resposta errática merece uma releitura da instrução inteira procurando contradição antes de qualquer coisa. Na maioria das vezes o problema não é o modelo, são duas frases suas que não conversam. A gente é teimoso nisso: antes de trocar de ferramenta ou de modelo, lê a instrução linha por linha. Quase sempre o bug está lá.

O segundo erro mais comum é testar só com os casos fáceis. Você monta o agente, faz as perguntas que já esperava, tudo funciona, você solta em produção. O cliente real não faz a pergunta do seu teste. Ele faz a pergunta torta, com erro de português, com duas dúvidas na mesma mensagem, com um pedido que você não previu. É aí que a instrução é testada de verdade. Então teste com as perguntas difíceis de propósito, as que você teme. É melhor o agente errar no seu teste do que na frente do cliente.

Quando instruir bem não é suficiente

Uma honestidade que precisa estar aqui: tem limite pra o que a instrução resolve. Se a tarefa depende de um dado que o agente não consegue acessar, nenhuma instrução salva. Você pode escrever a regra mais clara pedindo pra ele consultar o estoque, mas se o agente não está conectado ao sistema de estoque, ele vai ou travar ou inventar. Instrução organiza o comportamento; ela não cria acesso a informação que não existe no ambiente dele.

Por isso, parte do trabalho de instruir bem é, na verdade, decidir o que o agente tem direito de acessar. Um agente de atendimento precisa ler o pedido. Um agente de RH, como o que a Mave montou pra tirar dúvidas dos colaboradores sobre políticas internas, precisa ter as políticas documentadas acessíveis, senão ele responde com achismo. O desenho do que ele enxerga é tão importante quanto o texto que diz como se comportar. Uma coisa não vive sem a outra.

E tem o caso em que o problema nem é de instrução, é de escopo errado. Se você está tentando instruir um único agente a fazer atendimento, vendas, cobrança e suporte técnico de uma vez, a instrução vira um monstro contraditório por natureza. Às vezes a resposta certa é quebrar em agentes menores, cada um com uma instrução enxuta e sem conflito. Um agente que faz uma coisa bem é mais confiável que um que faz quatro pela metade.

Comprar pronto, montar sozinho ou implementar com método

Quando você entende que a qualidade está na instrução, uma pergunta vem na sequência: eu escrevo isso sozinho ou pego algo pronto? Tem três caminhos, e cada um cobra um preço diferente.

Comprar uma solução fechada de prateleira é rápido, mas a instrução vem genérica, pensada pra uma empresa média que não é a sua. Funciona pro básico e te deixa refém na hora de ajustar o comportamento pro seu jeito de trabalhar. Montar tudo sozinho do zero te dá controle total, mas você vai descobrir no osso cada um dos erros que esse texto resumiu, e vai levar meses pra chegar onde um método já chegou.

O caminho que a gente defende, e é o que sustenta os cases aqui, é implementar por dentro: você usa um método testado e a plataforma pra montar o agente, mas a instrução é escrita com o seu conhecimento do negócio, dentro da sua operação. O trade-off é honesto. Exige que alguém da sua empresa seja dono disso, aprenda a escrever e afinar instrução, e mantenha a rotina de corrigir com exemplos. Em troca, a capacidade fica na sua casa, não na de um fornecedor. Se quiser ver o terreno, começa pelo diagnóstico de IA pra entender qual tarefa sua está madura pra virar agente, e olha as soluções prontas pra o que já está empacotado.

Seu próximo passo

Pega a instrução do agente que você já tem rodando, ou do que pretende montar, e faça uma coisa só esta semana: escreva a camada 4, a do comportamento na dúvida. Liste as cinco perguntas mais difíceis que um cliente real faria, e pra cada uma, defina exatamente o que o agente deve responder quando não tiver a informação. Não é "ele se vira". É a frase literal que ele vai dizer, e pra onde ele transfere.

Se a sua instrução hoje não tem essa camada, está aí a maior parte do seu comportamento imprevisível, esperando o primeiro cliente que você não previu.

Relacionados

Agentes de IA: o guia completo

Soluções de IA prontas para empresas

Mais de 500 cases reais de IA

IA para [logística: como decidir rota, carga e prazo](/blog/ia-para-logistica-como-decidir-rota-carga-e-prazo)

Grok lançou versão nova toda semana. E daí pra sua empresa?