サブエージェントの登録と管理
概要
SubAgent ページ（Settings → GWork Settings → SubAgent）では、特定の設定を持つサブエージェントを事前登録します。事前登録されたサブエージェントはメイン Agent のシステムプロンプトに自動的に注入され、メイン Agent は該当するタスクに遭遇したとき（dispatch_sub_agent を介して）タスクを委任します。
サブエージェントを作成するまで、ページには 「No sub-agents registered yet」 と表示されます。
dispatch_sub_agentツールは、少なくとも 1 つのサブエージェントが存在する場合にのみメイン Agent で有効になります。
サブエージェントの設定
+ SubAgent をクリックすると Create sub-agent フォームが開きます：
| フィールド | 説明 | 必須 |
|---|---|---|
| ID | 一意の識別子。例：code-reviewer |
はい |
| Name | 表示名。例：Code Reviewer |
はい |
| Description | サブエージェントの役割。メイン Agent はこれを読んで委任するかどうかを判断するため、正確かつ簡潔に記述してください | はい |
| System prompt | 委任時に読み込まれ、サブエージェントのアイデンティティとなります。タスクの品質に直接影響します | はい |
| Max turns | 1 回の委任あたりの最大ループターン数。空欄の場合はアプリのデフォルト（50）が使われます | いいえ |
| Can spawn sub-agents | このサブエージェントがさらにサブエージェントを作成できるかどうか | いいえ（デフォルトでオン） |
Save をクリックして登録します。サブエージェントは、タスクのコンテキストで別途指定がない限り、メイン Agent のモデルとツールを継承します。
管理操作
| 操作 | 説明 |
|---|---|
| + SubAgent | 新しい事前登録サブエージェントを作成します |
| Edit | 既存のサブエージェントを開き、設定を変更します |
| Delete | 事前登録されたサブエージェントを削除します |
対話との関わり
- システムプロンプトへの注入：各サブエージェントの Name と Description がメイン Agent のシステムプロンプトに列挙されます
- 自動マッチング：メイン Agent はタスクの意味に基づいて適切なサブエージェントを選択します
- 手動呼び出し：メッセージ内でサブエージェントの名前を指定して、明示的に依頼できます
サブエージェントの実行は、ここで設定する Max turns と、Settings → Task Control の Sub-agent timeout (minutes)（デフォルト 30 分。サブエージェントがキャンセルされても完了済みの作業は保持されます）によって制限されます。
ユースケースの例
| サブエージェント | 説明 | 主なツール |
|---|---|---|
| Code Reviewer | コードの正確性、性能、セキュリティをレビューする | Read file、Search in files、Find files |
| Document Writer | ドキュメントを執筆し、整形する | Write file、docx / pptx スキル |
| Research Assistant | 情報を検索・収集する | Browser、web-search スキル |
| Data Analyst | データを処理・分析する | Run command、Read file、Write file |
操作ガイド：事前登録サブエージェントの作成
- アプリ → ⚙ Settings → SubAgent を開きます
- + SubAgent をクリックします
- 以下を入力します：
- ID：
code-reviewer - Name：
Code Reviewer - Description：「コードの正確性、性能、セキュリティをレビューします。多言語のコード分析が得意です。」
- System prompt：「あなたはシニアコードレビュアーです。コードの正確性、性能、セキュリティ、保守性を分析してください。各問題について深刻度（低 / 中 / 高）と修正案を示してください。」
- ID：
- （任意）Max turns を設定し（例：30）、さらなる委任が不要であれば Can spawn sub-agents をオフにします
- Save をクリックします
委任の深さが与える実際の影響
| 設定 | 意味 | コストへの影響 |
|---|---|---|
| Can spawn sub-agents: オフ | サブエージェントは下位のサブエージェントを作成できません | 低 |
| Can spawn sub-agents: オン | サブエージェントはさらに委任できます | 高 — 各階層が独自の Agent Loop を実行し、独自のトークン / クレジットを消費します |
注意：サブエージェントの各階層は独立した Agent Loop（デフォルト 50 ターン）を開始します。深い委任は 1 つのタスクのコストを何倍にも増やす可能性があります。単純な専門ロールでは委任をオフにしておいてください。
事前登録と自動作成：どちらを選ぶか
| 比較項目 | 事前登録（dispatch_sub_agent） |
自動作成（create_local_sub_agent） |
|---|---|---|
| 設定 | 事前に一度設定すれば完了 | Agent が必要に応じてその都度一時的に作成 |
| 一貫性 | 毎回同じ設定を使用し、結果が安定 | Agent が毎回異なるアイデンティティやツールを割り当てる可能性がある |
| 適したシナリオ | 頻繁に繰り返し使う専門ロール | 一回限りの一時的なタスク分解 |
| システムプロンプト | メイン Agent に自動注入され、Agent は利用可能であることを認識 | 作成するかどうかは Agent が自ら判断 |
推奨：特定の種類のタスク（コードレビュー、ドキュメント執筆、データ分析など）が頻繁に必要な場合は、事前登録サブエージェントを作成してください。たまに発生する一時的なタスク分解であれば、Agent に自動作成させるだけで十分です。