反復検索パターン は何をしますか？
マルチエージェントワークフローにおける「コンテキスト問題」を解決します。サブエージェントは作業を開始するまで自分が必要とするコンテキストを把握できません。
有効化するタイミング
- サブエージェントが事前に予測できないコードベースコンテキストを必要とする場合
- コンテキストを段階的に洗練するマルチエージェントワークフローを構築する場合
- エージェントタスクで「コンテキストが大きすぎる」または「コンテキストが見つからない」エラーが発生する場合
- コード探索のためのRAG風検索パイプラインを設計する場合
- エージェントオーケストレーションでトークン使用量を最適化する場合
問題点
サブエージェントは限られたコンテキストで起動されます。サブエージェントは以下の情報を把握していません：
- どのファイルに関連コードが含まれているか
- コードベースにどのようなパターンが存在するか
- プロジェクトでどのような用語が使われているか
標準的なアプローチは失敗します：
- すべて送信: コンテキスト制限を超過
- 何も送信しない: エージェントが重要な情報を欠く
- 必要なものを推測: 多くの場合誤っている
解決策: 反復検索
コンテキストを段階的に洗練する4フェーズのループです：
┌─────────────────────────────────────────────┐
│ │
│ ┌──────────┐ ┌──────────┐ │
│ │ DISPATCH │─────│ EVALUATE │ │
│ └──────────┘ └──────────┘ │
│ ▲ │ │
│ │ ▼ │
│ ┌──────────┐ ┌──────────┐ │
│ │ LOOP │─────│ REFINE │ │
│ └──────────┘ └──────────┘ │
│ │
│ 最大3サイクル、その後処理続行 │
└─────────────────────────────────────────────┘
フェーズ1: DISPATCH
初期の広範なクエリで候補ファイルを収集します：
// 高レベルの意図から開始
const initialQuery = {
patterns: ['src/**/*.ts', 'lib/**/*.ts'],
keywords: ['authentication', 'user', 'session'],
excludes: ['*.test.ts', '*.spec.ts']
};
// 検索エージェントにディスパッチ
const candidates = await retrieveFiles(initialQuery);
フェーズ2: EVALUATE
取得したコンテンツの関連性を評価します：
function evaluateRelevance(files, task) {
return files.map(file => ({
path: file.path,
relevance: scoreRelevance(file.content, task),
reason: explainRelevance(file.content, task),
missingContext: identifyGaps(file.content, task)
}));
}
スコアリング基準：
- 高 (0.8-1.0): 対象機能を直接実装している
- 中 (0.5-0.7): 関連パターンまたは型を含む
- 低 (0.2-0.4): 間接的に関連
- なし (0-0.2): 関連なし、除外
フェーズ3: REFINE
評価に基づいて検索条件を更新します：
function refineQuery(evaluation, previousQuery) {
return {
// 高関連性ファイルで発見された新しいパターンを追加
patterns: [...previousQuery.patterns, ...extractPatterns(evaluation)],
// コードベースで見つかった用語を追加
keywords: [...previousQuery.keywords, ...extractKeywords(evaluation)],
// 関連性が確認されなかったパスを除外
excludes: [...previousQuery.excludes, ...evaluation
.filter(e => e.relevance < 0.2)
.map(e => e.path)
],
// 特定のギャップをターゲット
focusAreas: evaluation
.flatMap(e => e.missingContext)
.filter(unique)
};
}
フェーズ4: LOOP
洗練された条件で繰り返します（最大3サイクル）：
async function iterativeRetrieve(task, maxCycles = 3) {
let query = createInitialQuery(task);
let bestContext = [];
for (let cycle = 0; cycle < maxCycles; cycle++) {
const candidates = await retrieveFiles(query);
const evaluation = evaluateRelevance(candidates, task);
// 十分なコンテキストがあるか確認
const highRelevance = evaluation.filter(e => e.relevance >= 0.7);
if (highRelevance.length >= 3 && !hasCriticalGaps(evaluation)) {
return highRelevance;
}
// 洗練して続行
query = refineQuery(evaluation, query);
bestContext = mergeContext(bestContext, highRelevance);
}
return bestContext;
}
実践例
例1: バグ修正コンテキスト
タスク: 「認証トークンの期限切れバグを修正」
サイクル1:
DISPATCH: src/** 内で