ツールループ検出

1. ループ検出 (enabled) - デフォルトでは無効です。ローリング形式の ツール呼び出し履歴を監視し、反復パターンと未知ツールの再試行を検出します。
2. Compaction 後ガード (postCompactionGuard) - enabled が明示的に false でない場合に有効になります。 すべての Compaction 再試行後に待機状態になり、エージェントがウィンドウ内で同じ (tool, args, result) の三つ組を繰り返すと実行を中止します。

​

これが存在する理由

• 進捗のない反復シーケンスを検出するため。
• 高頻度の結果なしループ（同じツール、同じ入力、繰り返される エラー）を検出するため。
• 既知のポーリングツールに対する特定の反復呼び出しパターンを検出するため。
• コンテキストオーバーフロー -> 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 の順に保ちます。ランタイムは、 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 エラーを出力します。

​

関連