> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/teams/setup.md).

# チームの作成と編成

チームの新規作成、キャンバスへのアシスタントノードのドラッグ、エッジの設定とインタラクション方式（自動／ハンドオフ／デリゲート）、エントリノードの指定、セーフガードの設定から対話開始までの完全な手順です。

このページでは、ゼロから Agent Team を作成する方法を説明します。チームの新規作成、キャンバスへのアシスタントの追加、エッジとインタラクション方式の設定、エントリノードの指定、そしてチーム全体との対話開始までの手順です。

{% hint style="info" %}
**チームに参加させる AI アシスタントを事前に準備してください。** チーム内の各ノードは既存の AI アシスタントです。まず〈AI アシスタント〉で各専門分野のアシスタント（例：振り分け、注文、返品・交換アシスタント）を作成してから、こちらに戻ってチームに編成してください。
{% endhint %}

## <mark style="color:blue;">一、チームの新規作成</mark> <a href="#create-team" id="create-team"></a>

### 1. チーム一覧に移動 <a href="#team-list" id="team-list"></a>

左側メニューから <mark style="color:blue;">AI 機能</mark> →〈<mark style="color:blue;">チーム</mark>〉に移動します。一覧には現在の組織のすべてのチームが表示され、**チーム名、エージェント数、ステータス**などの情報が含まれます。右上の検索でチームを検索できます。

### 2. チームの作成 <a href="#new-team" id="new-team"></a>

右上の <mark style="color:blue;">チームを新規作成</mark> をクリックし、**チーム名**（必須）と**説明**を入力して作成します。

{% hint style="success" %}
作成が成功すると、システムが自動的にこのチーム用の**エントリアシスタント**と対応する **Web Chat 対話プラットフォーム**を作成します。これにより、後からチーム全体と直接対話できるようになります。
{% endhint %}

## <mark style="color:blue;">二、キャンバスでチームを編成</mark> <a href="#compose-canvas" id="compose-canvas"></a>

チームに入ると、デフォルトで <mark style="color:blue;">キャンバス編成</mark> ビューが表示されます。画面は3つのエリアに分かれています：左側の〈**アシスタント一覧**〉、中央の**キャンバス**、右側の**設定パネル**（ノードまたはエッジをクリックすると表示）。

{% hint style="warning" %}
**キャンバス編成はデスクトップブラウザでの操作を推奨します。** スマートフォンなどの小さな画面では、キャンバス編成エリアにメッセージが表示されますので、デスクトップで編成を完了してください。
{% endhint %}

### 1. アシスタントノードの追加 <a href="#add-nodes" id="add-nodes"></a>

左側の〈アシスタント一覧〉から追加したいアシスタントを見つけ、**キャンバスにドラッグ**するか、**クリック**して追加します。既にチームに参加しているアシスタントには〈チームに参加済み〉と表示され、クリックするとキャンバス上の対応するノードに移動します。アシスタントが多い場合は上部の検索ボックスでフィルタリングできます。

各ノードにはアシスタント名、使用しているモデル、<mark style="color:blue;">Agent</mark> または <mark style="color:blue;">RAG</mark> モードが表示され、識別しやすくなっています。

{% hint style="info" %}
ノードの位置が乱雑な場合は、キャンバス上の <mark style="color:blue;">自動レイアウト</mark> をクリックしてシステムにレイアウトを整理させることができます。ノードの位置は自動的に保存されます。
{% endhint %}

### 2. ノードの設定 <a href="#node-settings" id="node-settings"></a>

ノードをクリックすると、右側に〈**ノード設定**〉が表示されます。調整できる項目：

| 設定                   | 説明                                                                                                                                    |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **エントリノード**          | オンにすると、チームがメッセージを受信した際にこのノードから対話の処理を開始します。**1つのチームにはエントリノードが1つだけです。**                                                                 |
| **1回の呼び出しごとのトークン上限** | このノードの1回のレスポンスのトークン量を制限します（任意）。                                                                                                       |
| **最大イテレーション回数**      | このノードの1回の処理のイテレーション回数を制限します（任意）。                                                                                                      |
| **コンテキスト戦略**         | このアシスタントが何を見られるかを制御します：〈**元のユーザー入力を表示**〉はユーザーの元のメッセージを読めるかどうかを決定します（オフの場合、上流アシスタントが整理した出力のみが見えます）。〈**表示する出力元**〉はどのノードの出力が見えるかを指定できます。 |

