> 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/conversations/human-handoff.md).

# 有人対応への引き継ぎ設定

AI アシスタントが必要に応じて対話を有人オペレーターへ引き継ぐための設定について、引き継ぎ条件、案内メッセージ、営業時間、割り当てルール、内部通知まで説明します。

ユーザーの質問が AI アシスタントで対応できる範囲を超えている場合（有人対応を明確に求めている、機密情報に関する問題であるなど）、プラットフォームは対話を有人オペレーターへ引き継ぎ、担当者が管理画面から応答できます。このページでは、有効化と設定の方法を説明します。オペレーターの日常操作については、[有人オペレーターによる引き継ぎと返信](/maiagent-user-guide/ja/conversations/human-handoff/human-handoff-operations.md)を参照してください。

{% hint style="info" %}
Web、社内、LINE、Microsoft Teams など、すべての対話プラットフォームが有人対応への引き継ぎに対応しています。引き継ぎ後のユーザー側の体験はプラットフォームによって異なります。Web と社内プラットフォームではリアルタイムに双方向でやり取りできますが、API プラットフォームにはチャット画面がないため、返信を受信するフロントエンド画面を別途開発する必要があります。
{% endhint %}

## 設定画面 <a href="#where-to-configure" id="where-to-configure"></a>

<mark style="color:blue;">「対話プラットフォーム」</mark>を開き、有効化するプラットフォームを選択して、<mark style="color:blue;">「有人対応への引き継ぎ設定」</mark>タブに切り替えます。設定は、<mark style="color:blue;">引き継ぎ条件</mark>、<mark style="color:blue;">引き継ぎメッセージ</mark>、<mark style="color:blue;">営業時間</mark>、<mark style="color:blue;">割り当て設定</mark>、<mark style="color:blue;">通知</mark>の 5 つのサブタブに分かれています。

## 引き継ぎ条件 <a href="#transfer-conditions" id="transfer-conditions"></a>

<mark style="color:blue;">「有人対応への引き継ぎを有効にする」</mark>をオンにすると、ユーザーからメッセージを受信するたびに、AI が引き継ぎの必要性を判断します。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-0f4d50b4a7b8eb5c56d5a5ca9b36d1cac3b6d224%2Fhandoff-transfer-conditions.png?alt=media" alt="有人対応への引き継ぎ条件の設定画面"><figcaption><p>引き継ぎ条件：有効化スイッチ、判定モデル、条件のクイック挿入</p></figcaption></figure>

判断の基準は<mark style="color:blue;">「ロール指示」</mark>です。「どのような場合に有人対応へ引き継ぐか」を文章で記述すると、<mark style="color:blue;">「判定モデル」</mark>が直近の対話内容を参照して判断します。参照するメッセージ数は<mark style="color:blue;">「参照メッセージ数」</mark>で指定します。

よく使われる次の 4 つの条件を、ワンクリックでロール指示に挿入できます：

* **ユーザーが引き継ぎを要求**：ユーザーが有人オペレーターとの対話を明確に求めています
* **ナレッジベースの範囲外**：質問がナレッジベースの範囲を超えており、AI が適切に回答できません
* **同じ質問を繰り返し、不満を示している**：ユーザーが同じ質問を繰り返し、不満を表しています
* **機密情報**：個人情報の変更、請求、法務など、機密性の高い内容が対話に含まれています

{% hint style="info" %}
AI による自動判定に加えて、カスタマーサービス管理者は「すべての対話」からいつでも任意の対話を手動で引き継げます。この操作は引き継ぎ条件の制限を受けません。
{% endhint %}

## 引き継ぎメッセージ <a href="#transfer-messages" id="transfer-messages"></a>

引き継ぎ処理の各段階でユーザーに送信する案内メッセージをカスタマイズできます。空欄にすると送信されません：

| メッセージ       | 送信タイミング               | 使用可能な変数                                   |
| ----------- | --------------------- | ----------------------------------------- |
| 引き継ぎ通知メッセージ | 有人対応への引き継ぎが発生したとき     | —                                         |
| 待機案内        | ユーザーが待機列に入ったとき        | `{position}` 待機順位、`{wait_time}` 推定待ち時間（分） |
| 引き継ぎ完了案内    | オペレーターが正常に割り当てられた後    | `{agent_name}` オペレーター名                    |
| 待機列上限通知     | 待機人数が上限に達したとき         | —                                         |
| タイムアウト通知    | 待機がタイムアウトして AI に戻ったとき | —                                         |

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-bfb296d7c058394b5742f475287a28dc58473989%2Fhandoff-transfer-messages.png?alt=media" alt="引き継ぎメッセージの設定画面"><figcaption><p>引き継ぎメッセージ：各段階の案内メッセージと使用可能な変数</p></figcaption></figure>

## 営業時間 <a href="#service-hours" id="service-hours"></a>

<mark style="color:blue;">「営業時間を有効にする」</mark>をオンにすると、有人対応への引き継ぎは設定した時間帯にのみ動作します。<mark style="color:blue;">タイムゾーン</mark>と曜日ごとの営業時間を設定でき、<mark style="color:blue;">「月曜日～金曜日 09:00～18:00」</mark>を使ってすばやく適用することもできます。

