Causa: Tool não idempotente em loop
Melhoria: Use chave de operação e estado durável antes do efeito externo.
Loop de agente e falhas controladas
Retries, idempotência, orçamento e condição de parada
Objetivo
Distinguir uma chamada de modelo de um agente e limitar um loop para que falhas não virem repetição autônoma.
História
O agente tenta sincronizar uma OS. Ele observa erro temporário, decide tentar novamente e deve parar ou escalar quando o orçamento termina.
Hipótese a testar
Retry sem classificação e idempotência multiplica dano; mais passos não significam mais inteligência.
Pré-requisitos
- tool call
- API
- estado
Simulador
Altere uma variável, antecipe o efeito e compare com o indicador. A escala mostra pressão relativa, não uma garantia de segurança.
Faixa controladaReveja o contrato e os testes antes de concluir.
Fluxo observado
- observar
- decidir
- autorizar
- agir
- registrar
- parar ou repetir
O que observar
- Condição de parada pertence ao harness, não só ao modelo.
- Idempotência permite repetir intenção sem repetir efeito.
- Falha permanente, permissão negada e entrada inválida não devem receber retry cego.
Erros comuns e melhoria
Causa: Sem detector de repetição
Melhoria: Registre estado, compare ações e pare em ciclo ou ausência de novidade.
Exercício guiado
- Defina estado e stop conditions.
- Classifique quatro falhas em retry, corrigir, escalar ou parar.
- Simule reinício do processo após tool executada e resposta perdida.
Desafio independente
Projete handoff para humano contendo contexto suficiente sem despejar toda a conversa.
Evidência exigida
Trace de execução com passo, decisão, tool, custo, resultado e motivo de parada para caminho feliz e três falhas.