Resposta rápida: A instrução permanente de um agente é o documento que define o que ele é, o que faz, com quais fontes, em que formato, o que nunca deve fazer e quando precisa chamar uma pessoa. É diferente do prompt que alguém digita no dia a dia: aquele é uma pergunta, este é um cargo escrito. Sete blocos resolvem quase todos os casos: o papel e o escopo, as fontes autorizadas, o formato de saída, as proibições explícitas, um exemplo de entrada com a saída considerada boa, o gatilho de escalada para humano e o tom. Esse documento precisa de dono com nome, de número de versão e de data em cada mudança. Quando o agente decepciona, o problema mora nele em quase todos os casos que investiguei, e ninguém abre o arquivo porque culpar o modelo custa menos esforço.
Fui chamado numa empresa para avaliar a troca de fornecedor de um agente de atendimento que estava, nas palavras do diretor, entregando resposta ruim havia meses. Já existia uma cotação de outra ferramenta na mesa, com valor três vezes maior, e a reunião era para decidir a migração.
Pedi para ler a instrução do agente atual antes de falar qualquer coisa. Levou vinte minutos para alguém achar o texto, que estava dentro do painel da ferramenta, sem cópia em nenhum outro lugar. Tinha onze linhas. Duas delas mandavam o agente ser cordial. Nenhuma dizia onde ele deveria buscar informação de preço.
O agente vinha respondendo preço com o que encontrava em textos antigos de campanha, porque ninguém tinha dito a ele onde estava a tabela vigente. Fazia exatamente o que o documento pedia. Corrigimos aquele bloco, adicionamos duas proibições e um exemplo de saída boa, e a qualidade mudou na mesma tarde.
A empresa estava a uma assinatura de distância de trocar de fornecedor por um problema de duas linhas de texto. E o mais interessante: em seis meses de reclamação, ninguém tinha aberto o arquivo. É o padrão mais consistente que encontro nesse assunto.
Prompt do dia e instrução permanente são documentos diferentes
Existe uma confusão que atrasa muita coisa. O prompt é o pedido que uma pessoa faz agora, específico, descartável, avaliado na hora pela própria pessoa que pediu. Escrever bom prompt é competência individual, e tratei dela em como escrever bons comandos para a IA.
A instrução permanente é outra categoria de texto. Ela é escrita uma vez, vale para milhares de execuções, atende pessoas que não a escreveram e não a leram, e produz consequência para quem não estava na sala. Ela se parece muito mais com uma descrição de cargo do que com uma pergunta.
Essa diferença tem uma consequência prática que muda a qualidade do resultado: instrução permanente precisa de revisão, de aprovação e de versão, como qualquer documento que rege trabalho. Tratar isso como prompt grande é a origem de boa parte das decepções.
Por que ninguém escreve: o documento não tem hora nem dono
A instrução costuma nascer no pior momento possível. Alguém está configurando a ferramenta, com prazo, animado com o piloto, e digita um texto na caixa que apareceu. Aquele texto entra em produção como rascunho e nunca sai da condição de rascunho.
Não existe reunião de aprovação de instrução, não existe padrão de casa, e o texto quase nunca é copiado para fora da ferramenta. Ele fica preso no painel de um fornecedor, invisível para o resto da empresa, e some quando a assinatura muda.
Isso cria um risco que só aparece na hora ruim. Quando a pessoa que configurou sai, a empresa herda um agente cujo comportamento ninguém sabe explicar, e o assunto vira arqueologia. Escrevi sobre esse tipo de herança em o que acontece com os agentes quando quem os configurou pede demissão.
Culpar o modelo custa menos esforço que ler a instrução
Quando a saída sai ruim, a explicação mais confortável está sempre disponível: o modelo alucinou, a ferramenta é fraca, a tecnologia ainda não chegou. Essa explicação tem uma vantagem organizacional imensa, porque não aponta para ninguém dentro da empresa.
Ler a instrução, ao contrário, produz uma conversa desconfortável. Costuma ficar claro que o comportamento indesejado estava autorizado por omissão, que a fonte certa nunca foi indicada, ou que o formato pedido nunca foi definido. Alguém escreveu aquilo com pressa e ninguém revisou.
Passei a fazer uma coisa simples em todo diagnóstico: pedir a instrução antes de qualquer outra informação. Em quase todos os casos, o texto explica o problema em menos de dez minutos de leitura, e a correção é mais barata que qualquer troca de ferramenta.
Primeiro bloco: o papel e o escopo, com fronteira escrita
O documento abre dizendo o que aquele agente é e para quem ele trabalha. Não como slogan, e sim como cargo: qual processo ele atende, quais tipos de pedido ele resolve, e o que fica fora do escopo dele com nome.
A fronteira escrita é o que quase todo mundo esquece. Um agente de suporte que não recebeu proibição explícita vai tentar responder pergunta comercial, porque tentar é o comportamento padrão dele. Escrever a lista do que ele não atende é mais importante que escrever a lista do que atende.
Um teste rápido de qualidade desse bloco: entregue a instrução a uma pessoa que não conhece o processo e pergunte quais três pedidos ela encaminharia para outra área. Se ela hesitar, o agente também vai hesitar, e ele hesita produzindo texto.
Leia também
Segundo bloco: as fontes autorizadas, e a proibição de improvisar
Este é o bloco que faltava naquela empresa, e é o que mais causa estrago. A instrução precisa dizer onde a informação vive, com nome do documento, do sistema ou da tabela, e precisa dizer o que fazer quando a informação não está lá.
A regra que eu escrevo em toda instrução tem duas partes. A primeira: usar apenas as fontes listadas para dado factual, como preço, prazo, política e disponibilidade. A segunda: quando a informação não estiver nas fontes, dizer que não tem a informação e encaminhar, jamais preencher a lacuna com estimativa.
Sem essa segunda parte, o comportamento padrão preenche o vazio com algo plausível, porque produzir resposta é o que ele foi construído para fazer. A instrução é o único lugar onde a empresa pode dizer que preferir o silêncio é o comportamento correto.
Terceiro bloco: o formato de saída, o mais esquecido de todos
Formato parece detalhe estético e é uma das causas mais comuns de retrabalho. Quando o formato não está definido, cada execução devolve algo com estrutura diferente, e a pessoa que recebe gasta tempo reorganizando antes de usar.
Definir formato significa dizer o que vem primeiro, o que é obrigatório, o que nunca deve aparecer, e qual o tamanho aceitável. Para um resumo de reunião, por exemplo, isso significa dizer que decisão vem antes de contexto e que responsável e prazo são obrigatórios em cada item.
Existe um ganho secundário grande: saída padronizada é auditável. Quando toda entrega tem a mesma estrutura, fica trivial revisar por amostra e fica possível medir qualidade. A régua de medição está em como avaliar a qualidade do que o agente entrega.
Quarto bloco: as proibições, escritas como proibição
Empresas gostam de escrever instrução em tom positivo, listando o que deve ser feito. Fica um texto simpático e incompleto. Proibição precisa aparecer como proibição, curta, específica e em lista, porque é assim que ela é obedecida com consistência.
As proibições que eu coloco em quase todo agente que fala com cliente: não prometer prazo que não esteja na fonte, não oferecer desconto, não confirmar cobertura ou garantia, não dar orientação técnica que possa causar dano, não pedir dado sensível, não afirmar nada sobre concorrente.
Cada empresa acrescenta as suas, e a melhor fonte para essa lista é o histórico de problemas reais. Toda vez que um agente produz uma saída que ninguém queria, a correção não termina no ajuste da conversa: termina numa linha nova na lista de proibições, com data.
Uma observação sobre redação, que muda o resultado mais do que parece. Proibição vaga é obedecida de forma vaga. Escrever que ele deve ter cuidado com informação de garantia produz comportamento imprevisível; escrever que ele nunca confirma cobertura de garantia e sempre encaminha esse tipo de pergunta para a fila de pós-venda produz comportamento estável. A diferença entre as duas frases é o que separa uma instrução que funciona de uma que parece boa na leitura.
Leia também
Quinto bloco: um exemplo de entrada com a saída considerada boa
Nenhuma descrição abstrata de qualidade funciona tão bem quanto um par de exemplo. A instrução deve conter pelo menos um caso de entrada real e a saída que a casa considera correta, e de preferência também um caso difícil com a saída aceitável.
Esse par cumpre duas funções. Ele calibra o comportamento com muito mais precisão que adjetivo, e serve como critério de pronto para quem for revisar depois. Sem ele, a discussão sobre qualidade vira troca de opinião entre quem construiu e quem recebe.
Recomendo guardar esses exemplos fora da ferramenta, num arquivo da empresa, junto com a instrução. Eles são o ativo mais reutilizável do projeto: quando a casa troca de fornecedor, o exemplo continua valendo e a migração deixa de ser reconstrução.
Sexto bloco: o gatilho de escalada para uma pessoa
Um agente sem instrução de escalada tenta resolver tudo, e resolver tudo é o pior comportamento possível em caso limite. A instrução precisa dizer, com clareza, em que situações ele para e chama alguém.
Os gatilhos que eu sempre incluo: pedido fora do escopo definido, informação ausente nas fontes, sinal de irritação ou de urgência real, menção a problema jurídico ou de saúde, e repetição da mesma pergunta pela terceira vez na mesma conversa. O último é o melhor indicador de que a conversa está indo mal.
Escalada precisa de destino nomeado, não apenas de intenção. Dizer que ele deve encaminhar a um humano sem dizer para qual fila, com qual etiqueta e com qual resumo produz uma escalada que morre num lugar que ninguém olha.
Sétimo bloco: o tom, que deixa de ser opcional quando existe cliente
Enquanto o agente trabalha só para dentro, tom é preferência. No momento em que ele escreve algo que uma pessoa de fora vai ler, tom passa a ser risco de marca, e improvisar ali produz um texto que não se parece com a empresa.
Instrução de tom que funciona é concreta: tamanho de frase, uso de tratamento formal ou informal, o que nunca dizer, e três exemplos de mensagem no padrão da casa. Adjetivo solto como profissional e acolhedor não muda o resultado, porque cabe qualquer coisa dentro dele.
Quando existe manual de marca, a instrução precisa apontar para ele, e alguém do time responsável pela marca precisa aprovar aquele bloco. O caminho que eu sigo para essa aprovação está em o agente que atende em nome da marca.
O erro de escrever vinte páginas de instrução
Times que descobrem a importância desse documento costumam exagerar na direção oposta e produzir um manual longo, com exceção de exceção e capítulo sobre tudo. Isso piora o resultado por dois motivos práticos.
O primeiro: instrução muito longa dilui a prioridade. Quando tudo está escrito, nada está destacado, e as regras que realmente importam competem com detalhe irrelevante. O segundo: ninguém revisa vinte páginas, então o documento envelhece inteiro e ninguém percebe.
A régua que uso é a de uma página e meia para agente de tarefa e até três páginas para agente que atende cliente. Se está passando disso, geralmente existem dois agentes ali dentro querendo nascer, e separar resolve mais que escrever.
Leia também
O erro oposto: três linhas e esperança
O outro extremo é o mais comum, e é o que eu encontro em nove de cada dez empresas: um parágrafo curto pedindo cordialidade, com nenhuma fonte, nenhum formato e nenhuma proibição. O agente então preenche todos os vazios com o comportamento padrão dele.
O que acontece a seguir é sempre parecido. Nas primeiras semanas o resultado parece bom, porque os casos que aparecem são fáceis. Quando chegam os casos difíceis, o agente improvisa, e a empresa conclui que a tecnologia não serve para aquele processo.
Entre os dois extremos, a diferença de esforço é pequena: escrever os sete blocos com cuidado leva umas três horas de uma pessoa que conhece o processo. É o melhor uso de três horas em qualquer projeto de agente que eu já acompanhei.
Versão, data e histórico, porque instrução muda
Instrução é documento vivo e precisa ser tratada como código, não como recado. Isso significa três coisas simples: número de versão, data em cada alteração e uma linha dizendo o que mudou e por quê.
O motivo é diagnóstico. Quando a qualidade cai numa terça, a primeira pergunta útil é o que mudou. Sem histórico, a investigação vira suposição, e o time começa a mexer em várias coisas ao mesmo tempo, o que impede aprender qualquer coisa.
Existe também um motivo de convivência. Em times onde mais de uma pessoa pode editar a instrução, ausência de versão produz o clássico: alguém corrige, outro sobrescreve, e a correção volta a acontecer um mês depois. O ritual que sustenta isso ao longo do tempo está em a revisão trimestral de agentes.
Uma regra de bolso que adotei: mudança em instrução de agente que fala com cliente nunca entra na sexta-feira. Se algo sair torto, o estrago roda o fim de semana inteiro sem ninguém olhando, e o time descobre pelo volume de reclamação da segunda. É o mesmo cuidado que times de tecnologia aprenderam a ter com publicação de versão, aplicado a um documento que quase ninguém trata como código.
Onde guardar a instrução, porque dentro da ferramenta não conta
Uma prática que parece detalhe e evita prejuízo: a instrução mora num arquivo da empresa, e o que está no painel do fornecedor é uma cópia. A maioria das casas faz o contrário, e descobre o problema no pior momento.
Os momentos ruins são três e todos previsíveis. A empresa decide trocar de ferramenta e percebe que precisa reconstruir o comportamento do zero. O fornecedor muda a interface e o campo de instrução perde parte do texto sem aviso. A assinatura é cancelada por atraso de pagamento e o acesso ao painel se fecha com o documento dentro.
Guardar fora custa nada e devolve poder de negociação. Quando a instrução, os exemplos e o histórico de versões estão num repositório da casa, trocar de fornecedor deixa de ser um projeto e passa a ser uma configuração. É a forma mais barata de reduzir dependência num contrato de IA.
Leia também
Quem é o dono da instrução, e por que raramente é a TI
A pergunta de dono trava muitos projetos, e a resposta que funciona é contraintuitiva para empresas com cultura de tecnologia centralizada. O dono da instrução deve ser quem responde pelo processo, não quem opera a ferramenta.
A razão é simples: a instrução descreve como o trabalho deve ser feito, e isso é decisão de negócio. Quem responde pelo atendimento decide o que pode ser prometido. Quem responde pelo financeiro decide qual tabela vale. A TI garante acesso, segurança e registro.
Na prática, isso se resolve com dois nomes por agente: um dono de negócio, que aprova conteúdo, e um responsável técnico, que aplica e mantém. Sem essa dupla, ou a instrução fica tecnicamente correta e comercialmente errada, ou o contrário. A rotina de apresentar esse agente ao time está em o onboarding que sua empresa esqueceu.
Como testar uma instrução antes de soltar
Nunca coloco instrução nova em produção sem um teste que leva menos de uma hora. Monto uma lista de dez a quinze casos, sendo cinco fáceis do dia a dia, cinco difíceis conhecidos e três que deveriam ser recusados ou escalados.
Os três últimos são os mais importantes e quase sempre esquecidos. Testar se o agente recusa o que deve recusar é mais revelador que testar se ele responde o que deve responder. Boa parte das instruções aprovadas em teste falha exatamente nesse ponto.
Depois disso, uma semana de operação com revisão de toda saída, não por amostra. É chato e é o período em que se aprende mais, porque aparecem os casos que ninguém tinha imaginado. Cada um deles vira linha nova na instrução, e a partir da segunda semana a revisão passa a ser por amostra.
A instrução acaba revelando o processo que ninguém tinha escrito
Existe um efeito colateral desse trabalho que costuma valer mais que o agente. Ao escrever com precisão o que deve ser feito, com quais fontes e em quais casos parar, o time descobre que o processo humano nunca tinha sido definido nesse nível.
Aparecem perguntas que estavam abertas havia anos: qual tabela de preço vale quando duas existem, quem autoriza exceção, qual prazo a casa realmente pratica. Enquanto era gente executando, cada pessoa resolvia com bom senso e a divergência ficava invisível.
Por isso eu digo em toda implantação que a instrução é um espelho. Ela devolve a qualidade do desenho de processo da empresa, e quando ela fica difícil de escrever, o problema quase nunca é a tecnologia. É que ninguém sabia responder aquilo antes.
Como eu abriria a próxima segunda-feira
Escolheria o agente que mais gera reclamação hoje e faria uma coisa só: abriria a instrução dele e leria em voz alta na reunião, com o time do processo presente. Sem ferramenta, sem fornecedor, sem apresentação.
Em toda vez que fiz isso, a leitura em voz alta produziu o mesmo efeito: em poucos minutos alguém do processo interrompeu para dizer que aquilo estava errado, ou que faltava uma informação óbvia para quem trabalha ali. O documento tinha sido escrito por quem configurou, não por quem conhece.
Depois disso, marcaria três horas na agenda de uma pessoa que conhece o processo e escreveria os sete blocos com ela, com dono nomeado, versão um e data de hoje. É a intervenção mais barata que existe em projeto de IA, e é a que eu encontro pendente na maior parte das empresas que já gastaram bem mais que isso em ferramenta.