Βιβλιοθήκη ανιχνευτώνΚολλημένος βρόχος

Κολλημένος βρόχος

Συνεχίζει να τρέχει. Χωρίς αποτέλεσμα.

Εντοπίστε την επαναλαμβανόμενη ενέργεια που κρύβεται μέσα σε μια πολυάσχολη συνεδρία.

Δείτε το πρόβλημα. Κατανοήστε το εύρημα.

Αγγλική αφήγηση με υπότιτλους.

Πώς παραβλέπεται

Ο agent σας εξακολουθεί να εργάζεται. Το τερματικό συνεχίζει να κινείται. Όμως μόλις ζήτησε το ίδιο πράγμα για πέμπτη φορά. Η δραστηριότητα μπορεί να φαίνεται καθησυχαστική, ακόμα και όταν η συνεδρία έχει κολλήσει σε βρόχο.

Φανταστείτε μια εργασία κώδικα όπου ο agent ελέγχει επανειλημμένα την κατάσταση Git. Μια φορά είναι χρήσιμο. Πέντε πανομοιότυπες κλήσεις στη σειρά μπορεί να σημαίνει ότι έχει χάσει το επόμενο βήμα του. Σε πολλές συνεδρίες, αυτό το μοτίβο είναι εύκολο να χαθεί έως ότου επιστρέψετε στην ίδια ανολοκλήρωτη εργασία.

Τι ανιχνεύει το ClawMetry

Το ClawMetry αναζητά επαναλαμβανόμενες κλήσεις εργαλείων με τα ίδια ορίσματα και σύντομους επαναλαμβανόμενους κύκλους ονομάτων εργαλείων. Όταν η επανάληψη υπερβεί το ισχύον όριο, εγείρει προειδοποίηση κολλημένου βρόχου. Το εύρημα σας ενημερώνει για το μοτίβο, το εργαλείο και τον αριθμό επαναλήψεων.

Η διαφορά που αλλάζει το εύρημα

Παράδειγμα ενεργοποίησης

5 πανομοιότυπες κλήσεις

Εύρημα προειδοποίησης

Αθόρυβη σύγκριση

8 διαφορετικά ορίσματα

Κανένα εύρημα για αυτόν τον ανιχνευτή.

Στο ελεγμένο παράδειγμα, πέντε πανομοιότυπες κλήσεις κατάστασης Git παράγουν προειδοποίηση. Οκτώ κλήσεις με διαφορετικά ορίσματα αρχείων παραμένουν αθόρυβες για αυτόν τον ανιχνευτή. Η σημαντική διαφορά είναι η επαναλαμβανόμενη ενέργεια. Τα όρια μπορεί να αντικατοπτρίζουν το runtime και τη μαθημένη βάση αναφοράς του, οπότε το πέντε είναι παράδειγμα, όχι καθολικός κανόνας.

Εξετάστε το αποτέλεσμα ανιχνευτή
{
  "kind": "stuck_loop",
  "severity": "warning",
  "evidence": {
    "pattern": "identical",
    "tool": "Bash",
    "repeats": 5,
    "total_tool_calls": 5,
    "threshold": 3,
    "threshold_source": "static"
  }
}
Λήψη εισόδων και πλήρων αποτελεσμάτων (JSON)
Πώς ελέγχθηκε το παράδειγμα

Αυτά τα παραδείγματα αξιολογούν τον δημοσιευμένο ανιχνευτή με δεδομένα συμβάντων ή αναλώσιμα αρχεία ρυθμίσεων. Τα βίντεο απεικονίζουν αυτές τις συμπεριφορές. Δεν αποτελούν εγγραφές ζωντανών agents ή της διεπαφής προϊόντος. Καμία εντολή στα παραδείγματα δεν εκτελέστηκε.

Το αποτέλεσμα καθορίζει τη συμπεριφορά για αυτές τις εισόδους. Δεν καθορίζει λήψη δεδομένων runtime, πρόληψη ή πραγματικό συμβιβασμό. Εξετάστε τη σταθερή σύμβαση πηγής.

Τι να ελέγξετε στη συνέχεια

Εξετάστε το επαναλαμβανόμενο βήμα και τα αποτελέσματά του. Περιμένει ο agent κάτι που δεν μπορεί να αλλάξει; Χρειάζεται μια ελλείπουσα εξάρτηση ή μια σαφέστερη επόμενη ενέργεια; Χρησιμοποιήστε το εύρημα για να σπάσετε τον κύκλο μόνοι σας, έπειτα ελέγξτε αν η χρήσιμη εργασία συνεχίζεται.

  1. Εξετάστε το επαναλαμβανόμενο βήμα
  2. Ελέγξτε τι λείπει
  3. Δώστε μια συγκεκριμένη επόμενη ενέργεια

Τι καθορίζει αυτό το σήμα

Η επανάληψη μπορεί να είναι σκόπιμη. Αυτό το εύρημα δεν προσδιορίζει την αιτία, δεν διακόπτει τη συνεδρία και δεν περιορίζει τις δαπάνες.

Κρατήστε τις σημαντικές στιγμές ορατές.

Παρακολουθήστε τη δραστηριότητα agent, εξετάστε τα ευρήματα και αποφασίστε τι χρειάζεται την προσοχή σας.