Templates de skill: prompt que você não reescreve toda vez
Como separar o que é instrução reaproveitável do que é papel específico do agente, com o formato de prompt que parou de me dar dor de cabeça.
Eu tinha quatro agentes e o mesmo parágrafo de tom de voz colado nos quatro. Ajustei o texto em três, esqueci o quarto, e por semanas o agente do financeiro falou com o cliente de um jeito diferente de todos os outros. Ninguém percebeu até um cliente comentar que "o atendimento do boleto é mais seco". Foi ali que os templates de skill deixaram de ser opcionais para mim.
Template guarda prompt base, contexto padrão e categoria. Você escreve uma vez, vincula em quantos agentes quiser e muda num lugar só. O vínculo entre agente e templates é N:N, então dá para combinar.
Aqui eu conto o que colocar no template, o que deve ficar no agente e a estrutura de prompt que parei de mudar. Para o contexto das camadas, veja a visão geral da Central de IA.
O que vai nos templates de skill e o que fica no agente
A linha que eu uso é simples: se a instrução vale para mais de um agente, ela é template. Se ela descreve o papel específico daquele agente, fica no prompt de sistema dele. Misturar os dois é o que gera aquele agente de mil linhas que ninguém tem coragem de editar.
| Conteúdo | Onde mora | Motivo |
|---|---|---|
| Tom de voz da empresa | Template | Vale para todos os agentes |
| Regra de nunca inventar informação | Template | Comportamento comum, não muda por agente |
| Papel específico do agente | Prompt do agente | Só faz sentido naquele contexto |
| Procedimento de um departamento | Template por categoria | Reaproveitável entre agentes do mesmo time |
| Material institucional extenso | Documento de contexto | Grande demais para caber num prompt |
A última linha merece atenção. Já tentei colar uma política de troca inteira dentro do prompt de sistema. Ficou pesado, difícil de manter e passou a competir com o resto das instruções. Material longo vai para documentos de contexto.
A estrutura de prompt que funciona aqui
Depois de reescrever muita coisa, cheguei numa ordem que raramente muda. Ela não é mágica, ela só evita que o modelo tenha que adivinhar qual instrução vale mais.
- Quem o agente é e para quem ele fala
- O que ele pode resolver, dito de forma direta
- O que ele nunca deve fazer, incluindo prometer o que não pode cumprir
- Como escrever: tamanho de resposta, tom, formato
- Quando parar e transferir para uma pessoa
O terceiro item é o que mais protege. Já vi um agente responder um prazo de entrega que não existia porque ninguém tinha escrito que ele não deve inventar prazo. O modelo não fez nada de errado: ele preencheu uma lacuna que eu deixei aberta.
Escreva o "não faça" antes do "faça"
Confesso que demorei para entender isso. Minha tendência natural era descrever o que o agente deveria resolver e assumir que o resto ficaria de fora sozinho. Não fica. O que não está proibido, um dia acontece.
Hoje escrevo primeiro a lista de limites: não confirmar prazo, não prometer desconto, não interpretar contrato, não dar orientação técnica que exige avaliação. Depois descrevo o que ele resolve. A ordem muda a qualidade do resultado mais do que eu esperava, e o raciocínio inteiro está em governança de IA no atendimento.
Combinando templates sem criar confusão
Como o vínculo é N:N, dá para montar um agente com um template de tom, um de procedimento e um de regras gerais. Funciona bem até você colocar instruções que se contradizem em dois templates diferentes.
Aconteceu comigo: um template pedia respostas curtas, outro pedia explicação detalhada de cada passo. O agente ficou oscilando e eu levei dias para associar o comportamento estranho a essa briga. Leia os templates juntos, como se fossem um texto único, antes de vincular.
- Liste os templates que o agente vai usarAnote o propósito de cada um em uma frase. Se duas frases se parecem, você tem duplicação.
- Leia tudo em sequênciaCole os textos num documento e leia como se fosse uma instrução só. As contradições saltam.
- Resolva os conflitos no templateCorrija na origem, não no prompt do agente, senão o conflito volta no próximo agente.
- Teste com casos reaisUse perguntas que clientes fizeram de verdade, incluindo as mal escritas.
- Ajuste um item por vezMudar três instruções juntas impede saber qual delas resolveu o problema.
O que ajustar no agente, não no template
Temperatura, top-p, max turns, fallback humano, departamento de destino e palavras-chave de fallback são configuração do agente. Nada disso é texto de prompt e nada disso deveria ser explicado dentro do prompt, o que já vi acontecer.
Max turns merece um parágrafo. Ele limita quantas voltas a conversa dá com o agente antes de encerrar, e é a proteção mais barata contra agente que fica orbitando o assunto sem chegar a lugar nenhum. Combine com um fallback bem configurado e você tem uma saída digna.
Revisando template depois que o negócio muda
Template envelhece calado. Mudou política de troca, mudou prazo padrão, mudou quem atende o quê: o texto continua lá dizendo o que era verdade no trimestre passado. Coloque a revisão de template na mesma rotina em que você revisa fluxo e expediente.
E revise junto com quem cuida do assunto. Já reescrevi um template de garantia sozinho, com toda a boa vontade, e errei o prazo. Quem cuida do atendimento de serviços normalmente sabe de detalhe que não está escrito em lugar nenhum.
Comece pelo tom de voz
Se você ainda não tem nenhum template, extraia primeiro o tom de voz e as regras de "não faça" que estão repetidas nos seus agentes. É a extração de maior retorno e a mais fácil de validar. O resto vem depois, quando você sentir a duplicação incomodando de novo.