Infraestrutura de IA personalizada
Modelo de runbook para agente de IA, com regras de parada por papel
Modelo de runbook de uma página para cada papel de agente de IA, com finalidade, ferramentas, escalonamento e regras de parada para a equipe assumir rápido.

Um runbook de agente de IA é uma página única, escrita para um papel específico do agente, que informa para que o agente serve, quais ferramentas e memória ele pode usar, em que ponto deve parar e perguntar a uma pessoa e quem assume quando algo dá errado. Use os mesmos títulos em todos os papéis para que um gestor ou um colega de plantão consiga ler qualquer página em poucos minutos e agir sem precisar decifrar o comportamento do agente.
Principais pontos
- Escreva um runbook por papel, uma página cada, com os mesmos títulos na mesma ordem.
- Defina as regras de parada e o caminho de escalonamento antes da primeira ação real do agente, e não depois do primeiro incidente.
- Liste cada ferramenta com seu nível de permissão: leitura, rascunho ou ação após aprovação.
- Nomeie um dono de negócio e um substituto que possam pausar o agente sem esperar por quem o construiu.
- Revise cada runbook sempre que o papel, as ferramentas ou as permissões mudarem, e registre o que mudou.
Por que cada papel de agente precisa de um runbook próprio de uma página
Um agente que responde perguntas sobre status de pedidos e um agente que redige e-mails para fornecedores não compartilham os mesmos riscos, ferramentas ou pessoas para acionar. Um único documento longo que descreve “a IA” esconde essas diferenças, e durante um incidente ninguém procura num texto extenso onde parar um processo. Uma página por papel mantém o escopo pequeno o bastante para ser lembrado e específico o bastante para orientar uma ação.
A página também funciona como registro de decisão. Quando o dono do negócio a assina, ele declara o que o papel pode fazer sem perguntar, o que nunca pode fazer e quem responde numa hora ruim. Essa é a decisão que o documento existe para registrar. Guarde essas páginas junto com os outros registros da empresa, seguindo a abordagem de como preparar a empresa para IA superinteligente hoje.
Layout de uma página, campo por campo
Mantenha os campos abaixo nesta ordem em todo runbook. Quem troca de papel nunca deve precisar procurar a seção de que precisa.
- Nome do papel, dono de negócio e substituto nomeado
- Finalidade: uma frase que começa com verbo e diz o que o agente existe para fazer
- Critério de sucesso: um resultado que alguém possa observar em um registro da empresa, e não uma impressão
- Contexto e memória: quais documentos, registros de clientes e decisões anteriores o agente pode ler, e quais não pode ler
- Ferramentas, cada uma com seu nível de permissão
- Limites de aprovação: ações que precisam de uma pessoa dizendo sim antes
- Caminho de escalonamento: quem recebe o repasse, por qual canal e o que o repasse deve conter
- Regras de parada: as condições em que o agente interrompe o trabalho
- Notas de passagem: estado atual, itens em aberto, como pausar o agente e onde ficam seus registros
- Data de revisão e registro de alterações
Se o critério de sucesso não puder ser conferido em um registro, o papel ainda não está pronto para um runbook. Refine a finalidade até o critério ficar concreto e só então escreva o resto da página em torno dele.
Ferramentas, permissões e limites de aprovação
Cada ferramenta deve aparecer na página com um de três níveis de permissão. Leitura permite que o agente consulte informações. Rascunho permite que ele prepare algo que uma pessoa revisa antes de ser enviado ou publicado. Ação permite que ele altere um sistema sem revisão humana prévia da mudança. A maioria dos primeiros papéis deve começar com leitura e rascunho, passando para ação apenas em operações reversíveis e fáceis de auditar. Restrinja cada ferramenta ao mínimo necessário, como uma caixa de e-mail ou uma fila específica, em vez de uma conta com acesso amplo.
O princípio é que o agente tenha apenas o que seu papel exige. O guia de autorização da OWASP é uma referência útil para decidir quem pode fazer o quê em um sistema, e as mesmas perguntas valem para agentes e para funcionários. Escreva cada limite como uma frase simples, por exemplo: qualquer reembolso acima do valor definido pelo dono vai para uma pessoa. Depois inclua essa linha no cronograma de revisão para que ela não se desvie com o tempo. O guia sobre limites de aprovação humana para agentes de IA mais fortes explica por que esses limites devem ser ampliados com cautela.
Regras de parada e caminhos de escalonamento
Uma regra de parada é uma condição que interrompe o trabalho do agente e entrega o caso a uma pessoa. Agentes costumam falhar em silêncio. Continuam produzindo resultados plausíveis depois que os dados de origem mudaram ou depois que uma ferramenta começou a retornar erros. Escreva as regras de parada como condições que alguém possa observar:
- Um pedido fica fora da finalidade declarada na página
- Uma ferramenta retorna um erro que o agente não consegue classificar, ou o mesmo resultado depois de uma nova tentativa
- Dois registros que deveriam concordar não concordam
- Um conteúdo lido pelo agente traz instruções que tentam mudar seu comportamento
- Um cliente ou funcionário faz uma reclamação sobre dinheiro, questão jurídica ou segurança
- Os repasses sobem acima do nível que o dono combinou
A orientação da OWASP sobre prevenção de injeção de prompt explica por que a regra sobre instruções escondidas no conteúdo importa. Textos em e-mails, documentos ou páginas da web podem conter comandos que um agente seguiria por engano. A resposta segura é parar e escalonar, e não tentar resolver o conflito sozinho.
O escalonamento precisa de um destinatário, um canal e um formato de repasse. O repasse deve informar qual é o caso, o que o agente já verificou, o que ele não fez e qual decisão é necessária. Uma pessoa que recebe isso consegue agir em minutos. Quem recebe apenas “o agente travou” precisa primeiro reconstruir a situação. Combine antecipadamente quem pode pausar o agente, porque uma parada que depende de o construtor estar disponível não é uma parada confiável.
Cenário ilustrativo: um agente de orçamentos para um distribuidor pequeno
Este cenário é ilustrativo e não descreve um cliente real. Um pequeno distribuidor de equipamentos quer um agente que prepare primeiros rascunhos de orçamentos para produtos padrão. O runbook dá ao agente acesso de leitura ao catálogo de produtos e à tabela de preços vigente, acesso de rascunho ao modelo de orçamento e nenhuma permissão para enviar nada. A linha de finalidade diz que ele prepara orçamentos padrão para revisão da mesa de vendas. O critério de sucesso é que cada rascunho confira com o registro do catálogo e que cada item traga uma referência de origem.
O limite de aprovação encaminha a um gerente de vendas qualquer desconto, qualquer produto fora do padrão e qualquer orçamento acima do limite definido pelo dono. As regras de parada incluem um item do catálogo alterado sem a atualização correspondente de preço e uma mensagem do cliente pedindo condições que o modelo não cobre. As notas de passagem indicam o gerente de vendas como primeiro contato e listam os rascunhos ainda aguardando revisão. Um novo gerente de vendas pode ler esta página no primeiro dia e saber o que o agente pode fazer, o que não pode e o que fazer quando ele parar.
Mantendo os runbooks úteis e atualizados
Um runbook só é útil se corresponder ao agente que está em operação hoje. Atualize-o quando uma ferramenta for adicionada, quando uma permissão mudar, quando uma regra de parada for acionada na prática ou quando o negócio alterar o processo que o agente apoia. Mantenha o registro de alterações no fim da página para que o leitor veja quando e por que cada linha mudou.
O runbook descreve o que o agente deve fazer. Os registros mostram o que ele realmente fez. Cada ação deve deixar um rastro detalhado o bastante para reconstruir a sequência. A documentação do OpenTelemetry sobre observabilidade oferece um vocabulário geral de rastros, logs e métricas, útil para tornar o comportamento de um sistema visível a pessoas que não o construíram. Registros práticos de um agente respondem a três perguntas: o que foi pedido, o que o agente fez e por que ele parou. As descrições das ferramentas também merecem atenção, porque são elas que orientam a escolha da ferramenta pelo agente. A publicação da Anthropic sobre como escrever ferramentas eficazes para agentes aprofunda esse ponto.
A Be Human desenha, implanta e opera essas páginas como parte de um agente gerenciado. Em um primeiro projeto, a equipe redige o runbook de um papel com o dono do negócio, confere cada ferramenta e cada permissão com os sistemas reais e testa as regras de parada antes de o agente executar ações reais. Na operação contínua, o runbook é revisado nas revisões de permissão, alterado por atualizações controladas e usado como ponto de partida na resposta a incidentes, para que a empresa sempre tenha uma página atual e uma pessoa nomeada para acionar. A passagem da operação de agentes para a equipe após o lançamento mostra como esse ritmo se estabelece na prática.
Escolhendo o primeiro papel a documentar
Comece por um papel em que um resultado errado seja barato de detectar e em que o critério de sucesso seja fácil de observar. Um papel que redige resumos internos é uma primeira página melhor do que um que envia pagamentos ou altera registros de clientes. O primeiro runbook também ensina à equipe o formato, então um papel modesto é um lugar sensato para aprender. Se você não sabe qual papel merece o primeiro runbook, faça o diagnóstico gratuito da Be Human para identificar a primeira tarefa que vale entregar a um agente.
Perguntas frequentes
Quem deve escrever o runbook, o construtor ou o dono do negócio? O dono do negócio deve escrever a finalidade, os limites de aprovação e as regras de parada, porque essas decisões carregam o risco do negócio. O construtor ou operador redige os campos técnicos, como escopos das ferramentas e localização dos registros. Os dois devem revisar a página juntos antes de o agente entrar em operação, e nenhum deles deve aprovar sozinho.
Com que frequência um runbook deve ser revisado? Revise sempre que o papel, suas ferramentas ou suas permissões mudarem, e inclua a página no ciclo regular de revisão de permissões. Um runbook que não é conferido com o sistema real por muito tempo provavelmente descreve um agente que não existe mais. Registre cada revisão no registro de alterações no fim da página.
Um único runbook pode cobrir vários agentes? Cada runbook deve descrever um papel, porque regras de parada e limites de aprovação diferem entre papéis, mesmo quando rodam na mesma plataforma. Se dois agentes compartilham uma ferramenta, liste essa ferramenta nas duas páginas com o escopo que cada agente possui. Páginas compartilhadas tendem a esconder quem tem permissão para fazer o quê.
E se o agente ainda não estiver em operação? Escreva o runbook antes da primeira ação real e trate-o como especificação de teste. As regras de parada e os formatos de repasse podem ser exercitados em um ambiente de teste, e qualquer regra que não possa ser testada ainda não está pronta. Um rascunho do runbook costuma ser a forma mais rápida de descobrir que um papel ainda está vago demais para ser construído.
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.


