### 3種類の方式におけるやり取りの量とコストの違い
複数の Agent が連携する場合に最もよくある懸念は、**トークンコストが制御不能になるのではないか？** ということです。ポイントは、3種類の方式で「Agent 間で受け渡される内容の量」が異なることです。
| 観点 | ハンドオフ | デリゲート | 自動 |
| -------------------- | ---------------------------------------- | --------------------------------------------------------------------------- | ----------------------- |
| **制御権** | ターゲット Agent に渡り、引き継がれる | 送り元 Agent に残る | その場で AI が決定 |
| **Agent 間で受け渡される内容** | ターゲット Agent は引き継ぎ時に、それまで蓄積された会話の文脈を読み込む | 送り元 Agent はターゲット Agent に「1つのサブタスク」だけを渡すため、範囲が簡潔で明確 | その場の選択によって異なる |
| **トークン／コストの特性** | 会話の長さとハンドオフの回数に応じて増加。同時に動作する Agent は1つだけ | 本来のそのターンに加えて、サブ Agent の処理が1回追加される（LLM 呼び出しが1回増える）が、サブ Agent への入力は簡潔で範囲も制御可能 | 選ばれた方式に準じるため、事前に見積もりにくい |
| **予測可能性** | 中 | 高（タスクの範囲が明確） | 低（状況によって変動） |
{% hint style="success" %}
**コストは制御でき、観測もできます。** チームには複数の安全策が組み込まれています。
* **最大イテレーション数**（デフォルト `25`）：1回の会話で Agent 間が最大何往復できるかを制限し、無限ループを防ぎます。
* **全体のトークン上限**（デフォルト `200000`）：チーム全体が1件のメッセージを処理する際のトークン予算の上限です。
* **タイムアウト秒数**、および各ノードで個別に設定できる**このノードの1メッセージあたりのトークン上限**。
* **コンテキスト戦略**：ノードの〈元のユーザー入力を表示〉をオフにすると、その Agent は会話全体ではなく、上流で整理された要約だけを受け取るため、トークンをさらに節約できます。
* **実行ログ**：実行のたびに合計トークンと**各 Agent のコスト内訳**が記録されるため、どの Agent にどれだけかかったかが一目で分かります（[チーム実行ログ](/maiagent-user-guide/ja/build/teams/traces.md)を参照）。
{% endhint %}
{% hint style="info" %}
**会話は「今だれが対応しているか」を記憶します。** ハンドオフ後は、引き継いだ Agent が、さらに別の Agent へハンドオフが必要だと判断するまで、以降の会話を対応し続けます。次のメッセージが再びエントリポイントに戻って振り分け直されることはありません。
{% endhint %}
## 四、代表的な活用シナリオ
* **EC カスタマーサポートチーム**：振り分け Agent が意図を判断 → 注文／返品・交換／レコメンドの各 Agent に**ハンドオフ**し、各 Agent が自分のナレッジベースとツールで対応します。
* **社内問い合わせ対応**：HR Agent、IT Agent、経理 Agent が、従業員の質問に応じて適切な窓口へ自動的に振り分けます。
* **テクニカルサポートチーム**：L1 Agent が初期調査 → L2 Agent に**デリゲート**して詳細分析 → 結果を L1 に返し、L1 がまとめて回答します。
## 五、仕組み（コンセプト）
Agent Teams は、**1つの有向グラフ**でチームを表現します。
* **ノード（Agent）**：グラフ上の各ノードは既存の Agent で、それぞれ独自のロール指示、ナレッジベース、ツール、モデルを持っています。
* **エントリノード**：チームがメッセージを受け取ると、このノードから会話の処理を開始し、振り分け指示に従って適切なメンバーにハンドオフします。新しく作成したチームには組み込みのエントリノードが自動的に付くため、別途指定する必要はありません。1つのチームにエントリノードは1つだけです。
* **接続線（有向矢印）**：「どのアシスタントから、どんな条件で、どのインタラクション方式で、どのアシスタントに渡すか」を定義します。
* **セーフティガードレール**：チーム全体に、最大イテレーション数、全体のトークン上限、タイムアウト秒数の上限があり、Agent 間の無限の往復を防ぎます。ガードレールによって回答が停止された場合にユーザーに表示されるメッセージはカスタマイズできます（[ガードレールのカスタムメッセージ](/maiagent-user-guide/ja/build/teams/setup.md#guardrail-stop-message)を参照）。
チームを作成すると、システムがそのチームの**エントリ**と対応する **Web Chat 対話プラットフォーム**を自動的に作成するため、対話プラットフォームからチーム全体と直接対話できます。エントリのモデル、振り分け指示、ナレッジベースは、チームキャンバス上で設定します（[エントリの設定](/maiagent-user-guide/ja/build/teams/setup.md#entry-settings)を参照）。
## 六、次のステップ
* チームの作成を始めたい方は、[チームの作成とオーケストレーション](/maiagent-user-guide/ja/build/teams/setup.md)をご覧ください。チームの新規作成、エントリの設定、Agent ノードの配置、接続線によるインタラクション方式の設定、対話の開始方法を説明しています。
* チームの動作を確認したい方は、[チーム実行ログ](/maiagent-user-guide/ja/build/teams/traces.md)をご覧ください。実行ごとにどの Agent を経由したか、それぞれが何トークン使用したか、どれくらい時間がかかったかを確認できます。
{% hint style="info" %}
**前提条件：** Agent Teams は、MaiAgent が貴組織向けに有効化する必要があります。管理画面の〈AI 機能〉配下に〈チーム〉メニューが表示されない場合は、MaiAgent チームまでお問い合わせいただき、有効化をご依頼ください。
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/build/teams.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
