> 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/maiagent-user-guide-ja/conversations/conversation-viewer.md).

# 対話ビューア

### 機能概要 <a href="#feature-introduction" id="feature-introduction"></a>

会話ビューアは、MaiAgent の管理画面に用意された会話確認ページです。管理者やカスタマーサポート担当者が、会話の全記録をより見やすく、詳細に確認できます。会話ビューアのページでは、メッセージ内容、タイムライン、ツールの使用記録などの情報を含め、単一の会話のあらゆる詳細に集中して目を通すことができます。

{% hint style="info" %}
会話ビューアは、品質モニタリング、カスタマーサポートのトレーニング、問題の追跡などの場面に特に適しており、会話内容をより効果的に分析できます。
{% endhint %}

***

### 会話ビューアを開く <a href="#open-conversation-viewer" id="open-conversation-viewer"></a>

#### 受信トレイから開く <a href="#enter-from-inbox" id="enter-from-inbox"></a>

1. **会話一覧を開く**
   * 左側メニューの「<mark style="color:blue;">カスタマーサポート会話</mark>」をクリックします
   * 「<mark style="color:blue;">すべての会話</mark>」をクリックします
2. **確認したい会話を選ぶ**
   * 会話一覧から対象の会話を探します
   * 会話をクリックすると、会話ビューアのページに移動します

***

### 画面説明 <a href="#interface-description" id="interface-description"></a>

#### 主要なエリア <a href="#main-sections" id="main-sections"></a>

<table><thead><tr><th width="200">エリア名</th><th>機能説明</th></tr></thead><tbody><tr><td><strong>会話情報パネル</strong></td><td>会話の基本情報を表示します<br>- ユーザー名<br>- 会話プラットフォーム（LINE / Facebook / Web Chat）<br>- 開始時刻<br>- 会話ステータス</td></tr><tr><td><strong>メッセージタイムライン</strong></td><td>時系列で会話の全記録を表示します<br>- ユーザーメッセージ<br>- AI の返信<br>- システムメッセージ<br>- タイムスタンプ</td></tr><tr><td><strong>会話の詳細情報</strong></td><td>高度な情報を表示します<br>- 使用された AI アシスタント<br>- 呼び出されたツールの記録<br>- ナレッジベースの検索結果<br>- Token 使用量</td></tr><tr><td><strong>操作ボタン</strong></td><td>クイック操作を提供します<br>- 会話記録のエクスポート（PDF）<br>- 会話内容のコピー</td></tr></tbody></table>

#### メッセージの表示 <a href="#message-display" id="message-display"></a>

* **ユーザーメッセージ**：左側に表示され、淡い色の背景を使用します
* **AI の返信**：右側に表示され、ブランドカラーの背景を使用します
* **システムメッセージ**：中央に表示され、グレーの文字を使用します
* **タイムスタンプ**：各メッセージの下に送信時刻が表示されます

***

### 高度な機能 <a href="#advanced-features" id="advanced-features"></a>

#### ツールの使用記録 <a href="#tool-usage-log" id="tool-usage-log"></a>

会話ビューアは、AI アシスタントが会話中に使用したツールを分かりやすく表示します。

```
[ツール呼び出し] ナレッジベース検索
検索キーワード: 返品手続き
検索結果: 関連文書 3 件が見つかりました
使用時刻: 2025-12-10 14:23:15
```

#### ナレッジベース引用の追跡 <a href="#knowledge-base-citation-tracking" id="knowledge-base-citation-tracking"></a>

AI の返信がナレッジベースの内容を引用している場合、引用元が表示されます。

```
[引用元] 返品・交換ポリシー.pdf
関連箇所: "商品到着後 7 日以内であれば返品を申請できます..."
類似度: 95%
```

#### Token 使用量の統計 <a href="#token-usage-stats" id="token-usage-stats"></a>

その会話の Token 消費量を表示します。

* **ユーザー入力**: 120 Tokens
* **AI の返信**: 350 Tokens
* **ツール呼び出し**: 80 Tokens
* **合計**: 550 Tokens

{% hint style="info" %}
Token の統計は、会話コストの分析や AI アシスタント設定の最適化に役立ちます。
{% endhint %}

***

### 活用シーン <a href="#use-cases" id="use-cases"></a>

#### シーン 1：品質モニタリング <a href="#use-case-quality-monitoring" id="use-case-quality-monitoring"></a>

**ニーズ**：管理者が毎日会話品質を抜き取り検査し、AI の返信が基準を満たしているか確認したい

**操作の流れ**：

