Como passa despercebido
O seu agente continua a trabalhar. O terminal continua a mover-se. Mas já pediu a mesma coisa pela quinta vez. A atividade pode parecer tranquilizadora, mesmo quando a sessão está presa num loop.
Imagine uma tarefa de código em que o agente continua a verificar o estado do Git. Uma vez é útil. Cinco chamadas idênticas seguidas podem indicar que perdeu o próximo passo. Em várias sessões, esse padrão é fácil de ignorar até voltar à mesma tarefa inacabada.
O que o ClawMetry deteta
O ClawMetry procura chamadas de ferramentas repetidas com os mesmos argumentos e ciclos curtos repetidos de nomes de ferramentas. Quando a repetição ultrapassa o limiar aplicável, gera um aviso de loop preso. O resultado indica o padrão, a ferramenta e o número de repetições.
A diferença que muda o resultado
Exemplo de acionamento
5 chamadas idênticas
Alerta de aviso
Comparação silenciosa
8 argumentos diferentes
Sem resultado para este detetor.
No exemplo verificado, cinco chamadas idênticas ao estado do Git geram um aviso. Oito chamadas com argumentos de ficheiros diferentes ficam silenciosas para este detetor. A diferença importante é a ação repetida. Os limiares podem refletir o runtime e a sua linha de base aprendida, por isso cinco é um exemplo, não uma regra universal.
Inspecionar o resultado do detetor
{
"kind": "stuck_loop",
"severity": "warning",
"evidence": {
"pattern": "identical",
"tool": "Bash",
"repeats": 5,
"total_tool_calls": 5,
"threshold": 3,
"threshold_source": "static"
}
}Como o exemplo foi verificado
Estes exemplos avaliam o detetor publicado com dados de eventos criados ou ficheiros de configuração descartáveis. Os vídeos ilustram esses comportamentos. Não são gravações de agentes reais ou da interface do produto. Nenhum comando nos exemplos foi executado.
O resultado estabelece o comportamento para estas entradas. Não estabelece ingestão em runtime, prevenção ou um compromisso real. Inspecionar o contrato de fonte fixado.
O que verificar a seguir
Inspecione a etapa repetida e os seus resultados. O agente está à espera de algo que não pode mudar? Precisa de uma dependência em falta ou de uma próxima ação mais clara? Use o resultado para quebrar o ciclo manualmente e verifique se o trabalho útil é retomado.
- Inspecionar etapa repetida
- Verificar o que está faltando
- Definir uma próxima ação concreta
O que este sinal estabelece
A repetição pode ser intencional. Este resultado não determina a causa, não interrompe a sessão nem limita os gastos.