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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

1. Phát hiện vòng lặp (tools.loopDetection.enabled) — bị tắt theo mặc định. Theo dõi lịch sử gọi công cụ dạng cuộn để tìm các mẫu lặp lại và các lần thử lại công cụ không xác định.
2. Chốt chặn sau Compaction (tools.loopDetection.postCompactionGuard) — được bật theo mặc định trừ khi tools.loopDetection.enabled được đặt rõ ràng là false. Kích hoạt sau mỗi lần thử lại sau Compaction và hủy lượt chạy khi agent phát ra cùng bộ ba (tool, args, result) trong cửa sổ.

​

Lý do tồn tại

• Phát hiện các chuỗi lặp lại không tạo ra tiến triển.
• Phát hiện các 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 những công cụ thăm dò đã biết.
• Ngăn các chu kỳ tràn ngữ cảnh rồi Compaction rồi cùng vòng lặp chạy vô thời hạn.

​

Khối cấu hình

{
  tools: {
    loopDetection: {
      enabled: false, // master switch for the rolling-history detectors
      historySize: 30,
      warningThreshold: 10,
      criticalThreshold: 20,
      unknownToolThreshold: 10,
      globalCircuitBreakerThreshold: 30,
      detectors: {
        genericRepeat: true,
        knownPollNoProgress: true,
        pingPong: true,
      },
      postCompactionGuard: {
        windowSize: 3, // armed after compaction-retry; runs unless enabled is explicitly false
      },
    },
  },
}

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

​

Hành vi của trường

​

Thiết lập được khuyến nghị

• Với các mô hình nhỏ hơn, đặt enabled: true và giữ các ngưỡng ở mặc định. Các mô hình hàng đầu hiếm khi cần phát hiện lịch sử dạng cuộn và có thể giữ công tắc chính ở false trong khi vẫn hưởng lợi từ chốt chặn sau Compaction.
• Giữ thứ tự các 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.
  • Chỉ tắt bộ phát hiện cụ thể gây vấn đề (detectors.<name>: false).
  • Giảm historySize để bối cảnh lịch sử ít nghiêm ngặt hơn.
• Để tắt mọi thứ (bao gồm cả chốt chặn sau Compaction), đặt rõ ràng tools.loopDetection.enabled: false.

​

Chốt chặn sau Compaction

{
  tools: {
    loopDetection: {
      // master switch; set false to disable the guard along with the rolling detectors
      enabled: true,
      postCompactionGuard: {
        windowSize: 3, // default
      },
    },
  },
}

• windowSize thấp hơn thì nghiêm ngặt hơn (ít lần thử hơn trước khi hủy).
• windowSize cao hơn cho agent nhiều lần thử khôi phục hơn.
• Chốt chặn không bao giờ hủy khi kết quả đang thay đổi, chỉ hủy khi kết quả giống hệt từng byte trong cửa sổ.
• Nó được cố ý giới hạn hẹp: chỉ kích hoạt ngay sau một lần thử lại sau Compaction.

​

Nhật ký và hành vi dự kiến

• Cảnh báo xuất hiện trước.
• Việc triệt tiêu theo sau khi các mẫu tiếp tục vượt ngưỡng cảnh báo.
• Các ngưỡng nghiêm trọng chặn chu kỳ công cụ tiếp theo và hiển thị lý do phát hiện vòng lặp rõ ràng trong bản ghi lượt chạy.
• Chốt chặn sau Compaction phát ra lỗi compaction_loop_persisted cùng tên công cụ vi phạm và số lượng lệnh gọi giống hệt nhau.

​

Liên quan