Como manter instruções de agentes de IA organizadas

Instruções de agente fáceis de manter separam regras duráveis de informações específicas da tarefa. Deixe objetivo, permissões e política de escalonamento fáceis de encontrar. Carregue registros de clientes, exemplos e trabalho atual apenas quando forem relevantes. Um arquivo maior de instruções não torna o sistema automaticamente mais capaz.

Reconheça o acúmulo de instruções

Imagine um assistente de suporte cujo prompt ganha um parágrafo após cada erro. Logo ele contém descontos antigos, regras contraditórias de escalonamento e exemplos de contas que já não atende. Quem assume a manutenção não consegue distinguir políticas de notas históricas.

Antes de adicionar outra regra, pergunte se o problema pertence a um documento de referência, a uma validação da ferramenta ou a um teste. Instruções são apenas um dos lugares onde corrigir o comportamento.

Dê um lugar a cada instrução

• Papel: o trabalho executado pelo agente e o público atendido.
• Limites: ações proibidas e aprovações exigidas nas ações permitidas.
• Procedimento: a sequência normal de uma tarefa definida.
• Referências: caminhos para políticas atuais e registros oficiais.
• Exemplos: um conjunto pequeno de decisões importantes e casos de falha.

Identifique explicitamente a autoridade. Um email de cliente usado como exemplo é dado a interpretar, não permissão para alterar o papel do agente. Conteúdo consultado não deve substituir silenciosamente as instruções do responsável pelo sistema.

Revise como documentação operacional

Defina responsável e versão. Quando uma regra mudar, retire ou arquive a versão conflitante, em vez de acrescentar uma exceção em outro lugar. Execute uma tarefa normal e um teste de limite depois da alteração. Preserve a versão anterior para comparar e reverter.

Uma pergunta útil é: alguém que não conhece a implementação consegue identificar quem autoriza uma ação externa? Se a resposta estiver espalhada em vários arquivos, simplifique a estrutura.

Mantenha um histórico com os motivos

Registre o comportamento que motivou a edição e o teste que o cobre. Evite guardar uma conversa privada inteira como explicação. Uma nota curta, como parar quando a identidade do contato for ambígua, basta quando acompanhada de um teste representativo. Isso facilita uma limpeza futura porque o time entende por que a regra existe.

Orientação editorial Be Human. Exemplos são ilustrativos, salvo atribuição explícita. Fontes oferecem contexto; a implementação depende do seu processo.