اكتشاف حلقة الأدوات

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. اكتشاف الحلقات (tools.loopDetection.enabled) — معطل افتراضيًا. يراقب سجل استدعاءات الأدوات المتحرك بحثًا عن الأنماط المتكررة وإعادات المحاولة لأدوات غير معروفة.
2. حارس ما بعد Compaction (tools.loopDetection.postCompactionGuard) — مفعّل افتراضيًا ما لم تكن tools.loopDetection.enabled مضبوطة صراحةً على false. يتسلح بعد كل إعادة محاولة بعد Compaction ويجهض التشغيل عندما يصدر الوكيل الثلاثية نفسها (tool, args, result) ضمن النافذة.

​

سبب وجود هذا

• اكتشاف التسلسلات المتكررة التي لا تحقق تقدمًا.
• اكتشاف حلقات عدم وجود نتائج عالية التكرار (الأداة نفسها، المدخلات نفسها، أخطاء متكررة).
• اكتشاف أنماط استدعاءات متكررة محددة لأدوات polling معروفة.
• منع دورات تجاوز السياق ثم Compaction ثم الحلقة نفسها من الاستمرار إلى أجل غير مسمى.

​

كتلة التهيئة

{
  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,
          },
        },
      },
    ],
  },
}

​

سلوك الحقول

​

الإعداد الموصى به

• للنماذج الأصغر، اضبط enabled: true واترك العتبات على قيمها الافتراضية. نادرًا ما تحتاج النماذج الرائدة إلى اكتشاف السجل المتحرك، ويمكنها إبقاء المفتاح الرئيسي على false مع الاستفادة من حارس ما بعد Compaction.
• أبقِ العتبات مرتبة على النحو warningThreshold < criticalThreshold < globalCircuitBreakerThreshold.
• إذا حدثت نتائج إيجابية كاذبة:
  • ارفع warningThreshold و/أو criticalThreshold.
  • اختياريًا ارفع globalCircuitBreakerThreshold.
  • عطّل الكاشف المحدد الذي يسبب المشكلات فقط (detectors.<name>: false).
  • قلّل historySize لسياق تاريخي أقل صرامة.
• لتعطيل كل شيء (بما في ذلك حارس ما بعد Compaction)، اضبط tools.loopDetection.enabled: false صراحةً.

​

حارس ما بعد Compaction

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

• قيمة windowSize الأقل أكثر صرامة (محاولات أقل قبل الإجهاض).
• قيمة windowSize الأعلى تمنح الوكيل محاولات تعافٍ أكثر.
• لا يجهض الحارس أبدًا عندما تتغير النتائج، بل فقط عندما تكون النتائج متطابقة بايتًا عبر النافذة.
• نطاقه ضيق عمدًا: لا يعمل إلا مباشرةً بعد إعادة محاولة Compaction.

​

السجلات والسلوك المتوقع

• تأتي التحذيرات أولًا.
• يتبعها الكبح عندما تستمر الأنماط بعد عتبة التحذير.
• تحظر العتبات الحرجة دورة الأداة التالية وتعرض سبب اكتشاف الحلقة بوضوح في سجل التشغيل.
• يصدر حارس ما بعد Compaction أخطاء compaction_loop_persisted مع اسم الأداة المخالفة وعدد الاستدعاءات المتطابقة.

​

ذات صلة