1. 毎日、受信トレイからランダムに 10 件の会話を選びます
2. 会話ビューアを使って 1 件ずつ確認します
3. チェックのポイント：
   * AI の返信が正確か
   * 口調が適切か
   * ツールを正しく使用しているか
   * ナレッジベースの引用が関連しているか
4. 改善が必要な会話にマークを付けます
5. AI トレーニングチームにフィードバックを提供します

#### シーン 2：カスタマーサポートのトレーニング <a href="#use-case-customer-service-training" id="use-case-customer-service-training"></a>

**ニーズ**：実際の会話事例を使って新人のカスタマーサポート担当者をトレーニングしたい

**操作の流れ**：

1. 優れた会話例（適切に処理された複雑な問題）を絞り込みます
2. 会話ビューアを使って一つずつ解説します
3. 重点的に説明する内容：
   * 顧客のニーズをどう理解するか
   * ツールをどう効果的に使うか
   * 会話の流れをどう導くか
   * 会話をどう適切に締めくくるか
4. 新人に同様のシーンを模擬演習させます

#### シーン 3：問題診断 <a href="#use-case-issue-diagnosis" id="use-case-issue-diagnosis"></a>

**ニーズ**：ユーザーから AI の返信が正しくないと報告があり、原因を突き止めたい

**操作の流れ**：

1. 検索機能を使ってその会話を見つけます
2. 会話ビューアを使って詳細に確認します
3. 問題点を分析します：
   * ユーザーの質問が正しく理解されているか確認します
   * AI がどのツールを呼び出したかを確認します
   * ナレッジベースの検索結果が関連しているか確認します
   * AI の推論プロセスを確認します
4. 問題の根本原因を特定します（ナレッジベースの不足 / ツール設定の誤り / Prompt の最適化が必要）
5. それに応じた調整を行います

***

### 会話記録のエクスポート <a href="#export-conversation-history" id="export-conversation-history"></a>

#### エクスポートの手順 <a href="#export-steps" id="export-steps"></a>

1. 会話ビューアで「<mark style="color:blue;">エクスポート</mark>」ボタンをクリックします
2. システムが会話記録を PDF 形式でエクスポートします
3. PDF ファイルが自動的にお使いのデバイスにダウンロードされます

{% hint style="warning" %}
**プライバシーに関する注意**

エクスポートした会話記録には、ユーザーの個人情報が含まれる場合があります。適切に保管し、プライバシーポリシーおよび関連法規を遵守してください。
{% endhint %}

***

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

#### Q：会話ビューアと通常の会話画面はどう違いますか？ <a href="#faq-difference-from-regular-chat" id="faq-difference-from-regular-chat"></a>

**A**：会話ビューアは、ツールの使用記録、ナレッジベース引用の追跡、Token 使用量の統計といった高度な情報を含む、より充実した情報を提供し、分析・モニタリング・トレーニングに適しています。一方、通常の会話画面は日常的な返信操作に適しています。

#### Q：会話ビューアから直接返信できますか？ <a href="#faq-reply-in-conversation-viewer" id="faq-reply-in-conversation-viewer"></a>

**A**：できません。会話ビューアは読み取り専用の画面であり、主に確認と分析に使用します。会話に返信する場合は、会話一覧に戻って操作してください。

#### Q：会話ビューアには削除済みのメッセージが表示されますか？ <a href="#faq-show-deleted-messages" id="faq-show-deleted-messages"></a>

**A**：表示されません。会話ビューアは現在存在するメッセージ記録のみを表示します。削除済みのメッセージを復元して表示することはできません。

#### Q：会話ビューアの読み込みが遅い場合はどうすればよいですか？ <a href="#faq-slow-loading" id="faq-slow-loading"></a>

**A**：考えられる原因と対処方法：

* **会話が長すぎる**：100 件を超えるメッセージのある会話は読み込みに時間がかかります。少々お待ちください
* **ネットワークの問題**：ネットワーク接続の状態を確認してください
* **大きな添付ファイルを含む**：画像やファイルが多すぎると読み込み速度に影響します

***

### 関連機能 <a href="#related-features" id="related-features"></a>

{% hint style="info" %}
**関連機能**

* [受信トレイの検索機能](/maiagent-user-guide/maiagent-user-guide-ja/conversations/inbox-search.md)
* [すべての会話の機能](/maiagent-user-guide/maiagent-user-guide-ja/conversations/reply.md)
* [返信品質管理](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/blob/main/ja/channels/quality.md)
* [利用分析](/maiagent-user-guide/maiagent-user-guide-ja/org/usage.md)
  {% 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/maiagent-user-guide-ja/conversations/conversation-viewer.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.