Ir para conteúdo
be-human.ai
← Voltar ao blog

Testes e confiabilidade

Tempo limite para agentes de IA: pare execuções sem controle

Defina limites de tempo, de passos e de custo para execuções de agentes de IA, um estado de parada claro e entrega com responsável nomeado.

Capa tipográfica do Be Human com o título: Tempo limite para agentes de IA: pare execuções sem controle
Ilustração conceitual criada com IA · Be Human

O tempo limite de uma execução de agente é um teto rígido para quanto tempo, quantos passos e quanto gasto uma única tarefa pode consumir antes que o agente precise parar. Um bom tempo limite para agentes de IA combina três limites independentes, definidos separadamente para cada tipo de tarefa, e todo limite termina em um estado de parada definido, que entrega o trabalho inacabado a uma pessoa com nome. O objetivo não é fazer o agente trabalhar mais rápido. O objetivo é garantir que uma execução travada falhe de forma visível e recuperável.

Principais pontos

  • Use três limites independentes por execução: tempo decorrido, número de passos e gasto.
  • Todo limite deve terminar em um estado de parada definido, nunca em falha silenciosa ou em um falso sucesso.
  • Pare apenas em um ponto seguro e salve o progresso antes que a execução seja encerrada.
  • Encaminhe a tarefa inacabada a um responsável nomeado, com o motivo, as evidências e a única decisão necessária.
  • Defina os limites por tipo de tarefa a partir de execuções saudáveis medidas e revise-os todo mês com os registros reais.

Por que execuções de agentes saem do controle

Uma execução descontrolada raramente parece dramática de fora. Uma ferramenta devolve um erro que o agente não reconhece, então ele tenta uma consulta ligeiramente diferente, depois outra, depois reescreve o plano e tenta de novo. Cada passo parece razoável isoladamente. Com o tempo, a execução já consumiu chamadas ao modelo, enviou mensagens duplicadas ou alterou registros que não deveria tocar.

Instruções no prompt, como 'não repita ações', ajudam, mas não podem ser o único controle. A falha costuma estar em uma ferramenta, em uma fila ou em um serviço externo que o prompt nunca enxerga. O tempo limite é a fronteira externa que continua valendo mesmo quando o raciocínio interno do agente já saiu do rumo. Por isso ele deve fazer parte do desenho desde o primeiro dia, e não ser adicionado depois do primeiro incidente.

Os três limites e o que cada um detecta

Cada limite mede um tipo diferente de descontrole, então uma única configuração deixa lacunas. Use os três juntos.

  • Um limite de tempo de relógio encerra qualquer execução que esteja ativa por mais tempo do que a tarefa deveria levar. Ele detecta ferramentas paradas, serviços externos lentos e esperas que nunca se resolvem.
  • Um limite de passos encerra a execução após um número fixo de chamadas de ferramenta ou de turnos do modelo. Ele detecta laços em que o agente repete a mesma ação com pequenas variações, muitas vezes mais rápido do que um relógio perceberia.
  • Um limite de gasto encerra a execução quando os custos de modelo e de ferramentas ultrapassam um teto acordado. Ele detecta raciocínio caro ou recuperação de muitos documentos, que os outros dois limites deixariam passar.

Um laço rápido costuma atingir primeiro o teto de passos. Uma dependência travada costuma atingir o relógio. Uma execução longa, mas legítima, que puxa documentos grandes pode atingir o teto de gasto enquanto se comporta corretamente. Isso é um sinal para revisar o desenho da tarefa, e não apenas para aumentar o número. Para uma visão mais profunda das condições de parada, veja Agente de IA preso em loop: condições de parada que funcionam.

Plano passo a passo para definir os tempos limite

