Caminho de contingência para agente de IA quando a ferramenta falha
Desenhe o caminho de contingência de um agente de IA quando uma ferramenta falha: repetições seguras, resultados parciais, retenções e fila humana.

Um caminho de contingência para agente de IA é a rota definida previamente que o agente segue quando uma ferramenta, API ou integração da qual ele depende falha, expira ou devolve dados que não se pode confiar. Um desenho viável decide com antecedência quais etapas podem ser repetidas, quais podem ser concluídas de outra forma, quais devem ser pausadas e quem assume o trabalho por uma fila que uma pessoa nomeada controla. Sem esse mapa, o agente para em silêncio ou chuta a resposta, e os dois resultados podem custar mais do que a própria indisponibilidade.
Principais pontos
- Relacione cada ferramenta à ação de negócio que ela executa e registre se essa ação pode ser repetida com segurança.
- Classifique as falhas como erros definitivos, tempos esgotados, dados ruins ou escritas não confirmadas, porque cada uma exige uma resposta diferente.
- Dê a cada etapa uma de cinco respostas: tentar de novo dentro de limites, usar uma rota equivalente, devolver um resultado parcial marcado, reter ou parar e escalar.
- Envie para uma fila humana tudo o que o agente não consegue concluir, com contexto suficiente para agir sem refazer a tarefa inteira.
- Mantenha as rotas de contingência dentro das mesmas permissões da rota principal e registre cada troca para que um responsável possa revisá-la.
Comece mapeando o que cada ferramenta faz para o agente
A maioria dos desenhos de contingência falha no início, porque ninguém escreveu para que serve cada ferramenta. Abra a lista de ferramentas do agente e, para cada item, registre três coisas: a ação de negócio que ela apoia (consultar um pedido, criar uma fatura em rascunho, enviar uma mensagem), se essa ação altera algo fora do agente e quanto tempo o negócio pode esperar sem ela. Uma consulta que a equipe poderia responder mais tarde, pelo painel administrativo, é um problema diferente de uma reserva que precisa ser confirmada antes de o cliente chegar.
As descrições das ferramentas também importam. As orientações da Anthropic sobre como escrever ferramentas para agentes insistem em definições claras e específicas, que digam o que a ferramenta devolve e quando ela deve ser usada. Um caminho de contingência depende dessa clareza. Se o agente não consegue distinguir uma ferramenta de leitura de uma ferramenta de escrita, ele não tem como raciocinar sobre o que é seguro repetir, e cada decisão de contingência vira um palpite.
Classifique a falha antes de escolher a resposta
Uma falha de ferramenta não é um evento único. Quatro padrões exigem tratamentos diferentes:
- Erro definitivo: a ferramenta devolve um código de erro ou recusa a conexão. O agente sabe que a chamada não foi concluída.
- Tempo esgotado: a chamada pode ter sido concluída do outro lado ou não. Esse é o armadilha mais comum.
- Dado ruim: a ferramenta responde, mas a resposta vem vazia, desatualizada ou com formato diferente do esperado.
- Escrita não confirmada: a ação pode ter acontecido, mas o agente nunca recebeu a confirmação.
As escritas não confirmadas merecem a maior atenção. Um agente que repete um pagamento ou uma reserva sem verificar se a primeira tentativa foi aplicada pode duplicar o trabalho. A proteção mais forte é a idempotência definida pelo fornecedor, como as chaves de idempotência descritas na documentação de API da Stripe, porque uma requisição repetida é reconhecida como a mesma requisição. Quando o fornecedor não oferece esse recurso, o agente deve consultar o sistema de destino antes de qualquer repetição. Um catálogo curto de tipos de falha dá à equipe uma linguagem comum para isso, e Tipos de falha de agentes de IA: dez categorias para registrar é uma boa referência para montá-lo.
Escolha uma de cinco respostas para cada etapa
Depois de classificar a falha, a etapa precisa de uma resposta escrita. Use este guia de decisão:
- Tentar de novo dentro de limites quando a falha for um erro definitivo ou um tempo esgotado em uma ação somente de leitura, e a etapa tiver um teto de tentativas e uma espera entre elas. Repita uma escrita apenas se ela for idempotente ou se o agente tiver confirmado que a primeira tentativa não foi aplicada.
- Usar uma rota equivalente quando uma segunda fonte devolve o mesmo fato ou executa a mesma ação com as mesmas permissões, como uma consulta de reserva em uma base espelhada. Nunca use uma rota com acesso mais amplo para contornar um bloqueio.
- Devolver um resultado parcial marcado quando a saída for útil sem a peça que falta. A peça ausente precisa aparecer rotulada como indisponível, para que quem lê nunca confunda aquilo com uma resposta completa.
- Reter quando a tarefa é válida, mas não pode avançar. Guarde as entradas, o último estado confirmado e o motivo da retenção, e então coloque a tarefa na fila.
- Parar e escalar quando uma escrita não confirmada puder ter acontecido, ou quando os dados se contradisserem. Não faça novas tentativas até que uma pessoa decida o próximo passo.
O padrão seguro para qualquer etapa que altere algo fora do agente é reter ou parar, nunca chutar. Os limites exatos de tentativas e esperas pertencem a um conjunto de regras escrito, e Política de repetição para agentes de IA sem duplicidades mostra como evitar que esses limites se tornem uma fonte de trabalho duplicado.
Monte uma fila humana que alguém realmente trabalha
Um caminho de contingência vale o mesmo que a pessoa que recebe a saída dele. Uma fila sem dono vira uma lista de itens que ninguém lê, e o trabalho retido expira sem ninguém perceber. Monte a fila nesta ordem:
- Primeiro, nomeie um responsável pela fila por função, com um substituto identificado, e informe os horários em que os itens são revisados.
- Segundo, defina o que entra na fila: a tarefa, a etapa que falhou, o tipo de falha, o que o agente já fez e a decisão necessária de uma pessoa.
- Terceiro, anexe o estado: as entradas, quaisquer saídas parciais e o último estado externo confirmado, para que o revisor não precise reconstruir o contexto do zero.
- Quarto, estabeleça uma meta de revisão para cada classe de item. Itens que afetam o cliente precisam de prazo mais curto do que relatórios internos.
- Quinto, dê ao revisor um conjunto pequeno de opções claras: concluir o trabalho manualmente, retomar o agente a partir da etapa salva ou encerrar a tarefa com um motivo registrado.
- Sexto, escale itens sem responsável para um segundo dono e acompanhe quanto tempo os itens ficam esperando, pois isso mostra se o desenho é realista.
- Sétimo, registre cada resolução, para que padrões recorrentes alterem as regras do agente em vez de repetir o mesmo trabalho manual.
Para detalhes de como os itens devem ser encaminhados e mantidos até alguém assumir, veja Escalonamento humano em IA: entregue a decisão necessária.
Cenário ilustrativo: um agente de acompanhamento durante uma falha do CRM
Cenário ilustrativo: um agente redige mensagens de acompanhamento depois de ligações comerciais e registra cada mensagem no sistema de clientes. Em um período em que esse sistema expira, o agente não consegue saber se o registro foi salvo. O caminho de contingência dele lê o registro primeiro. Se a entrada existir, o agente marca a etapa como concluída e segue em frente. Se o registro não puder ser lido de jeito nenhum, o agente retém o rascunho, não envia nada e coloca o item na fila com as anotações da ligação, o rascunho e o horário do tempo esgotado. O revisor envia a mensagem, registra manualmente e encerra o item. A regra do agente para essa etapa é então atualizada, para que uma verificação de leitura sempre venha antes de qualquer escrita que siga um tempo esgotado.
Mantenha as rotas de contingência dentro das mesmas permissões
As rotas de contingência são um ponto comum de desvio de permissões. Uma equipe adiciona um segundo sistema para que o agente continue trabalhando, e esse sistema tem acesso de administrador porque era o mais fácil de conectar. As orientações de autorização da OWASP apontam para verificar o acesso em cada requisição e aplicar o menor privilégio necessário. Para caminhos de contingência, a regra é simples: uma rota alternativa não pode conceder mais autoridade do que a principal, e cada rota deve aparecer no registro de ferramentas do agente com o mesmo limite de aprovação.
O registro é a outra metade do controle. Os conceitos de observabilidade do OpenTelemetry descrevem traces, métricas e logs como meios de ver como um sistema se comporta entre seus componentes, e é isso que um responsável precisa para distinguir um soluço isolado de um padrão. Registre cada troca entre rotas, cada retenção e cada escalonamento, com o motivo e o resultado. Uma linha de log que diz que uma contingência foi acionada só é útil quando também diz por que e o que aconteceu depois. Para o plano mais amplo, que cobre interrupções mais longas, a leitura seguinte é Plano de continuidade de negócios para agentes de IA: como agir em quedas.
Como a Be Human opera caminhos de contingência na operação gerenciada
A Be Human trata o mapa de contingência como parte do primeiro trabalho, não como um detalhe posterior. O escopo nomeia a função única que o agente executa, as ferramentas que ele pode usar, as ações que precisam de aprovação humana, a resposta a falhas para cada etapa e o dono da fila humana. Na operação gerenciada, esse mapa é revisado durante o monitoramento e as revisões de permissões, os incidentes seguem uma resposta escrita, e cada mudança em uma regra de contingência é registrada para que o negócio veja o que mudou e por quê.
Se ainda não está claro quais tarefas do seu agente merecem um caminho de contingência primeiro, o diagnóstico gratuito de IA da Be Human pode ajudar a encontrar a primeira tarefa que vale entregar a um agente.
Perguntas frequentes
Em que um caminho de contingência difere de uma repetição? Uma repetição refaz a mesma chamada e espera que ela funcione. Um caminho de contingência define o que o agente faz quando repetir não basta ou não é seguro, incluindo rotas alternativas, resultados parciais marcados, retenções e escalonamento para uma pessoa.
Um agente de IA deve algum dia chutar quando uma ferramenta está fora do ar? Somente em tarefas de baixo risco em que um resultado parcial claramente marcado seja aceitável para quem lê. Para qualquer coisa que altere registros, envie mensagens ou movimente dinheiro, chutar cria risco, então o agente deve reter ou parar e entregar a decisão a uma pessoa.
Quem deve ser dono da fila humana? Uma função nomeada no negócio, normalmente a equipe responsável pelo processo que o agente apoia, com um substituto identificado. A equipe técnica pode manter a integração funcionando, mas decisões sobre um cliente, um pedido ou uma reserva pertencem ao responsável pela operação.
Como saber se o desenho de contingência funciona? Teste antes da entrada em produção, desligando cada ferramenta em um ambiente controlado e observando o que o agente faz em cada etapa. Depois de incidentes reais, revise a fila e os logs, e atualize as regras quando itens voltarem com frequência demais ou esperarem tempo demais por revisão.
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.


