Tool-loop detection

​

これが存在する理由

• 進行しない反復シーケンスを検出します。
• 高頻度の結果のないループ (同じツール、同じ入力、繰り返されるエラー) を検出します。
• 既知のポーリング ツールの特定の繰り返し通話パターンを検出します。

​

構成ブロック

{
  tools: {
    loopDetection: {
      enabled: false,
      historySize: 30,
      warningThreshold: 10,
      criticalThreshold: 20,
      globalCircuitBreakerThreshold: 30,
      detectors: {
        genericRepeat: true,
        knownPollNoProgress: true,
        pingPong: true,
      },
    },
  },
}

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

​

フィールドの動作

• enabled: マスター スイッチ。 false は、ループ検出が実行されないことを意味します。
• historySize: 分析のために保存されている最近のツール呼び出しの数。
• warningThreshold: パターンを警告のみとして分類する前のしきい値。
• criticalThreshold: 反復ループ パターンをブロックするためのしきい値。
• globalCircuitBreakerThreshold: グローバルな進行状況なしブレーカーのしきい値。
• detectors.genericRepeat: 繰り返される同じツール + 同じパラメータのパターンを検出します。
• detectors.knownPollNoProgress: 状態変化のない既知のポーリングのようなパターンを検出します。
• detectors.pingPong: 交互のピンポン パターンを検出します。

​

推奨されるセットアップ- enabled: true で始まり、デフォルトは変更されません

• しきい値を warningThreshold < criticalThreshold < globalCircuitBreakerThreshold として順序付けします。
• 誤検知が発生した場合:
  • warningThreshold および/または criticalThreshold を発生させます
  • (オプションで) globalCircuitBreakerThreshold を発生させます
  • 問題の原因となっている検出器のみを無効にします
  • 厳密性の低い歴史的コンテキストのために historySize を削減します

​

ログと予期される動作

• 警告と一時的な抑制を優先します。
• 繰り返しの証拠が蓄積された場合にのみエスカレーションします。

​

注意事項

• tools.loopDetection はエージェント レベルのオーバーライドとマージされます。
• エージェントごとの設定は、グローバル値を完全に上書きまたは拡張します。
• 構成が存在しない場合、ガードレールはオフのままになります。