Siga esta sequência para cada tipo de tarefa que o agente executa. Comece pelo trabalho em si, e não pela configuração do agente.

  • Passo 1: Levante a duração, o número de passos e o custo de execuções recentes que terminaram corretamente. Use os registros que o agente já gera e deixe de fora as execuções interrompidas por uma pessoa.
  • Passo 2: Defina o limite de tempo acima da execução saudável mais lenta, com uma margem aprovada pelo responsável pela operação. Fixá-lo perto da média interromperia execuções lentas, mas normais.
  • Passo 3: Defina o teto de passos acima da contagem mais alta que uma execução saudável precisou, com uma pequena margem. Conte cada chamada de ferramenta e cada turno do modelo, e não apenas as mensagens que o usuário vê.
  • Passo 4: Defina um teto de gasto por execução na moeda em que a empresa faz seus relatórios e combine quem recebe o alerta ao atingi-lo. Revise o valor com quem responde pelo orçamento.
  • Passo 5: Escreva o estado de parada de cada limite. Registre o que é salvo, qual ação não é executada e o que o solicitante ou a fila recebe.
  • Passo 6: Nomeie a pessoa ou a fila que recebe cada encaminhamento e o tempo de resposta que essa fila deve cumprir.
  • Passo 7: Teste cada limite de propósito em um ambiente de homologação, com uma ferramenta deliberadamente quebrada. Confirme que a parada acontece no ponto certo e que o encaminhamento chega com o contexto correto.
  • Passo 8: Registre os valores finais nas notas operacionais do agente, com um responsável e uma data de revisão ao lado.

Para um método que verifica se os limites se sustentam no uso real, veja Falhas silenciosas em agentes de IA: detecte com conciliação e amostragem.

Um tempo limite que ninguém é responsável por manter é só um atraso antes de o mesmo problema voltar.

Como é uma parada limpa

Um tempo limite só é seguro se o agente parar em um ponto de fronteira. Duas regras importam mais. O agente deve concluir ou abortar a ação que está executando no momento, nunca cortá-la no meio. Além disso, deve salvar seu estado antes de sair, para que a próxima pessoa ou o próximo processo saiba exatamente em que ponto o trabalho está.

Um agente interrompido no meio de uma escrita pode deixar uma reserva criada em um sistema e ausente em outro. Ferramentas que aceitam pedidos repetidos sem duplicar resultados tornam a recuperação muito mais simples. Quando o fornecedor não oferece esse comportamento, acrescente uma verificação que consulte o registro antes de qualquer retomada. O conteúdo de Chamadas idempotentes em agentes de IA: repetir sem duplicar trabalho detalha esse padrão.

O estado salvo deve ser um checkpoint simples: a tarefa, as entradas, as ações concluídas, a ação pendente e o limite que foi acionado. Um status como 'parou no limite de passos, duas ações concluídas, confirmação não enviada' diz a um operador o que aconteceu, sem que ele precise ler a transcrição. Novas tentativas automáticas após um tempo limite devem vir desligadas por padrão. Retomar a partir de um checkpoint é uma decisão deliberada, e Checkpoints em tarefas longas de agente de IA: retomar sem refazer explica como desenhá-la.

Como encaminhar o trabalho inacabado para uma pessoa

O encaminhamento é a etapa que as equipes mais costumam pular. Uma notificação que diz 'agente excedeu o tempo' é um alerta, não um encaminhamento. A pessoa que a recebe precisa saber qual é a tarefa, o que já foi concluído, o que falta e qual decisão é necessária dela.

Um pacote de encaminhamento útil contém cinco itens:

  • O pedido original e o registro a que ele se refere.
  • As ações concluídas, com identificadores ou links para o local onde cada uma foi registrada.
  • A ação pendente e o motivo pelo qual ela não foi executada.
  • O limite que foi acionado, com o valor observado ao lado do valor configurado.
  • A decisão necessária da pessoa, com as opções e o que cada uma provocaria.

