Como isso passa despercebido
Seu agente ainda está trabalhando. O terminal continua se movendo. Mas ele acabou de pedir a mesma coisa pela quinta vez. Atividade pode parecer tranquilizadora, mesmo quando a sessão está presa em um loop.
Imagine uma tarefa de codificação em que o agente continua verificando o status do Git. Uma vez é útil. Cinco chamadas idênticas seguidas podem indicar que ele perdeu o próximo passo. Em várias sessões, esse padrão é fácil de ignorar até você voltar à mesma tarefa inacabada.
O que o ClawMetry detecta
O ClawMetry procura chamadas de ferramentas repetidas com os mesmos argumentos e ciclos curtos de nomes de ferramentas que se repetem. Quando a repetição ultrapassa o limite aplicável, ele emite um aviso de loop travado. O achado informa o padrão, a ferramenta e a contagem de repetições.
A diferença que muda o achado
Exemplo que aciona o detector
5 chamadas idênticas
Aviso detectado
Comparação silenciosa
8 argumentos diferentes
Nenhum achado para este detector.
No exemplo verificado, cinco chamadas idênticas de status do Git geram um aviso. Oito chamadas com argumentos de arquivo diferentes ficam silenciosas para este detector. A diferença importante é a ação repetida. Os limites podem refletir o runtime e sua linha de base aprendida, então cinco é um exemplo, não uma regra universal.
Inspecionar o resultado do detector
{
"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 detector publicado com dados de eventos criados ou arquivos 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 essas entradas. Não estabelece ingestão em tempo real, prevenção ou um comprometimento real. Inspecionar o contrato de fonte fixado.
O que verificar a seguir
Inspecione a etapa repetida e seus resultados. O agente está esperando por algo que não pode mudar? Ele precisa de uma dependência ausente ou de uma próxima ação mais clara? Use o achado para quebrar o ciclo você mesmo, depois verifique se o trabalho útil é retomado.
- Inspecione a etapa repetida
- Verifique o que está faltando
- Defina a próxima ação concreta
O que este sinal estabelece
A repetição pode ser intencional. Este achado não determina a causa, não interrompe a sessão nem limita os gastos.