Infraestrutura de IA personalizada
Padrões de documentação para uma empresa preparada para superinteligência
Padrões mínimos de documentação para processos, papéis e escopos de agentes de IA, para o conhecimento sobreviver a trocas de ferramentas e modelos.

Documentação para empresas preparadas para superinteligência começa com um ponto simples: registrar, de forma estável, os processos que um agente de IA segue, os papéis que são donos de cada decisão e o escopo exato que o agente pode tocar. Uma empresa atinge um mínimo útil quando alguém que não construiu o agente consegue executar o processo apenas com os documentos e prever o que ele vai fazer. Esse padrão importa mais quando ferramentas e modelos mudam, porque o conhecimento precisa viver nos registros da empresa, e não em um prompt ou nas configurações de um fornecedor.
Principais pontos
- A documentação de um agente de IA cobre quatro coisas: o processo que ele segue, o papel que é dono de cada decisão, o escopo que ele pode tocar e as evidências de que ele se comportou como foi desenhado.
- Um documento só atende ao padrão quando uma pessoa de fora consegue usá-lo para prever o resultado de casos recentes.
- Escreva os processos em termos de gatilhos, entradas, decisões e passagens de bastão, e não pelo nome de um produto ou modelo.
- Todo escopo de agente precisa de um dono humano nomeado, uma lista explícita de ferramentas e fontes de dados e limites de aprovação escritos em linguagem simples.
- Mantenha um registro de alterações e uma data de revisão em cada documento, para que uma troca de ferramenta ou modelo atualize o registro em vez de substituí-lo.
Por que a documentação decide se o conhecimento sobrevive à mudança
A maioria das empresas trata o conhecimento operacional como algo que vive na cabeça das pessoas e em pastas compartilhadas. Quando um agente entra na operação, surge um terceiro lugar: as instruções, definições de ferramentas, memórias e configurações de permissão que dizem ao agente o que fazer. Se esse terceiro lugar for o único registro completo, a empresa entregou seu conhecimento à ferramenta que o guarda. Uma atualização de modelo ou a troca de fornecedor então obriga a reconstruir tudo de memória, e a reconstrução costuma ficar incompleta de maneiras que ninguém percebe até que um cliente ou um colega perceba.
A solução não é um manual extenso. É um conjunto pequeno de padrões que cada processo, papel e escopo de agente precisa cumprir antes de ser considerado pronto. Os padrões são propositalmente simples, para que um líder de operações consiga conferi-los sem ler código, e valem tanto para uma empresa com um agente quanto para uma com vários. Um teste útil é perguntar se os documentos ainda fariam sentido caso cada ferramenta da pilha fosse substituída no trimestre seguinte.
Padrão um: escreva cada processo como um procedimento que alguém possa verificar
O documento de um processo deve descrever o trabalho como ele é feito hoje, incluindo as exceções que a equipe resolve discretamente. Descreva o que o processo alcança e quais decisões ele toma, e não qual produto executa cada etapa, porque produtos mudam com mais frequência do que processos. O conteúdo mínimo é curto:
- Nomeie o gatilho que inicia o processo e a fonte de onde ele lê.
- Liste as entradas necessárias e diga o que fazer quando alguma estiver faltando ou for ambígua.
- Escreva cada decisão como uma pergunta, com as respostas possíveis e a regra que escolhe uma delas.
- Escreva cada ação na forma « quem ou o que faz o quê, em qual registro ».
- Informe a saída, para onde ela vai e o que significa estar concluído.
- Registre as exceções que a equipe trata hoje, inclusive as informais.
Teste o documento antes de depender dele. Entregue-o a alguém de fora da equipe e peça que preveja o resultado de três casos recentes, incluindo um caso incomum. Se a pessoa não conseguir prever um resultado, o documento está sem uma regra de decisão, e essa lacuna vira uma falha silenciosa quando um agente começar a agir com base nele.
Padrão dois: nomeie um dono humano para cada papel e cada decisão
Cada papel, seja ocupado por uma pessoa ou por um agente, precisa de um dono humano responsável. Esse dono não é necessariamente quem mais usa o agente. O dono aprova mudanças no escopo do papel, decide as exceções e recebe os relatórios de incidente. Quando um documento aponta uma equipe ou uma caixa de e-mail compartilhada como dona, a responsabilidade costuma desaparecer no primeiro incidente.
Separe três coisas em todo documento de papel: para que serve o papel, o que ele pode decidir sozinho e o que precisa passar para uma pessoa. O terceiro item é onde a maioria dos documentos confusos falha. Um papel que pode « atualizar registros de clientes » precisa de uma frase dizendo quais atualizações pode fazer sem aprovação, quais exigem um revisor e o que fazer quando os dados conflitam com outra fonte. Para um método prático de testar esses limites, veja Revisão trimestral de permissões de agentes de IA: checklist prático.
Padrão três: escreva cada escopo de agente como permissões, dados e ferramentas
O escopo de um agente é a lista completa do que ele pode ler, escrever, enviar e decidir. Escreva-o em três listas: as fontes de dados que ele pode ler, as ferramentas que pode chamar com as ações permitidas em cada uma e os canais em que pode falar ou receber pedidos. Cada entrada precisa de um motivo. Acesso concedido « por conveniência » é a fonte mais comum de surpresas futuras, porque ninguém se lembra por que ele existe quando chega a hora de removê-lo.
Mantenha as credenciais fora do documento. O escopo nomeia a permissão, não o segredo. O acesso deve ser concedido pelo sistema de identidade da organização, seguindo o princípio do menor privilégio, que a orientação de autorização da OWASP descreve em detalhes. As descrições das ferramentas também pertencem ao escopo. A orientação da Anthropic sobre como escrever ferramentas para agentes enfatiza descrições claras do que cada ferramenta faz e de quando deve ser usada, e o mesmo texto funciona como o contrato que uma ferramenta substituta precisa cumprir.
Declare também quais conteúdos externos o agente lê, como e-mails recebidos, páginas da web ou arquivos enviados. Registre que instruções encontradas dentro desses conteúdos são tratadas como dados, não como comandos, e nomeie a pessoa que revisa qualquer ação disparada por eles. A injeção de prompt é um dos principais riscos em sistemas de agentes, e um escopo que a ignora está incompleto, mesmo quando as permissões parecem restritas.
Para um índice visual de onde cada escopo se encaixa na pilha mais ampla, Camadas da infraestrutura de IA empresarial: as sete explicadas oferece um ponto de partida útil.
Padrão quatro: guarde evidências e um registro de cada mudança
Documentação sem registros de comportamento é apenas intenção. Para cada agente, defina por escrito o que será registrado: o pedido recebido, as fontes de dados consultadas, as ferramentas chamadas, qualquer aprovação solicitada e a decisão tomada, e a saída final. Registros só são úteis quando a estrutura é consistente. O material introdutório da OpenTelemetry explica por que traces, métricas e logs precisam de uma estrutura comum antes que alguém consiga tirar respostas deles, e a mesma disciplina vale para os registros de agentes. Defina um período de retenção compatível com a política da empresa e revise uma amostra em uma agenda fixa.
Defina também, por escrito, a verificação de sucesso. Um conjunto pequeno e fixo de casos representativos, cada um com um resultado esperado, deve ser executado de novo sempre que o modelo, o prompt ou uma ferramenta mudar. Um conjunto fixo é mais confiável do que a memória de o que pareceu funcionar. Registre cada execução com a data, a versão testada e o resultado.
Cada mudança em um processo, papel ou escopo recebe uma entrada curta: o que mudou, por quê, quem aprovou, quais evidências sustentam a mudança e quais documentos foram atualizados. Trocas de ferramenta e de modelo também contam como mudanças. É aqui que o padrão mais protege a empresa, porque um modelo substituído pode ser avaliado contra o conjunto de testes e a entrada de mudança, e não contra a lembrança de alguém. O procedimento para pedir e aprovar essas mudanças fica em aberto nesta etapa, e vale definir quem aprova antes que a primeira mudança aconteça.
Checklist e um cenário ilustrativo antes da entrada em operação
Cenário ilustrativo: uma empresa de serviços prepara pedidos de reembolso com um agente, e um revisor financeiro aprova cada um acima de um valor definido. O documento do processo lista o gatilho, as três verificações de elegibilidade e o limite de aprovação. O escopo lista o sistema de pedidos como somente leitura e a ferramenta de pagamento como inacessível ao agente. Quando a empresa troca depois o sistema de pedidos, a nova conexão foi construída a partir da lista do escopo, e os mesmos seis casos de teste escritos foram executados novamente antes da entrada em operação. Nada precisou ser redescoberto nas configurações do sistema antigo, e a entrada de mudança mostrou quais verificações foram retestadas.
Antes de qualquer agente entrar em operação, confirme que o seguinte é verdadeiro:
- Todo processo tem gatilho, entradas, regras de decisão e uma definição de concluído.
- Todo papel tem um dono humano responsável e uma lista das decisões que exigem aprovação.
- Todo escopo lista suas fontes de dados, ferramentas e canais, com um motivo para cada entrada.
- As credenciais são referenciadas pelo nome no sistema de acesso e nunca escritas em documento.
- O registro cobre pedidos, chamadas de ferramentas, aprovações e saídas.
- Um conjunto fixo de casos de teste, com resultados esperados, está escrito e foi executado ao menos uma vez.
- Existe um registro de alterações, e cada documento traz um dono nomeado e uma data de revisão.
Como manter o padrão depois do lançamento
A Be Human desenha, implanta e opera essa camada para empresas. Um primeiro projeto define um papel útil, a memória e as ferramentas de que ele precisa, seus limites de aprovação e um critério de sucesso observável, e os documentos descritos acima são escritos como parte dessa definição, e não depois dela. Na operação gerenciada, os mesmos registros sustentam o monitoramento, as avaliações recorrentes, a manutenção das integrações, a revisão de permissões e as mudanças controladas. Assim, a empresa mantém seu conhecimento nos próprios registros quando um modelo ou uma ferramenta é substituído. O objetivo é que a próxima mudança seja uma atualização documentada, e não uma reconstrução.
Se ainda não está claro qual processo deve ser documentado primeiro, o diagnóstico gratuito de IA da Be Human ajuda a identificar a primeira tarefa que vale entregar a um agente. Para quem tem uma operação pequena, Superinteligência para pequenas empresas: por onde o dono deve começar mostra como manter essa camada enxuta sem deixar de lado as partes que protegem o negócio.
Perguntas frequentes
Quanta documentação basta para um agente de IA? O suficiente para que alguém de fora consiga executar o processo e prever o resultado de casos de teste sem perguntar ao construtor. Para a maioria dos papéis isso significa um documento curto de processo, um documento de papel com dono e uma lista de escopo cobrindo dados, ferramentas e canais. O tamanho importa menos do que o fato de cada regra de decisão estar escrita.
Quem deve escrever esses documentos? O líder de operações ou o dono do processo deve fornecer as decisões e exceções, porque só eles sabem como o trabalho é realmente feito. A pessoa que constrói o agente pode rascunhar o escopo e a lista de ferramentas, e um revisor de fora da equipe deve testar o resultado com casos reais antes de qualquer entrada em operação.
Esses padrões valem para uma empresa muito pequena? Valem, em uma forma mais leve. Um negócio de duas pessoas ainda precisa de um gatilho escrito, uma regra de decisão, um dono e uma lista do que o agente pode acessar, muitas vezes em poucas páginas.
Com que frequência os documentos devem ser revisados? Revise sempre que uma ferramenta, um modelo, um processo ou um dono mudar, e também em uma agenda fixa definida pela empresa, para que nenhum documento fique sem conferência por muito tempo. As permissões merecem a atenção mais frequente, porque o acesso tende a se acumular com o tempo. A revisão deve atualizar o registro de alterações, para que o histórico mostre o que foi conferido, por quem e com qual resultado.
Seu próximo passo
Descubra primeiro onde um agente de IA cabe na sua empresa.
Faça o diagnóstico gratuito de IA da Be Human. Algumas perguntas sobre o seu trabalho mostram qual tarefa entregar primeiro a um agente, o que ele precisa saber e onde uma pessoa aprova.
Orientação editorial Be Human. Exemplos são ilustrativos, salvo atribuição explícita. Fontes oferecem contexto; a implementação depende do seu processo.


