Обнаружение циклов инструментов

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 с указанием проблемного инструмента и количества идентичных вызовов.

​

Связанные материалы