サブエージェント
Beta feature. Learn more.
サブエージェントは、親エージェントが独立したサブタスクを処理させるために呼び出す子エージェントです。子は自身のコンテキストウィンドウと自身に割り当てられたツールを使って実行され、簡潔な結果を親に返します。親が見られるのは子の中間的な処理過程ではなく、最終的な回答だけです。
親エージェントの集中を保つには、サブエージェントを使います。長時間にわたる調査、ツールを多用する探索、専門的なレビューステップは、トークンを多く消費する中間状態を親のコンテキストに含めないほうが、より効果的に機能します。
サブエージェントを有効にする
エージェントビルダー で Advanced settings を開き、Subagents をオンにします。追加の設定項目が 2 つ表示されます。
- Allow self-spawn - オンにすると、エージェントは並列処理のために自身のコピーを生成できます。ファンアウトパターン (1 つの親、複数の同一 worker) で役立ちます。
- Additional subagents - この親が処理を委任できる、他の特定のエージェントを選択します。親は実行時に、タスクに応じてどのサブエージェントを呼び出すか (必要な場合) を判断します。
保存します。エージェントの実行時に、サブエージェントを呼び出すための新しいツールが利用可能になります。
サブエージェントが役立つ場面
- 調査系のサブタスク - 親が複雑な問いを分解し、その一部をその領域に特化したサブエージェントに任せ、返ってきた応答を統合します。
- ツールを多用する処理 - コードインタープリターのセッション、複数段階のウェブ検索ループ、あるいは中間的なツール出力で親のコンテキストを圧迫するような処理。
- 専門的なレビュー - あるエージェントが生成し、別のエージェントがレビューすることで、レビュアーの推論全体をそのエージェント自身のコンテキストウィンドウ内に保持できます。
些細な呼び出しにサブエージェントは使わないでください。引き継ぎには遅延とトークン消費が伴います。
サブエージェントとエージェントチェーンの違い
サブエージェントは実行時に処理を委任する仕組みで、親がその場で判断します。一方、エージェントチェーンは、固定の順序で実行されるエージェントをあらかじめ定義したグラフです。ルーティングが動的な場合はサブエージェントを、ルーティングが固定されている場合はチェーンを使用してください。
制限
- 親ごとに一覧表示できるサブエージェントは最大 10 件です。
- ルートエージェントからの深さは最大 5 ホップです。
- 1 回の実行で読み込める一意のサブエージェントターゲットは最大 50 件です。
- 1 リクエストあたりに展開できるサブエージェント設定は最大 100 件です。
参照するサブエージェントは、親を実行しているユーザーから参照可能である必要があります。アクセスできない、または削除されたエージェントに解決される参照は、通知なくスキップされます。子が見つからない場合でも適切に処理できるよう、親を設計してください。