営業時間外に有人対応への引き継ぎが発生した場合、<mark style="color:blue;">「オフライン時の動作」</mark>に基づいて処理されます：

* **オフラインメッセージを表示**：引き継ぎを行わず、オフラインメッセージを送信して今回の応答を終了します。その後の一般的な質問には AI が引き続き回答します
* **メッセージを受け付ける**：オフラインメッセージを表示し、対話を「未割り当て」の待機列に追加します。営業時間になったらオペレーターが対応します

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-797fb69be8d3c084b426603c9b179399f5413cf9%2Fhandoff-service-hours.png?alt=media" alt="営業時間の設定画面"><figcaption><p>営業時間：曜日ごとの時間帯とオフライン時の動作</p></figcaption></figure>

## 割り当て設定 <a href="#dispatch-settings" id="dispatch-settings"></a>

### 対応可能なオペレーターの選択 <a href="#assignable-members" id="assignable-members"></a>

<mark style="color:blue;">「割り当て可能なオペレーター」</mark>で、このプラットフォームを担当するメンバーを選択します。自動割り当てでは、次の条件を**すべて満たす**メンバーだけが対象になります：

1. 割り当て可能なメンバーの一覧に含まれていること
2. アカウントが有効であり、この対話プラットフォームのカスタマーサービス権限を持っていること
3. 対応中の対話数が「オペレーター 1 人あたりの同時対応数」の上限に達していないこと

### ルーティングモデル <a href="#routing-model" id="routing-model"></a>

* **ラウンドロビン（Round Robin）**：オペレーターへ対話を順番に均等配分します
* **最小負荷優先（Least Active）**：現在対応している対話数が最も少ないオペレーターを優先します

### 対応数と待機列の設定 <a href="#capacity-and-queue" id="capacity-and-queue"></a>

| 設定                  | 説明                                                      |
| ------------------- | ------------------------------------------------------- |
| オペレーター 1 人あたりの同時対応数 | 1 人のオペレーターが同時に対応できる対話数の上限です。上限に達すると、新しい対話は割り当てられません     |
| 待機タイムアウト            | この時間を超えてもオペレーターが引き継がない場合、自動的に AI の応答へ戻り、タイムアウト通知が送信されます |
| 待機列の上限              | 待機中の対話の最大数です。待機列が満杯の場合、新しい引き継ぎリクエストはスキップされます            |

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-e3188794a19f2825351be430f7cf06b8444fae58%2Fhandoff-dispatch-routing.png?alt=media" alt="割り当て設定画面"><figcaption><p>割り当て設定：ルーティングモデル、タグルーティング、対応数、タイムアウトの設定</p></figcaption></figure>

{% hint style="info" %}
**「オペレーターが自分で引き継ぐ」方式に変更しますか？** 「割り当て可能なオペレーター」の一覧を空にしてください。有人対応へ引き継がれたすべての対話が「未割り当て」の一覧に残り、オペレーターが「自分が対応」をクリックして引き継げます。自動では割り当てられません。
{% endhint %}

### タグルーティング <a href="#tag-routing" id="tag-routing"></a>

<mark style="color:blue;">「タグルーティングを有効にする」</mark>をオンにすると、対話タグに関連付けられたメンバーへ対話が割り当てられます。たとえば、「請求」タグが付いた対話は請求担当チームのメンバーへ割り当てられます。使用する前に、対話タグを作成してメンバーにタグを割り当ててください。また、引き継ぎ時に対話へ自動的にタグが付くよう、「対話分析」を有効にすることをおすすめします。タグにメンバーが関連付けられていない場合は、通常の割り当てロジックにフォールバックします。

### オペレーターの作業負荷 <a href="#agent-workload" id="agent-workload"></a>

ページ下部の<mark style="color:blue;">「オペレーターの作業負荷」</mark>パネルには、各オペレーターの対応中件数、解決済み件数、ステータス（割り当て可能／上限到達）と、現在待機中の対話数がリアルタイムで表示されます。管理者は現場の負荷を把握できます。

## 通知 <a href="#notifications" id="notifications"></a>

対話がオペレーターに割り当てられると、<mark style="color:blue;">「通知センターのお知らせ」</mark>と<mark style="color:blue;">「Email 通知」</mark>により、割り当て先と CC 通知対象（上司など）へ通知されます。通知テンプレートはカスタマイズできます。詳しい設定手順、テンプレート変数、よくある質問については、[有人対応への引き継ぎ通知](/maiagent-user-guide/ja/conversations/human-handoff/handoff-notification.md)を参照してください。

{% hint style="warning" %}
通知は「対話がオペレーターに割り当てられたとき」に送信されます。メッセージ受付方式または引き継ぎ方式を使用し、対話が「未割り当て」の待機列に残っている段階では、Email 通知は送信されません。オペレーターが「未割り当て」の一覧を定期的に確認できる運用を整えてください。
{% 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 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/conversations/human-handoff.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.
