> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# サブエージェントと子セッション：Agent にタスクを並行して進めさせる

> メイン Agent が同じセッション内でサブエージェントを起動して並行して作業させ、すべて完了すると自動で統合される仕組みと、Agent が起動した子セッションのセッション内とサイドバーでの表示と状態を説明します。

複雑なタスクでは、メイン Agent は並行して実行できる部分を任せることができます。AIHubMix Cloud には 2 つの形式があります：

* **サブエージェント**：メイン Agent が**同じセッション内**で起動する補助役です。セッションには進捗の行が 1 行追加されるだけで、作業内容は右側ドロワーのサブエージェントタブで読み取り専用で確認できます。
* **子セッション**：Agent が起動する**独立したセッション**です。各子セッションはサイドバーに独自の行を持ち、親セッションの下にネストされます。個別に開いて承認に対応できます。

どちらも、手動で作成する**フォーク**とは異なります。フォークは通常のセッションです。[メッセージとセッション操作](https://docs.aihubmix.com/jp/cloud/sessions/messages.md) を参照してください。

## 対応環境

| 形態 | 対応状況 | 備考 |
| - | - | - |
| デスクトップアプリ | 対応 | |
| Web アプリ | 対応 | デスクトップアプリと同じです |
| モバイル Web | 対応 | タスク概要カードは自動で開きません。トップバーのボタンから開けます |
| 分割ペイン | 一部対応 | ペインには右側ドロワーとタスク概要カードがなく、サブエージェントの図形はクリックできません |

## サブエージェント

### サブエージェントの名前と図形

各サブエージェントには、起動された順に名前（Coral、Lagoon、Iris、Lime、Amber、Sky。6 つを超えると番号が付きます。たとえば **Coral 2**）と、それに対応する色付きの図形が割り当てられ、セッション内で固定されます。実行中のサブエージェントでは、図形の周りに細い円弧が回転します。

図形は、セッション内のサブエージェントの行、プラン内でそのサブエージェントが担当するステップ、タスク概要カード、ドロワーのタブ、**Changes** のファイルの出所マーカーに表示されます。

### セッションに追加されるのは 1 行だけ

メイン Agent がサブエージェントを起動しても、処理エリアに 1 行が追加されるだけです。同時に起動された複数のサブエージェントは 1 行を共有します。

| 状態 | 行の表示 |
| - | - |
| サブエージェントが実行中 | **Started 4 subagents** + サブエージェントの図形の列 + 件数。たとえば **2 done · 2 running** |
| すべて完了 | **4 subagents done** |
| すべて終了し、一部が失敗または停止 | **4 subagents ended** + **1 failed · 1 stopped** |

図形にカーソルを合わせると「名前 · タスク」が表示され、クリックすると右側ドロワーでそのサブエージェントのタブが開きます。

### サブエージェントはバックグラウンドで実行される

サブエージェントを起動した後、メイン Agent はサブエージェントを待たずに自分の担当部分を続けられます。

* サブエージェントがまだ実行中のままメイン Agent のターンが終了すると、タイマーの行は **Worked for Ns** に変わりますが、処理エリアは**展開されたまま**で、サブエージェントの行は更新され続けます。
* この時点でも、サブエージェントを待たずに引き続きメッセージを送信できます。
* すべてのサブエージェントが終了すると、プラットフォームが自動でメイン Agent に新しいターンを開始させて結果を統合します。タスク概要カードが閉じている場合、トップバーのボタンに緑の点が表示されます。

### サブエージェントタブ

サブエージェントの図形をクリックするか、ドロワーの **+** メニューから選ぶと、右側ドロワーでそのサブエージェントのタブが開きます。タブの内容（上から順に）：

1. 名前、タスク、状態（Queued / Running / Done / Stopped / Failed）。
2. 使用しているモデルと推論レベル、所要時間。
3. メインチャットが渡したタスクの完全な説明。
4. **アクティビティ**：実行した各ステップ。失敗したステップには警告アイコンが付きます。
5. **このサブエージェントの変更**：変更したファイルと追加行数・削除行数。ファイルをクリックすると **Files** で開きます。
6. **結果**（終了後）：メインチャットに返された結論、または停止や失敗の理由の詳細。
7. 下部の **Stop** と **Show in chat**。

| ボタン | 動作 |
| - | - |
| Stop | サブエージェントの実行中に表示されます（あなたのコンピューター上で実行されるセッションでは使えません）。このサブエージェントのみを停止します。完了済みの変更は保持され、他のサブエージェントには影響しません |
| Show in chat | サブエージェントを起動したセッション内の行に移動し、一時的にハイライトします |

* サブエージェントタブは読み取り専用で、そこからメッセージを送ることはできません。作業内容を調整するには、メインチャットで Agent に伝えてください。

### タスク概要カードと Changes での表示

* **タスク概要カード**の **Subagents** セクションには、すべてのサブエージェントとその進捗が表示されます。**Plan** セクションでは、各ステップの右側に担当するサブエージェントが表示されます。カードの詳しい説明については、[エージェントの出力](https://docs.aihubmix.com/jp/cloud/sessions/agent-output.md#task-summary-card) を参照してください。
* **Changes** タブでは、各ファイルに、最後に変更したサブエージェントまたはメイン Agent が示されます。

## 子セッション

**子セッション**は、Agent が起動する独立したセッションです。サイドバーに独自の行を持ち、個別に開いて承認に対応し、停止できます。子セッションがさらに自身の子セッションを起動することもできます。

### 親セッション内の起動カード

Agent が子セッションを起動すると、親セッションに **Spawned N sub-sessions** カードが表示され、子セッションごとに 1 行が続きます。行をクリックすると、その子セッションが開きます。このカードは実行が折りたたまれた後も表示されたままです。

| 子セッションの状態 | 行の末尾の表示 |
| - | - |
| キュー待ち、起動中、実行中 | **Running** |
| あなたの対応待ち | **Needs approval** |
| 最後のターンが失敗した | **Failed** |
| 最後のターンが停止または中断された | **Stopped** |
| 完了、アイドル | **Done** |
| 削除済み | **Sub-session deleted**。クリックできません |

子セッションの各ターンが終了すると、親セッションに注記が表示されます。たとえば **“Check Web settings page regression” finished: 28 checks passed, reported back** や、停止した、失敗した、あなたの対応が必要などの注記です。

### サイドバーの 2 階層

* 子セッションは親セッションの下にネストされます。親セッションの行の末尾にある件数をクリックすると、展開または折りたたみます。
* **表示されるのは最大 2 階層です**：親セッション → 子セッション → 孫セッション。
* 展開すると、実行中やあなたの対応待ちなど、まだ終了していない子セッションはそのまま表示されます。終了したものは **N completed** という 1 行に折りたたまれ、クリックすると展開されます。
* **Pinned** グループでは子セッションは折りたたまれません。行の末尾にある状態のルールは、通常のセッションと同じです。[サイドバー](https://docs.aihubmix.com/jp/cloud/interface/sidebar.md) を参照してください。

### 子セッションには起動元が表示される

子セッションを開くと、トップバーのタイトルの横に **Spawned from “parent session title”** が表示されます。クリックすると親セッションに戻ります。コマンドメニュー（`⇧⌘P`）の **Go to parent chat** も使えます。親セッションが削除された場合は **Spawned from another chat** と表示されます。

### 移動と承認

* 親セッションをプロジェクトに移動すると、その子セッションも一緒に移動します。子セッションを単独で移動することはできません。
* 子セッションでの承認は、通常のセッションと同じように機能します。[対応が必要](https://docs.aihubmix.com/jp/cloud/sessions/user-intervention.md) を参照してください。

## よくある質問

### サブエージェントの実行中もチャットを続けられますか？

続けられます。メイン Agent のターンが終了すれば、引き続きメッセージを送信できます。すべてのサブエージェントが終了すると、メイン Agent が自動で新しいターンを開始して結果を統合します。

### サブエージェントに直接指示を出せますか？

出せません。サブエージェントタブは読み取り専用なので、メインチャットで Agent に伝えてください。サブエージェントを停止するには、そのタブの下部にある **Stop** をクリックします。完了済みの変更は保持されます。

### サブエージェントと子セッションの違いは何ですか？

サブエージェントは同じセッション内で実行され、作業内容は読み取り専用で確認します。子セッションはサイドバーに独自の行を持つ独立したセッションで、個別に開いて承認に対応できます。

### サイドバーに子セッションが表示されないのはなぜですか？

親セッションはデフォルトで子セッションを折りたたんでいます。親セッションの行の末尾にある件数をクリックすると展開されます。終了した子セッションはさらに **N completed** の行に折りたたまれます。

## 関連

* [エージェントの出力](https://docs.aihubmix.com/jp/cloud/sessions/agent-output.md)
* [メッセージとセッション操作](https://docs.aihubmix.com/jp/cloud/sessions/messages.md)
* [右側ドロワー](https://docs.aihubmix.com/jp/cloud/interface/right-drawer.md)
* [サイドバー](https://docs.aihubmix.com/jp/cloud/interface/sidebar.md)
* [対応が必要](https://docs.aihubmix.com/jp/cloud/sessions/user-intervention.md)
* [アクティビティ](https://docs.aihubmix.com/jp/cloud/sessions/activity-log.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.