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

1. اكتشاف الحلقات (enabled) - معطّل افتراضيًا. يراقب السجل المتحرك لاستدعاءات الأدوات بحثًا عن الأنماط المتكررة وإعادات محاولة الأدوات المجهولة.
2. آلية الحماية بعد Compaction (postCompactionGuard) - مفعّلة كلما لم تكن قيمة enabled هي false صراحةً. تُسلّح بعد كل إعادة محاولة تلي Compaction وتُجهض التشغيل إذا كرر الوكيل الثلاثية نفسها (tool, args, result) ضمن النافذة.

​

سبب وجود هذه الميزة

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

​

كتلة الإعداد

{
  tools: {
    loopDetection: {
      enabled: false, // المفتاح الرئيسي لكاشفات السجل المتحرك
      historySize: 30,
      warningThreshold: 10,
      criticalThreshold: 20,
      unknownToolThreshold: 10,
      globalCircuitBreakerThreshold: 30,
      detectors: {
        genericRepeat: true,
        knownPollNoProgress: true,
        pingPong: true,
      },
      postCompactionGuard: {
        windowSize: 3, // تُسلّح بعد إعادة المحاولة التالية لـ Compaction؛ تعمل ما لم تكن enabled هي false صراحةً
      },
    },
  },
}

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

​

سلوك الحقول

​

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

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

​

آلية الحماية بعد Compaction

{
  tools: {
    loopDetection: {
      // المفتاح الرئيسي؛ اضبطه على false لتعطيل آلية الحماية مع كاشفات السجل المتحرك
      enabled: true,
      postCompactionGuard: {
        windowSize: 3, // القيمة الافتراضية
      },
    },
  },
}

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

​

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

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

​

ذو صلة