Cómo pasa desapercibido
Tu agente no ha terminado, pero tampoco está realmente procesando. Las solicitudes siguen volviendo con un error de capacidad. Sin una señal clara, el throttling del proveedor puede parecer una sesión lenta o sin respuesta.
Imagina dos rechazos del proveedor mientras una tarea está en curso. El agente puede reintentar silenciosamente o dejar de hacer progreso útil. Esperar más no resolverá todos los problemas de cuota o capacidad, especialmente cuando varias sesiones comparten los mismos límites.
Qué detecta ClawMetry
ClawMetry busca rechazos de capacidad en resultados de herramienta y eventos explícitos de error de API. Reconoce códigos de estado como HTTP 429 y HTTP 529, junto con texto de límite de tasa y sobrecarga. Los rechazos repetidos generan una advertencia.
La diferencia que cambia el hallazgo
Ejemplo que activa el detector
2 rechazos de capacidad
Hallazgo de advertencia
Comparación sin hallazgo
1 rechazo de capacidad
Sin hallazgo para este detector.
En el ejemplo verificado, dos eventos de error HTTP 429 producen un hallazgo de límite de tasa alcanzado. Un solo rechazo queda por debajo del umbral predeterminado. El hallazgo incluye el recuento de rechazos para que puedas distinguir un problema repetido de una respuesta transitoria.
Inspeccionar el resultado del 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": ""
}
}Cómo se verificó el ejemplo
Estos ejemplos evalúan el detector publicado con datos de eventos elaborados o archivos de configuración desechables. Los videos ilustran esos comportamientos. No son grabaciones de agentes en vivo ni de la interfaz del producto. Ningún comando de los ejemplos fue ejecutado.
El resultado establece el comportamiento para estas entradas. No establece la ingesta en tiempo de ejecución, la prevención ni un compromiso real. Inspeccionar el contrato de fuente fijado.
Qué revisar a continuación
Comprueba el estado del proveedor y los límites de la cuenta o modelo en uso. Reduce el trabajo concurrente o espera a que se restablezca el límite correspondiente cuando sea apropiado. Luego confirma que las solicitudes se recuperan en lugar de asumir que el agente ha retomado el trabajo.
- Comprueba el estado del proveedor
- Revisa cuota y concurrencia
- Confirma que las solicitudes se recuperan
Qué establece esta señal
Es un síntoma de capacidad, no un diagnóstico de causa raíz. No aumenta cuotas automáticamente ni cambia de proveedor.