> 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/build/conversation-settings/conversation-analysis.md).

# 会話分析

会話分析を有効にすると、有人対応への引き継ぎ時に AI が会話の要約を自動生成し、分類タグを付与します。分析モデル、分析プロンプト、参照メッセージ数の設定方法を説明します。

会話分析は、AI がカスタマーサポート担当者の代わりに会話を「先に読んでおく」機能です。会話が有人対応に引き継がれると、直近のメッセージをもとに<mark style="color:blue;">会話の要約</mark>を自動生成し、このプラットフォームの[会話タグ](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/conversation-tags.md)から分類タグを選んで付与します。引き継ぎを受けた担当者は最初からメッセージをスクロールする必要がなく、管理者もタグを使って問い合わせの種類を集計できます。[タグルーティング](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/human-handoff.md#tag-routing)と組み合わせれば、付与されたタグに応じて対応するグループへ直接振り分けることもできます。

有効にすると、担当者は任意の会話の詳細パネルで「<mark style="color:blue;">会話を分析</mark>」を押して、手動で再分析することもできます。[会話の詳細](https://docs.maiagent.ai/maiagent-user-guide/ja/serve/daily-operations/reply.md#conversation-details)をご覧ください。

## 会話分析の設定を開く <a href="#open" id="open"></a>

<mark style="color:blue;">カスタマーサポート会話</mark> → <mark style="color:blue;">会話プラットフォーム</mark>に移動し、設定したいプラットフォームで<mark style="color:blue;">編集</mark>を押します。

* **Web、内部、API プラットフォーム**：左側ナビゲーションの「高度な機能」グループ → <mark style="color:blue;">会話分析</mark>。
* **LINE、WhatsApp などのメッセージングプラットフォーム**：上部のタブバーにある<mark style="color:blue;">会話分析</mark>。Slack プラットフォームにはこのタブがありません。[プラットフォーム対応表](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings.md#platform-matrix)をご覧ください。

## 設定項目 <a href="#fields" id="fields"></a>

| 項目                                          | 説明                                                                                                 |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">会話分析を有効にする</mark> | オンにすると、有人対応への引き継ぎ時に AI が会話内容を自動的に分析し、分類タグを付与します                                                    |
| <mark style="color:blue;">分析モデル</mark>      | 分析を実行する LLM です。分析は追加のモデル呼び出しとなり、クレジットを消費します。会話量の多いプラットフォームでは、より高速で低コストなモデルを選択できます                  |
| <mark style="color:blue;">分析プロンプト</mark>    | 任意です。会話をどのように分析・分類するかを AI に伝えます。たとえば、識別したい業務カテゴリや、要約に含める情報を指定できます。空欄の場合はプラットフォームのデフォルトプロンプトが使用されます |
| <mark style="color:blue;">参照メッセージ数</mark>   | 直近 N 件のメッセージを AI に渡して分析します。数が多いほど要約は充実しますが、トークンの消費も増えます。ほとんどのカスタマーサポートの場面では 20～50 件で十分です           |

入力したら、右下の<mark style="color:blue;">保存</mark>を押します。

{% hint style="info" %}
AI は、このプラットフォームに**作成済み**の会話タグの中からのみ選択し、自分で新しいタグを追加することはありません。先に[会話タグの管理](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/conversation-tags.md)で分類を作成してください。タグ名が業務カテゴリをよく表しているほど（たとえば「カテゴリ A」ではなく「返品・交換」）、自動タグ付けの精度が上がります。
{% endhint %}

## 分析結果の確認場所 <a href="#where-to-see" id="where-to-see"></a>

<mark style="color:blue;">すべての会話</mark>で会話を開き、<mark style="color:blue;">詳細</mark>を押します。

* <mark style="color:blue;">会話の要約</mark>：AI が生成した要約が表示されます。担当者は<mark style="color:blue;">要約を編集</mark>でき、<mark style="color:blue;">編集履歴</mark>で AI の原案と各回の修正内容を確認し、必要に応じて<mark style="color:blue;">元に戻す</mark>ことができます。
* <mark style="color:blue;">会話タグ</mark>：自動で付与されたタグがここに表示され、担当者が手動で追加・削除することもできます。

## 分析プロンプトの例 <a href="#prompt-example" id="prompt-example"></a>

```
あなたはカスタマーサポート責任者のアシスタントです。会話を読み、次の 2 つを行ってください。
1. 顧客の問題、これまでに試した対応、現在行き詰まっている点を 2～3 文で要約する。
2. 利用可能なタグの中から最も適した分類を 1～2 個選ぶ。顧客が明らかに不満を示している場合は、さらに「クレーム」を付ける。
要約は日本語で作成し、会話に含まれていない推測は加えないこと。
```


---

# 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/conversation-settings/conversation-analysis.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.
