サブエージェントシステム

概要

サブエージェント（Subagent）は、ワークスペースにおけるタスク分解と委譲のメカニズムです。メイン Agent は、複雑な並列タスクをサブタスクに分割し、専用のサブエージェントを作成して独立して実行させることができます。サブエージェントが完了すると、その結果をメイン Agent に返し、処理を続行します。

システムは 3 種類のサブエージェントタイプに対応しており、最大ネスト深度は 3 段 です。

3 種類のサブエージェントタイプ

自動生成サブエージェント（create_local_sub_agent）

Agent は推論の過程で、現在のタスクに分解が必要だと判断した場合、create_local_sub_agent ツールを 自律的に呼び出して 一時的なサブエージェントを作成します。ユーザーも対話のプロンプトを通じて、Agent にサブエージェントの作成を指示できます。例えば次のようにです：

「関連資料を検索するサブエージェントを 1 つ作成し、さらにドキュメントを作成する別のサブエージェントを作成してください」

作成パラメータ：

実行フロー：

1. メイン Agent がサブエージェントの作成を決定し、タスクを指定する
2. システムが独立した Agent Loop を起動する（デフォルトは最大 50 ラウンド）
3. サブエージェントは独立したツールループを持ち、実行過程は親の対話ウィンドウで確認できる
4. サブエージェントが完了すると、最終結果をメイン Agent に返す
5. メイン Agent が結果に基づいて後続の作業を続行する

事前登録ディスパッチサブエージェント（dispatch_sub_agent）

ユーザーは APP 設定で、特定の構成を持つサブエージェントを 事前に登録 できます。Agent は必要に応じて dispatch_sub_agent ツールを通じて呼び出します。

事前登録されたサブエージェントの記述は、メイン Agent のシステムプロンプトに 自動的に注入 されます。LLM は一致するタスクを認識すると、適切なサブエージェントを自動的に選択します。

設定項目：

管理画面の詳細は サブエージェントの登録と管理 を参照してください。

ノード間ディスパッチ（dispatch_multi_node_agent）

タスクにリモートデバイスのリソースや能力が必要な場合、Agent は dispatch_multi_node_agent ツールを通じて、タスクを 他のノードにディスパッチ して実行させることができます。

ワークフロー：

1. メイン Agent がオンラインノードのリストを確認する（システムプロンプトに注入される）
2. ノードの能力宣言に基づいてターゲットノードを選択する
3. Gateway WebSocket を通じて node.invoke.request を送信する
4. リモートノードが独立した Agent Loop を起動してタスクを実行する
5. 完了後、node.invoke.result を通じて結果を返す

シーン例：

• A のパソコン上の Web 側で対話を開始する
• タスクには B のパソコン上のローカルファイルへのアクセスが必要
• Agent が Gateway を通じてファイル操作のサブタスクを B のパソコンの APP ノードにディスパッチする
• B ノードが実行後に結果を返し、A のパソコン上で対話の表示を続行する

ネスト深度の制御

サブエージェントはネストして作成でき、最大深度は 3 段 です：

                      
                      深度 0: メイン Agent（ユーザーとの対話）
  └── 深度 1: サブエージェント A
        └── 深度 2: サブサブエージェント A-1
              └── 深度 3: 最深層エージェント（これ以上委譲不可）

                    

深度が高いほど自律性は強まりますが、それに応じて Token の消費と実行時間も増加します。

ツール継承のメカニズム

UI 表示

サブエージェントは Work 対話ウィンドウ内で 特別なマーク とともに表示されます：

ユーザーは、どの操作がメイン Agent によって実行され、どの操作がサブエージェントによって実行されたかを明確に確認できます。

対話でサブエージェントを作成する方法

対話の中で自然言語を使って、Agent にサブエージェントの作成を指示できます。以下はいくつかのプロンプト例です：

サブエージェント実行中の画面の読み取り方

費用への影響

サブエージェントの token 消費は 独立して計算 されます：

推奨：サブエージェントは、本当に分解が必要な複雑なタスクに適しています。単純なタスクはメイン Agent に直接処理させればよく、サブエージェントを作成する必要はありません。

サブエージェントを使うべき場合／使わないべき場合

SubAgent は、異なるロールを与えて分業・協働させることは推奨しません。AI の時代においては、協働はむしろ効率と品質を低下させます。時間を節約し提出効率を高めるための並列タスク実行のシーンにより適しています。

関連ドキュメント

• サブエージェントの登録と管理 — 事前登録サブエージェントの設定
• マルチノードアーキテクチャ — ノード間ディスパッチの基盤メカニズム
• Agent ループエンジン — サブエージェントが使用する Agent Loop