Como isso passa despercebido
Seu agente não terminou, mas também não está realmente processando. As requisições continuam retornando com erro de capacidade. Sem um sinal claro, o throttling do provedor pode parecer uma sessão lenta ou sem resposta.
Imagine duas recusas do provedor enquanto uma tarefa está em execução. O agente pode tentar novamente silenciosamente ou parar de fazer progresso útil. Esperar mais não resolve todo problema de cota ou capacidade, especialmente quando várias sessões compartilham os mesmos limites.
O que o ClawMetry detecta
O ClawMetry busca recusas de capacidade nos resultados de ferramentas e eventos explícitos de erro de API. Reconhece códigos de status como HTTP 429 e HTTP 529, além de textos de rate limit e sobrecarga. Recusas repetidas geram um aviso.
A diferença que muda o achado
Exemplo que aciona o detector
2 recusas de capacidade
Achado de aviso
Comparação silenciosa
1 recusa de capacidade
Nenhum achado para este detector.
No exemplo verificado, dois eventos de erro HTTP 429 produzem um achado de rate limited. Uma recusa fica abaixo do limite padrão. O achado inclui a contagem de recusas, permitindo distinguir um problema recorrente de uma resposta transitória.
Inspecionar o resultado do detector
{
"kind": "rate_limited",
"severity": "warning",
"evidence": {
"refusals": 2,
"threshold": 2,
"threshold_source": "static",
"observed": "HTTP 429/529 status or rate-limit text on tool results and API error events",
"sample": ""
}
}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
Verifique o status do provedor e os limites da conta ou modelo em uso. Reduza o trabalho concorrente ou aguarde o limite relevante ser resetado quando apropriado. Confirme então que as requisições se recuperam, em vez de assumir que o agente retomou.
- Verifique o status do provedor
- Revise cota e concorrência
- Confirme que as requisições se recuperam
O que este sinal estabelece
Este é um sintoma de capacidade, não um diagnóstico de causa raiz. Não aumenta cotas automaticamente nem troca de provedor.