Política de repetição para agentes de IA sem duplicidades

Uma política de repetição define quando um fluxo pode repetir uma etapa que falhou, quantas vezes e quando deve parar. Baseie-a no tipo de falha e nos efeitos da ação. Um erro temporário de leitura e uma entrega desconhecida não devem receber o mesmo tratamento.

Classifique antes de repetir

Imagine uma consulta de documento com erro temporário de servidor. Uma repetição limitada pode ser razoável. Agora imagine um envio de email que perde a resposta depois de chegar ao provedor. Repetir sem reconciliar pode enviar uma cópia.

Falhas de autenticação, entradas inválidas e permissões negadas normalmente exigem outra ação, não o mesmo pedido novamente. O modelo não deve tentar rotas diferentes para contornar uma recusa intencional.

Escreva uma tabela pequena de decisão

• Falha temporária de leitura: repetir com limite e intervalo definidos.
• Entrada inválida: corrigir ou pedir a informação ausente.
• Acesso negado: parar e encaminhar ao responsável autorizado.
• Escrita com resultado desconhecido: reconciliar antes de tentar novamente.
• Falha recorrente: preservar checkpoint e escalar com evidência.

Respeite orientações de limite do provedor e evite rajadas sincronizadas. Mantenha um orçamento total por tarefa para impedir que ciclos aninhados multipliquem o trabalho sem controle.

Preserve etapas bem-sucedidas

Se o relatório foi gerado, mas o envio do arquivo falhou, recupere o envio em vez de gerar tudo novamente. Repetir etapas pode alterar o material e dificultar a comparação com uma aprovação já concedida.

Preserve conteúdo e identidade da ação quando a repetição representar a mesma operação. Se o conteúdo mudar, trate como nova ação proposta e confira a autorização.

Teste a condição de parada

Simule um erro persistente e confirme que o fluxo para no limite combinado com uma passagem útil. Teste separadamente uma escrita de resultado desconhecido. O objetivo é recuperação controlada, não um agente que anuncia sucesso depois de esgotar todos os caminhos possíveis.

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