Виявлення циклів інструментів

1. Виявлення циклів (enabled) — типово вимкнено. Відстежує ковзну історію викликів інструментів, щоб виявляти повторювані шаблони та повторні спроби виклику невідомих інструментів.
2. Запобіжник після Compaction (postCompactionGuard) — увімкнений, якщо enabled явно не встановлено в false. Активується після кожної повторної спроби після Compaction і перериває виконання, якщо агент повторює ту саму трійку (інструмент, аргументи, результат) у межах вікна.

​

Навіщо це потрібно

• Виявляти повторювані послідовності, які не дають прогресу.
• Виявляти високочастотні цикли без результату (той самий інструмент, ті самі вхідні дані, повторювані помилки).
• Виявляти певні шаблони повторюваних викликів для відомих інструментів опитування.
• Переривати цикли переповнення контексту -> 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, указуючи проблемний інструмент і кількість однакових викликів.

​

Пов’язані матеріали