Cenário ilustrativo: um agente prepara a conciliação entre notas de fornecedores e registros de compra. A ferramenta de consulta de um fornecedor começa a devolver totais parciais, e o agente continua tentando até que o teto de passos encerre a execução. A execução para antes de lançar qualquer coisa, salva as linhas conciliadas e a lista de notas divergentes e envia o caso fila de revisão contábil. O contador vê apenas uma decisão: aprovar a conciliação manual ou segurar o lote até que a ferramenta do fornecedor volte a funcionar. O princípio de desenho está em Escalonamento humano em IA: entregue a decisão necessária.

Erros que pioram os tempos limite

Algumas escolhas comuns transformam um controle útil em fonte de novos problemas.

  • Usar um único tempo limite global para todos os agentes e tipos de tarefa, que é frouxo demais para tarefas simples e apertado demais para tarefas longas.
  • Registrar uma execução interrompida por tempo como tarefa concluída nos painéis, o que esconde a falha de quem revisa o desempenho.
  • Permitir que a execução parada tente de novo automaticamente em ferramentas que não tratam pedidos repetidos.
  • Enviar os tempos limite para uma caixa compartilhada que ninguém está designado a ler.
  • Aumentar os limites a cada alerta sem verificar se a tarefa ou o comportamento do agente mudou.

O último erro merece atenção especial. Quando um limite dispara repetidamente, a primeira pergunta deve ser o que mudou nas entradas, nas ferramentas ou nas instruções do agente. Aumentar o número sem essa verificação esconde a causa e transfere a falha para um custo maior. As regras de nova tentativa em Política de repetição para agentes de IA sem duplicidades são um bom complemento para essa revisão.

Como a Be Human trata tempos limite em operações gerenciadas

Em um projeto com a Be Human, os limites de tempo de relógio, de passos e de gasto são definidos já na primeira fase, junto com o papel do agente, a memória e as ferramentas de que ele precisa e as fronteiras de aprovação que deve respeitar. Os estados de parada e as filas de encaminhamento são escritos nas notas operacionais do agente, para que a equipe consiga lê-los e agir sem depender de quem construiu a solução. Na operação gerenciada, acompanhamos quais limites disparam, verificamos nas avaliações recorrentes se os valores ainda se encaixam no trabalho e revisamos permissões quando uma ferramenta conectada muda. Quando um limite dispara repetidamente, a causa é investigada antes de qualquer aumento.

Se você quer identificar a primeira tarefa que vale entregar a um agente e ver onde um tempo limite a protegeria, faça o diagnóstico gratuito de IA da Be Human.

Perguntas frequentes

Que tempo limite devo definir para um agente de IA? Não existe um valor universal. Meça quanto tempo levam as execuções saudáveis daquela tarefa específica, defina o limite de tempo acima da mais lenta delas com uma margem combinada e ajuste depois de revisar execuções reais. Tarefas que esperam por pessoas ou por aprovações externas precisam de limites separados, mais longos.

Um tempo limite basta para parar um agente em loop? Não. O tempo limite encerra a execução, mas não explica por que ela entrou em loop. Combine-o com um teto de passos, que identifica ações repetidas com rapidez, e com registros que mostrem qual chamada de ferramenta se repetiu. O tempo limite é a fronteira externa do desenho, e não o seu único controle.

Um agente que atingiu o tempo limite deve tentar de novo automaticamente? Normalmente, não. Uma nova tentativa automática repete as mesmas condições que causaram a travessia e pode duplicar escritas quando as ferramentas não foram feitas para pedidos repetidos. Retome apenas a partir de um checkpoint salvo, e somente depois de verificar o que já aconteceu nos sistemas conectados.

Quem deve receber o encaminhamento após um tempo limite? Envie para a pessoa que responde pela decisda qual a tarefa depende, e não para uma caixa técnica genérica. Inclua o pedido original, as ações concluídas e pendentes, o limite que foi acionado e a única decisão necessária, e confirme que a fila tem um responsável nomeado e um tempo de resposta esperado.

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.

Menos tarefas. Mais espaço para você.

Traga o trabalho para o qual falta tempo.

Agende uma conversa e teste 7 dias grátis um agente de IA personalizado ↗Ou faça o diagnóstico gratuito de IA →