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

# Agent チーム

> 複数の Agent をチームに編成し、それぞれに役割を持たせて、同一セッション内で協調させる

CowAgent は単一の Agent にとどまりません。複数の Agent を作成してチームを組めます。各メンバーは自分の役割・モデル・Skill・ナレッジを持ち、それぞれ独立して働くことも、同じセッションに呼び出されて一緒に協調することもできます。

<img src="https://cdn.jsdelivr.net/gh/zhayujie/cowagent-assets@main/screenshots/en/team-overview.png" alt="Multi-agent team" width="800" />

## チームが必要な理由

複数の専門 Agent からなるチームは、異なる業務領域にまたがる複雑なタスクの処理に適しています。理由は次のとおりです：

* **コンテキストの集中**：1 つの Agent に役割を詰め込みすぎると、無関係なコンテキストを大量に抱え込み、精度が落ちてトークンコストも上がります。領域ごとに分割すれば、各 Agent のコンテキストはより集中し、回答は正確に、コストは低くなります。
* **異なる能力の協調**：各 Agent に異なるモデルと Skill を割り当て、分業・協調・相互レビューを通じて、単一の Agent では難しい複雑なタスクを完遂できます。
* **データと権限の分離**：各 Agent は独立したワークスペースを持ち、メモリ・セッション・生成物のファイルは互いに見えません。役割ごと、あるいは顧客ごとに境界を引く用途に適します。
* **見せ方の向上**：異なるチャネル、または同一チャネルの異なるインスタンスに別々の Agent を接続し、それぞれ独立したアシスタントとして見せられます。チーム全体を 1 つのチャネルに接続して協調的に応答させることもでき、デジタル従業員のチームを手軽に構築できます。

単一の Agent のみを使うユーザーにとって体験は変わりません。チーム関連の機能は、2 つ目の Agent を作成してから現れます。

## Agent の作成

Web コンソールまたはデスクトップクライアントの「智能体团队（Agent チーム）」ページで「作成」をクリックすると、Agent を追加できます。1 つの Agent は次の要素で構成されます：

* **名前とアバター**：チーム内の識別子で、チャットの吹き出し・メンバー一覧・チャネルの紐づけ箇所に表示されます。
* **役割**：この Agent が何を担当するかを一文で表します。メンバーを見分けるのに役立つほか、協調時にタスクを誰へ渡すかの判断にも使われます。
* **デフォルトモデル**：この Agent に個別にモデルを指定できます。デフォルト Agent はグローバル設定に従います。
* **Skill とナレッジ**：チームと共有することも、Agent 専用のナレッジベースを持たせて互いに影響させないこともできます。
* **既存の Agent から複製**：新規作成時に、既存の Agent の設定・Skill・ナレッジを複製して出発点にできます。

<img src="https://cdn.jsdelivr.net/gh/zhayujie/cowagent-assets@main/screenshots/en/agent-create.png" alt="Agent-create" width="800" />

作成すると、Agent はチーム一覧に表示されます。任意のメンバーをクリックすると、右側で「概要 / Skill / コアファイル」を切り替えて、基本情報・有効な Skill・ペルソナとルールのファイル（`AGENT.md`、`RULE.md` など）をそれぞれ設定できます。

<Note>
  チームには常にデフォルト Agent が 1 つ存在します。新しいセッションなどのフォールバック先であり、グローバルのモデル設定に従い、削除できません。
</Note>

### ナレッジベース：共有か独立か

デフォルト以外の各 Agent は、ナレッジベースのモードを選べます：

* **共有**：チームと同じナレッジベースを読み書きします。全員が同じ資料を扱う場面に適します。
* **独立**：専用のナレッジベースを持ち、他のメンバーと影響し合いません。領域ごとに資料が大きく異なる場面に適します。

2 つのモードはいつでも切り替えられ、共有に戻す際も独立ベースの内容は保持されます。

## セッションへの参加とグループチャット

セッションを新規作成する際、単一の Agent と対話することも、グループチャットを開始して複数の Agent を参加させることもできます。

既存のセッションでは、入力欄の左下にある Agent セレクターから次のことができます：

* **Agent の切り替え**：空のセッションは対話する Agent を直接切り替えられます。内容のあるセッションでは新しい Agent で新たな対話を開始し、既存の履歴は元の Agent に帰属したままです。
* **メンバーの追加**：他の Agent を現在のセッションに追加し、グループチャットに変えます。
* **メンバーの削除**：メンバーを現在のセッションから外します。