### 3. エッジの作成とインタラクション方式の設定 <a href="#add-edges" id="add-edges"></a>

あるノードの接続ポイントから別のノードにドラッグして、**有向エッジ**（ソース → ターゲット）を作成します。エッジをクリックすると、右側に〈**エッジ設定**〉が表示されます。

| 設定                    | 説明                                                                            |
| --------------------- | ----------------------------------------------------------------------------- |
| **トリガー条件の説明**         | 「いつこのエッジを通るか」を平易な言葉で記述します。この説明は AI の判断基準として提供されるため、明確に記述するほどルーティングがより正確になります。 |
| **インタラクション方式**        | 〈**自動**〉〈**ハンドオフ**〉または〈**デリゲート**〉を選択します（3つの違いは下表を参照）。                         |
| **ソース Agent のツールを継承** | オンにすると、ターゲットアシスタントがソースアシスタントのすべてのツールとリソースを使用できます。                             |

**インタラクション方式**（設定パネルでの各オプションの説明）：

| インタラクション方式    | 説明                                              |
| ------------- | ----------------------------------------------- |
| **自動（デフォルト）** | LLM が最適なインタラクション方式を自動判断します。                     |
| **ハンドオフ**     | 制御権をハンドオフ——ソースエージェントが休止し、ターゲットエージェントが対話を引き継ぎます。 |
| **デリゲート**     | タスクをデリゲート——ターゲットエージェントが実行後、結果をソースに返却します。        |

{% hint style="info" %}
**キャンバス上部のセマンティック警告に注意してください。** チームグラフに問題がある場合、キャンバス上部に黄色い通知が表示されます。例：〈エントリノードが設定されていません〉〈エントリノードが複数あります。1つだけにしてください〉〈重複するエッジがあります〉〈エッジが循環しています〉。対話を開始する前にこれらの警告を解消することを推奨します。
{% endhint %}

## <mark style="color:blue;">三、基本情報とセーフガードの設定</mark> <a href="#settings-guardrails" id="settings-guardrails"></a>

チームページで〈**基本情報**〉ビューに切り替えると、チームレベルの設定を調整できます：

* **基本情報**：チーム名、説明、有効化の有無。
* **セーフガード**：
  * **最大イテレーション数**（デフォルト `25`）——1回の対話中にアシスタント間で最大何回やり取りできるかを制限し、無限ループを防ぎます。
  * **全体トークン上限**（デフォルト `200000`）——チーム全体で1つのユーザーメッセージを処理する際のトークン予算上限です。
  * **タイムアウト秒数**（デフォルト `600`）——チーム全体の処理フローの強制タイムアウトです。

## <mark style="color:blue;">四、チームとの対話</mark> <a href="#talk-to-team" id="talk-to-team"></a>

編成が完了し、チームが〈有効〉であることを確認したら、チームの **Web Chat 対話プラットフォーム** を通じてチーム全体と対話できます。ユーザーは1つのエントリのみに向き合い、システムが自動的に適切なアシスタントに問題をルーティングします。

チームがアシスタント間でハンドオフまたはデリゲートを行う際、対話インターフェースに切り替え通知が表示されます。例：〈**ハンドオフ中**〉〈**デリゲート中**〉〈**切り替え中**〉。これにより、ユーザーは現在どのアシスタントが対応しているかを把握できます。

## <mark style="color:blue;">五、チームの削除</mark> <a href="#delete-team" id="delete-team"></a>

〈基本情報〉ビューの最下部にある危険ゾーンで〈**チームを削除**〉できます。削除するとこのチームのエントリアシスタントも併せて削除され、**この操作は元に戻せません**のでご確認の上実行してください。

## <mark style="color:blue;">六、次のステップ</mark> <a href="#next" id="next"></a>

チームの運用を開始したら、[チーム実行記録](/maiagent-user-guide/ja/teams/traces.md) で各実行がどのアシスタントを経由したか、それぞれのトークン消費量、所要時間を確認し、チームが期待通りに分業しているかを確認できます。


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/teams/setup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.