Bibliothèque de détecteursLimite de débit atteinte

Limite de débit atteinte

En attente du fournisseur.

Distinguez les refus de capacité du travail productif de l'agent.

Visualisez le problème. Comprenez la détection.

Narration en anglais avec sous-titres.

Comment ça passe inaperçu

Votre agent n'a pas terminé, mais il ne réfléchit pas vraiment non plus. Les requêtes reviennent avec une erreur de capacité. Sans signal clair, la limitation du fournisseur peut ressembler à une session lente ou non réactive.

Imaginez deux refus du fournisseur pendant l'exécution d'une tâche. L'agent peut réessayer discrètement, ou cesser de progresser. Attendre davantage ne résoudra pas tous les problèmes de quota ou de capacité, surtout quand plusieurs sessions partagent les mêmes limites.

Ce que ClawMetry détecte

ClawMetry recherche les refus de capacité dans les résultats d'outils et les événements d'erreur API explicites. Il reconnaît les codes de statut comme HTTP 429 et HTTP 529, ainsi que les textes de limitation de débit et de surcharge. Des refus répétés lèvent une alerte.

La différence qui change tout

Exemple déclencheur

2 refus de capacité

Alerte

Comparaison silencieuse

1 refus de capacité

Aucune détection pour ce détecteur.

Dans l'exemple vérifié, deux événements d'erreur HTTP 429 produisent une détection de limite de débit. Un seul refus reste en dessous du seuil par défaut. La détection inclut le nombre de refus, vous permettant de distinguer un problème répété d'une réponse transitoire.

Inspecter le résultat du détecteur
{
  "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": ""
  }
}
Télécharger les entrées et résultats complets (JSON)
Comment l'exemple a été vérifié

Ces exemples évaluent le détecteur publié avec des données d'événements créées pour l'occasion ou des fichiers de configuration jetables. Les vidéos illustrent ces comportements. Il ne s'agit pas d'enregistrements d'agents réels ni de l'interface du produit. Aucune commande dans les exemples n'a été exécutée.

Le résultat établit le comportement pour ces entrées. Il n'établit pas l'ingestion en temps réel, la prévention ni un véritable compromis. Inspecter le contrat source épinglé.

Que vérifier ensuite

Vérifiez l'état du fournisseur et les limites du compte ou du modèle utilisé. Réduisez le travail concurrent ou attendez la réinitialisation de la limite concernée si approprié. Confirmez ensuite que les requêtes reprennent au lieu de supposer que l'agent a continué.

  1. Vérifier l'état du fournisseur
  2. Examiner le quota et la concurrence
  3. Confirmer que les requêtes reprennent

Ce que ce signal établit

Il s'agit d'un symptôme de capacité, pas d'un diagnostic de cause racine. Il n'augmente pas automatiquement les quotas ni ne change de fournisseur.

Gardez les moments importants visibles.

Suivez l'activité des agents, inspectez les détections et décidez ce qui nécessite votre attention.