<img src="https://cdn.jsdelivr.net/gh/zhayujie/cowagent-assets@main/screenshots/en/agent-group-session.png" alt="Agent-team-group" width="800" />

グループチャットでは、各 Agent がそれぞれ設定されたモデルで応答し、吹き出しにどの Agent が発言しているかが表示されます。同じセッションのメンバーは同一の記録を読み、他の人の発言を確認できます。

<Note>
  グループチャットではセッション単位のモデル選択を使いません。各 Agent はそれぞれ設定されたデフォルトモデルを使うため、グループチャットにモデルセレクターは表示されません。
</Note>

## チャネル連携

同じ種類のチャネルを複数インスタンス起動でき、各インスタンスに別々の単一 Agent または Agent チームを紐づけて、それぞれ独立したアシスタントとして見せられます。

「チャネル」ページで、接続済みのインスタンスに紐づける Agent を設定します：

* 最初に選んだものがオーナー（owner）で、このチャネルのすべてのタスクを受け取ります。
* さらにメンバーを追加でき、オーナーはメンバーの役割に応じて、適したタスクを割り当てて処理させます。
* チャネル内で `@` にメンバーの名前または ID を続けると、そのメンバーと直接対話できます。

<img src="https://cdn.jsdelivr.net/gh/zhayujie/cowagent-assets@main/screenshots/en/channel-config.png" alt="Agent-team-channel" width="800" />

紐づけの変更は即時に反映され、チャネルを再起動する必要はありません。複数インスタンスに対応するチャネルには、WeChat、WeCom スマートボット、DingTalk、Feishu、QQ、Telegram、Slack、Discord などがあります。

## 協調の仕組み

同じセッション内の複数の Agent は、2 つの方法で協調します。

### 1. @ で Agent を指名する

グループチャットでは、`@` にメンバーの名前を続けると、そのターンを指名した Agent に回答させられます。`@` を入力すると現在のセッションのメンバーが候補として表示され、送信後は吹き出しに指名した Agent のアバターが付き、そのターンの担当を示します。

<img src="https://cdn.jsdelivr.net/gh/zhayujie/cowagent-assets@main/screenshots/en/agent-group-chat-demo.png" alt="Agent-team-group" width="800" />

### 2. リード Agent と委譲

グループチャットには常にリード Agent（オーナー）がいて、ユーザーが他の誰かを `@` しない限り、すべてのタスクを受け取ります。委譲は、リード Agent が自分の領域外のタスクを、より適したメンバーに引き渡す仕組みです：

* **判断**：リード Agent はタスクを受け取ると自動で判断し、自分の領域なら直接回答し、そうでなければセッション内のより適したメンバーに転送します。
* **実行**：委譲されたメンバーは自分のワークスペースでタスクを完了し、結果をリード Agent に返します。
* **返信**：リード Agent が結果をまとめてユーザーに返信し、ユーザーは常に単一の窓口に向き合います。

委譲の範囲・チェーンの深さ・時間予算といった詳細は [agent\_delegate ツール](/ja/tools/delegate)が担い、設定で調整できます。

<img src="https://cdn.jsdelivr.net/gh/zhayujie/cowagent-assets@main/screenshots/en/agent-delegate.png" alt="Agent-team-delegate" width="800" />

## サブ Agent との違い

Agent チームと[サブ Agent](/ja/multi-agent/subagent) はどちらも作業を分担できますが、位置づけが異なります：

|          | チームメンバー                        | サブ Agent                     |
| -------- | ------------------------------ | ---------------------------- |
| ライフサイクル  | 常駐、事前に設定                       | 1 つのタスクのために一時的に作成し、使い終わったら破棄 |
| アイデンティティ | 名前・アバターを持ち、チーム一覧に表示、チャネルに紐づけ可能 | 匿名、一覧には現れない                  |
| ワークスペース  | 独立                             | リード Agent と共有                |
| メモリ      | 独立                             | 自分のメモリを持たない                  |
| 適した場面    | 長期的な専門分業、対外サービス                | 自分の作業を分割して並行実行、大量の中間過程を隔離    |

> ひとことでまとめると：タスク自体が別の常駐 Agent（対応するナレッジ・権限・顧客関係を持つ Agent）に帰属する場合はチーム協調を、自分のタスクを分割して並行実行し処理を速めたいだけの場合はサブ Agent を使います。
