​

Phát hiện vòng lặp công cụ

​

Tại sao cần tính năng này

• Phát hiện các chuỗi lặp lại không tiến triển.
• Phát hiện vòng lặp tần suất cao không có kết quả (cùng công cụ, cùng đầu vào, lỗi lặp lại).
• Phát hiện các mẫu gọi lặp lại cụ thể cho các công cụ thăm dò đã biết.

​

Khối cấu hình

{
  tools: {
    loopDetection: {
      enabled: false,
      historySize: 30,
      warningThreshold: 10,
      criticalThreshold: 20,
      globalCircuitBreakerThreshold: 30,
      detectors: {
        genericRepeat: true,
        knownPollNoProgress: true,
        pingPong: true,
      },
    },
  },
}

{
  agents: {
    list: [
      {
        id: "safe-runner",
        tools: {
          loopDetection: {
            enabled: true,
            warningThreshold: 8,
            criticalThreshold: 16,
          },
        },
      },
    ],
  },
}

​

Hành vi của các trường

• enabled: Công tắc chính. false nghĩa là không thực hiện phát hiện vòng lặp.
• historySize: số lượng cuộc gọi công cụ gần đây được giữ lại để phân tích.
• warningThreshold: ngưỡng trước khi phân loại một mẫu là chỉ cảnh báo.
• criticalThreshold: ngưỡng để chặn các mẫu vòng lặp lặp lại.
• globalCircuitBreakerThreshold: ngưỡng ngắt toàn cục khi không có tiến triển.
• detectors.genericRepeat: phát hiện các mẫu lặp lại cùng công cụ + cùng tham số.
• detectors.knownPollNoProgress: phát hiện các mẫu thăm dò đã biết không có thay đổi trạng thái.
• detectors.pingPong: phát hiện các mẫu ping-pong luân phiên.

​

Cài đặt khuyến nghị

• Bắt đầu với enabled: true, giữ nguyên mặc định.
• Giữ thứ tự ngưỡng là warningThreshold < criticalThreshold < globalCircuitBreakerThreshold.
• Nếu xảy ra dương tính giả:
  • tăng warningThreshold và/hoặc criticalThreshold
  • (tùy chọn) tăng globalCircuitBreakerThreshold
  • vô hiệu hóa chỉ detector gây ra vấn đề
  • giảm historySize để bớt nghiêm ngặt về ngữ cảnh lịch sử

​

Nhật ký và hành vi mong đợi

• Ưu tiên cảnh báo và giảm nhẹ tạm thời trước.
• Chỉ leo thang khi có bằng chứng lặp lại tích lũy.

​

Ghi chú

• tools.loopDetection được kết hợp với ghi đè cấp agent.
• Cấu hình theo từng agent hoàn toàn ghi đè hoặc mở rộng giá trị toàn cục.
• Nếu không có cấu hình, các biện pháp bảo vệ sẽ không hoạt động.