> 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/serve/copilot.md).

# カスタマーサービス Copilot

サポート Copilot：会話プラットフォームで AI Copilot を有効にし、Agent がお客様のメッセージへの返信候補を作成します。有人のサポート担当者が内容を確認・編集してから送信します。

サポート Copilot は、Agent が裏側で有人のサポート担当者の返信案を作成する機能です。お客様からメッセージが届くと、AI が「AI 候補」を1件生成します。この候補はサポート担当者だけに表示され、そのまま送信することも、編集してから送信することも、AI に再生成を依頼することもできます。AI を導入しつつも、すべての返信を人が確認したいサポートチームに適しています。

AI 候補は、会話プラットフォームに紐づけられた Agent が生成します。その Agent のロール指示、ナレッジベース、ツールが使われるため、品質は AI が直接返信する場合と同じです。

このページは2つのパートで構成されています。[AI Copilot を有効にする](#enable-copilot) は、構築担当者が MaiAgent Build の会話プラットフォーム設定で行います。[サポート担当者の使い方](#use-suggestions) では、会話の中で AI 候補を生成、編集、送信する方法を説明します。

{% hint style="info" %}
AI 候補がお客様側に送信されることはありません。サポート担当者が送信ボタンを押した後にのみ、その内容がサポート担当者の名義でお客様に届きます。
{% endhint %}

## 利用できる人 <a href="#permissions" id="permissions"></a>

| 操作                   | 必要な権限                                                                                  |
| -------------------- | -------------------------------------------------------------------------------------- |
| AI Copilot のオン／オフや調整 | <mark style="color:blue;">会話プラットフォーム権限</mark>、かつ該当の会話プラットフォームに対する編集権限                  |
| 会話内での AI 候補の生成・送信    | <mark style="color:blue;">すべての会話権限</mark>、かつ所属ロールが該当の会話プラットフォームに紐づく Agent に割り当てられていること |

ロールと権限の設定方法は [ロール権限管理](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-permission.md) をご覧ください。

## AI Copilot を有効にする <a href="#enable-copilot" id="enable-copilot"></a>

<mark style="color:blue;">AI Copilot</mark> は会話プラットフォームの設定ページにあるタブで、会話プラットフォームごとに設定します。設定ページの構成は [会話プラットフォーム設定の概要](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings.md#tab-map) をご覧ください。ウェブサイト、LINE、Messenger、Instagram、Telegram、Microsoft Teams、WhatsApp、Email、Slack、LINE WORKS、Team+、Viber などのプラットフォームにこのタブがあります。

{% stepper %}
{% step %}

### 会話プラットフォームの設定を開く <a href="#open-inbox-settings" id="open-inbox-settings"></a>

左側のメニューから <mark style="color:blue;">カスタマーサポート会話</mark> → <mark style="color:blue;">会話プラットフォーム</mark> を開き、一覧から設定したいプラットフォームを見つけて <mark style="color:blue;">編集</mark> をクリックします。そのほかの開き方は [設定ページを開く](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings.md#open-settings) をご覧ください。
{% endstep %}

{% step %}

### AI Copilot タブに切り替える <a href="#open-copilot-tab" id="open-copilot-tab"></a>

<mark style="color:blue;">AI Copilot</mark> タブを選択します（ウェブサイトのプラットフォームでは、左側ナビゲーションの <mark style="color:blue;">高度な機能</mark> グループにあります）。このタブはプラットフォームの作成が完了した後にのみ表示されます。
{% endstep %}

{% step %}

### オンにしてトリガーモードを選ぶ <a href="#choose-trigger-mode" id="choose-trigger-mode"></a>

<mark style="color:blue;">AI Copilot を有効にする</mark> をオンにし、<mark style="color:blue;">トリガーモード</mark> で候補を生成するタイミングを選んで、最後に <mark style="color:blue;">保存</mark> をクリックします。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-a960a8ebd0a93441c17f2248a1693cf0681377e1%2Fcopilot-settings-tab.png?alt=media" alt="会話プラットフォーム設定ページの AI Copilot タブ：AI Copilot を有効にするスイッチがオンで、トリガーモードは手動が選択されている"><figcaption><p>AI Copilot タブ：オンにしてトリガーモードを選び、保存を押します</p></figcaption></figure>
{% endstep %}
{% endstepper %}

### 2つのトリガーモード <a href="#trigger-modes" id="trigger-modes"></a>

| モード                                          | 候補が生成されるタイミング                                 | Agent がお客様に直接返信するか                |
| -------------------------------------------- | --------------------------------------------- | --------------------------------- |
| <mark style="color:blue;">手動</mark>          | サポート担当者が会話内でお客様のメッセージの横にあるロボットアイコンをクリックしたときのみ | 従来の設定どおりに動作し、Copilot は自動返信に影響しません |
| <mark style="color:blue;">受信したメッセージごと</mark> | お客様のメッセージを受信するたびに自動で生成                        | 返信しません。候補を送信するかどうかはサポート担当者が決めます   |

{% hint style="warning" %}
「受信したメッセージごと」を選ぶと、Agent はお客様に自動返信しなくなり、[有人サポートへの引き継ぎ設定](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/human-handoff.md) に基づく自動転送も行われなくなります。お客様のメッセージはすべてサポート担当者が対応する必要があるため、すぐに返信できる人員が確保できていることを確認してから、このモードに切り替えてください。
{% endhint %}

## サポート担当者の使い方 <a href="#use-suggestions" id="use-suggestions"></a>

<mark style="color:blue;">カスタマーサポート会話</mark> → <mark style="color:blue;">すべての会話</mark> で会話を開きます。AI Copilot が有効なプラットフォームでは、お客様のメッセージごとの下にロボットアイコンが表示され、マウスを重ねると <mark style="color:blue;">AI 候補を生成</mark> と表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-ee2f412f4312999a27932a7b4b29f762a9d64981%2Fcopilot-generate-icon.png?alt=media" alt="サポート会話で、お客様のメッセージの下にあるロボットアイコン。マウスを重ねると AI 候補を生成と表示される"><figcaption><p>お客様のメッセージの下のロボットアイコン：クリックすると AI 候補を生成します</p></figcaption></figure>

1. **候補を生成する**：ロボットアイコンをクリックすると、メッセージの下に <mark style="color:blue;">AI 候補</mark> カードが表示され、内容が1文字ずつ表示されます。「受信したメッセージごと」モードでは自動で生成されるため、クリックは不要です。別のバージョンが必要な場合は、アイコンをクリックして再度生成できます。
2. **内容を確認する**：AI がナレッジベースの内容を引用した場合、カードには引用元も表示されるため、サポート担当者が照合できます。カードのタイトル行をクリックすると、内容を折りたたんだり展開したりできます。
3. **送信または編集する**：
   * <mark style="color:blue;">送信</mark>：候補の内容をそのままお客様に送信します。サポート担当者が入力欄からメッセージを送信した場合と同じ結果になります。
   * <mark style="color:blue;">編集</mark>：候補の内容を下の入力欄に入れ、修正してから自分で送信します。入力欄にすでにあった文字は置き換えられます。
4. **再生成する**：カード右上の更新アイコン（<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-d8c2aea0752d0fcc0f95e2eb0d19a47bfc24d438%2Fcopilot-suggestion-versions.png?alt=media" alt="AI 候補カード：タイトル行に準備完了のステータスと 2 / 2 のバージョン切り替えが表示され、右上に再生成と折りたたみのアイコン、右下に編集と送信のボタンがある"><figcaption><p>AI 候補カード：ステータス「準備完了」、バージョン切り替え「2 / 2」、再生成アイコン、編集と送信</p></figcaption></figure>

返信の送信方法と引き継ぎのルールは [有人サポートの引き受けと返信](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/daily-operations/human-handoff-operations.md) をご覧ください。

### バージョンを切り替える <a href="#switch-versions" id="switch-versions"></a>

同じお客様のメッセージに対して候補を複数回生成した場合、カードのタイトル行に `2 / 3` のようなバージョン切り替えが表示されます。左右の矢印（<mark style="color:blue;">前のバージョン</mark>、<mark style="color:blue;">次のバージョン</mark>）で各バージョンを比較し、1つを選んで送信または編集します。新しいバージョンの生成中は、カードは生成中のバージョンに固定され、一時的に切り替えられません。

### 候補のステータス <a href="#suggestion-status" id="suggestion-status"></a>

| ステータス                                 | 意味                            | できること                                                                                                        |
| ------------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------ |
| <mark style="color:blue;">生成中</mark>  | AI が候補を生成しています                | 完了を待ちます。この間は送信、編集、再生成はできません                                                                                  |
| <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>   | 今回は生成に成功しませんでした。カードに理由が表示されます | 再生成アイコンをクリックしてもう一度試します                                                                                       |

### Copilot ビューを新しいタブで開く <a href="#open-copilot-view" id="open-copilot-view"></a>

会話のタイトル行にあるロボットアイコン（マウスを重ねると <mark style="color:blue;">会話 Copilot</mark> と表示されます）をクリックすると、この会話の簡易ビューが新しいタブで開きます。メッセージ、AI 候補、入力欄だけが表示されるため、ほかのシステムと並べて使うのに便利です。

## Credits の消費 <a href="#credits" id="credits"></a>

AI 候補を1件生成するたびに、Agent が1回返信した場合と同様に Credits を消費します。消費量は Agent が使用するモデルとツールに応じて計算されます。<mark style="color:blue;">再生成</mark> を押すと新しい候補が1件生成され、再度課金されます。生成に失敗した候補では Credits は差し引かれません。

「受信したメッセージごと」モードでは、お客様のメッセージごとに候補が生成されるため、通常は手動モードよりも使用量が多くなります。料金と消費履歴は [Credits 課金制度](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits.md#pricing-tab) をご覧ください。

## よくある質問 <a href="#faq" id="faq"></a>

### 会話にロボットアイコンが表示されません。 <a href="#faq-no-icon" id="faq-no-icon"></a>

この会話が属するプラットフォームで、<mark style="color:blue;">AI Copilot</mark> タブの <mark style="color:blue;">AI Copilot を有効にする</mark> がオンになっていて、保存されているか確認してください。ロボットアイコンはお客様から届いたメッセージの横にのみ表示され、AI やサポート担当者が送信したメッセージには表示されません。

### ロボットアイコンをクリックすると「候補の生成に失敗しました」と表示されます。 <a href="#faq-generate-failed" id="faq-generate-failed"></a>

よくある原因は、プラットフォームの AI Copilot が無効になっていること、またはプラットフォームに Agent が紐づけられていないことです。AI Copilot はプラットフォームに紐づけられた Agent が候補を生成するため、該当プラットフォームの <mark style="color:blue;">基本設定</mark> で Agent が選択されているか確認してください。

### お客様に AI 候補は見えますか？ <a href="#faq-customer-visibility" id="faq-customer-visibility"></a>

見えません。AI 候補はサポート担当者の会話画面にのみ表示され、ウェブサイトや LINE などのお客様側には送信されません。サポート担当者が <mark style="color:blue;">送信</mark> を押した内容、または編集後に自分で送信した内容だけがお客様に届きます。

### 「受信したメッセージごと」に切り替えたら、AI が返信しなくなりました。 <a href="#faq-no-auto-reply" id="faq-no-auto-reply"></a>

これはこのモードの仕様です。AI は候補を生成するだけで、送信するかどうかはサポート担当者が決めます。AI の自動返信に戻したい場合は、<mark style="color:blue;">手動</mark> に戻すか、<mark style="color:blue;">AI Copilot を有効にする</mark> をオフにしてください。


---

# 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/serve/copilot.md?ask=<question>&goal=<user_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.
