Cómo pasa desapercibido
Tu agente no ha terminado, pero tampoco está procesando realmente. Las solicitudes siguen regresando 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 ejecución. El agente puede reintentar silenciosamente, o dejar de hacer progreso útil. Esperar más no resuelve todos los problemas de cuota o capacidad, especialmente cuando varias sesiones comparten los mismos límites.
Qué detecta ClawMetry
ClawMetry busca rechazos por capacidad en resultados de herramientas 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 por capacidad
Hallazgo de advertencia
Comparación sin hallazgo
1 rechazo por 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 rechazo se mantiene por debajo del umbral predeterminado. El hallazgo incluye el conteo 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 creados o archivos de configuración desechables. Los videos ilustran esos comportamientos. No son grabaciones de agentes en uso ni de la interfaz del producto. Ningún comando de los ejemplos fue ejecutado.
El resultado establece el comportamiento para estas entradas. No establece ingesta en tiempo real, prevención ni un compromiso real. Inspeccionar el contrato de código fuente fijado.
Qué revisar a continuación
Revisa el estado del proveedor y los límites de la cuenta o el 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 reanudado.
- Revisa el estado del proveedor
- Revisa la cuota y la concurrencia
- Confirma que las solicitudes se recuperan
Qué establece esta señal
Esto es un síntoma de capacidad, no un diagnóstico de causa raíz. No aumenta cuotas ni cambia de proveedor automáticamente.