Thư viện detectorVòng lặp kẹt

Vòng lặp kẹt

Vẫn chạy. Không đi đến đâu.

Phát hiện hành động lặp lại ẩn trong phiên làm việc bận rộn.

Thấy vấn đề. Hiểu kết quả phát hiện.

Giọng kể tiếng Anh có phụ đề.

Tại sao dễ bị bỏ qua

Agent của bạn vẫn đang chạy. Terminal vẫn tiếp tục cuộn. Nhưng nó vừa yêu cầu cùng một thứ lần thứ năm. Hoạt động liên tục có thể trông yên tâm, ngay cả khi phiên đang mắc kẹt trong vòng lặp.

Hãy hình dung một tác vụ lập trình mà agent liên tục kiểm tra trạng thái Git. Một lần là hữu ích. Năm lần gọi giống nhau liên tiếp có thể là dấu hiệu nó đã mất bước tiếp theo. Qua nhiều phiên, mẫu này dễ bị bỏ sót cho đến khi bạn quay lại cùng tác vụ chưa hoàn thành.

ClawMetry phát hiện gì

ClawMetry tìm kiếm các lần gọi công cụ lặp lại với cùng tham số và các chu kỳ ngắn lặp lại tên công cụ. Khi số lần lặp vượt ngưỡng áp dụng, nó sẽ phát cảnh báo vòng lặp kẹt. Kết quả phát hiện cho biết mẫu lặp, công cụ và số lần lặp.

Sự khác biệt thay đổi kết quả phát hiện

Ví dụ kích hoạt

5 lần gọi giống nhau

Cảnh báo

So sánh im lặng

8 tham số khác nhau

Không có kết quả phát hiện cho detector này.

Trong ví dụ được kiểm tra, năm lần gọi Git status giống nhau tạo ra cảnh báo. Tám lần gọi với tham số file khác nhau vẫn im lặng với detector này. Điểm quan trọng là hành động lặp lại. Ngưỡng có thể phản ánh runtime và baseline đã học, vì vậy năm là ví dụ, không phải quy tắc chung.

Kiểm tra kết quả detector
{
  "kind": "stuck_loop",
  "severity": "warning",
  "evidence": {
    "pattern": "identical",
    "tool": "Bash",
    "repeats": 5,
    "total_tool_calls": 5,
    "threshold": 3,
    "threshold_source": "static"
  }
}
Tải đầu vào và kết quả đầy đủ (JSON)
Cách ví dụ được kiểm tra

Các ví dụ này đánh giá detector đã xuất bản bằng dữ liệu sự kiện được soạn thảo hoặc tệp cấu hình dùng một lần. Video minh họa các hành vi đó. Đây không phải là bản ghi của agent thực hoặc giao diện sản phẩm. Không có lệnh nào trong ví dụ được thực thi.

Kết quả xác lập hành vi cho các đầu vào này. Nó không xác lập việc thu thập runtime, ngăn chặn hay một sự xâm phạm thực sự. Kiểm tra hợp đồng nguồn đã ghim.

Những gì cần kiểm tra tiếp theo

Kiểm tra bước lặp lại và kết quả của nó. Agent có đang chờ điều gì đó không thể thay đổi không? Nó có cần một phụ thuộc còn thiếu hay một hành động tiếp theo rõ ràng hơn không? Dùng kết quả phát hiện để tự phá vỡ vòng lặp, sau đó kiểm tra xem công việc hữu ích có tiếp tục không.

  1. Kiểm tra bước lặp lại
  2. Xác định điều còn thiếu
  3. Đưa ra hành động tiếp theo cụ thể

Tín hiệu này xác lập điều gì

Lặp lại có thể là chủ ý. Kết quả phát hiện này không xác định nguyên nhân, dừng phiên hay giới hạn chi tiêu.

Giữ những khoảnh khắc quan trọng luôn hiển thị.

Theo dõi hoạt động agent, kiểm tra kết quả phát hiện và quyết định điều gì cần sự chú ý của bạn.