> 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/daily-operations/reply/conversation-viewer.md).

# 会話ビューアー

会話の全内容と詳細情報を確認できます

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

会話ビューアーは、MaiAgent の管理画面で会話を確認するためのページです。管理者やカスタマーサポート担当者は、会話の全記録をより見やすく、詳しく確認できます。メッセージの内容、時系列、使用したツールの記録など、1 件の会話のあらゆる詳細に集中して確認できます。

{% 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. **確認する会話を選ぶ**
   * 会話一覧で対象の会話を探します。
   * 会話をクリックすると、右側に会話の全内容が表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-1dd0b5fce522c5838a5c10c6b9a10f796fd22d45%2Fconversation-viewer-example.png?alt=media" alt="すべての会話ページの右側に表示された会話内容：ユーザーのメッセージと AI の返信。返信にはナレッジベースの使用と完了したステップが表示され、下には参照元と高評価・低評価のアイコンが並びます"><figcaption><p>会話を開く：AI の返信には、使用したナレッジベース、実行したステップ、参照元が表示されます</p></figcaption></figure>

***

### 画面の説明 <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></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>

Agent が返信の過程でナレッジベースを検索したりツールを呼び出したりすると、返信の上に<mark style="color:blue;">ナレッジベースを使用しました</mark>、<mark style="color:blue;">ツールを使用しました</mark>、<mark style="color:blue;">N/N 個のステップが完了しました</mark>と表示されます。ステップを開くと、各ステップで何を検索し、ツールが何を返したかを確認できます。

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

AI の返信がナレッジベースの内容を引用している場合、返信内に番号で引用位置が示され、下の<mark style="color:blue;">参照</mark>セクションに引用されたファイルと<mark style="color:blue;">参照ノード</mark>が一覧表示されます。クリックすると、引用された段落を確認できます。

#### ユーザーの高評価と低評価 <a href="#user-feedback" id="user-feedback"></a>

ユーザーが Web Chat、Agent マーケット、または MaiGPT で AI の返信に付けた<mark style="color:blue;">高評価</mark>／<mark style="color:blue;">低評価</mark>、および低評価の際に「フィードバックを送信」ウィンドウで選んだ理由や補足テキストは、すべてその返信に記録され、ここで 1 件ずつ確認できます。全体の割合については、[利用分析：ユーザー満足度](/maiagent-user-guide/ja/build/agent/usage.md#user-satisfaction-rate)を参照してください。ユーザー側の操作方法については、[MaiGPT：返信への高評価・低評価とフィードバック](/maiagent-user-guide/ja/work/maigpt/chat.md#message-feedback)を参照してください。

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

会話単位のコストは、<mark style="color:blue;">詳細</mark>パネルの [Credit 消費の集計](/maiagent-user-guide/ja/serve/daily-operations/reply.md#credit-summary)で確認します。AI の返信 1 ターンごとの Credit の合計、平均、最大・最小が表示され、CSV としてエクスポートもできます。1 ターンの返信の Token 数、処理時間、実行ステップを確認するには、AgentOps の会話詳細ページを開きます。[自動評価と Agent 監視](/maiagent-user-guide/ja/build/agent-ops/evaluations.md#monitoring-field-descriptions)を参照してください。

{% hint style="info" %}
コストの統計は、特にコストの高い返信を見つけ、Agent の設定やナレッジベースを見直すのに役立ちます。
{% 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. 会話ビューアーで各会話を確認します。
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>

MaiAgent では、用途に応じて 2 つの取得方法を利用できます。

| 用途                            | 推奨方法                                    | 出力形式  |
| ----------------------------- | --------------------------------------- | ----- |
| AI の質問と回答の記録を一括で分析する          | 「AgentOps > AI アシスタントの監視」で絞り込んでエクスポートする | Excel |
| 社内システムに AI の質問と回答の記録を定期的に同期する | 質問と回答の記録 API を使用し、ページ分割と保存を自分で処理する      | JSON  |

#### 一括エクスポート <a href="#batch-export" id="batch-export"></a>

1. 左側のメニューで<mark style="color:blue;">AgentOps > AI アシスタントの監視</mark>を開きます。
2. Agent、メンバー、日付、キーワードなどの条件で絞り込みます。
3. 右上の<mark style="color:blue;">エクスポート</mark>をクリックし、エクスポートリクエストを作成します。
4. 左側のメニューで<mark style="color:blue;">AgentOps > エクスポートリクエスト</mark>を開きます。ステータスが<mark style="color:blue;">完了</mark>になったら Excel ファイルをダウンロードします。一覧の<mark style="color:blue;">ユーザー</mark>列には、各エクスポートを作成した人が表示されます。

{% hint style="info" %}
一括エクスポートされる Excel は、各「ユーザーの質問と AI の返信」を 1 単位とした記録で、品質分析に適しています。すべてのメッセージと添付ファイルの原本を含む完全なアーカイブではありません。

現在、エクスポートには対話形式の会話のみが含まれます。AI アシスタントの監視で取得元を<mark style="color:blue;">スケジュール実行</mark>に絞り込むと、エクスポートボタンは無効になります。詳しくは[メンバーと取得元で会話記録を絞り込む](/maiagent-user-guide/ja/build/agent-ops/evaluations.md#filter-by-member-and-source)を参照してください。
{% endhint %}

#### API から取得する <a href="#export-via-api" id="export-via-api"></a>

定期的な同期や独自の JSON 形式が必要な場合は、組織の API Key を使って `GET /api/v1/records/` を呼び出します。AI の質問と回答の記録をページごとに取得し、AI アシスタント、日付、キーワードで絞り込めます。

`Authorization: Api-Key <API Key>` で認証し、次のページがなくなるまでレスポンスのページ分割情報に従ってください。パラメータとレスポンスの項目については、[MaiAgent API ドキュメント](https://docs.maiagent.ai/tech/)を参照してください。

#### 添付ファイルの扱い <a href="#export-attachments" id="export-attachments"></a>

* Excel の一括エクスポートと質問・回答記録 API には、利用者がアップロードした添付ファイルの原本は含まれません。
* 現在、顧客が会話の添付ファイルを一括ダウンロードするための公開 API はありません。添付ファイルの保存が必要な場合は、適切なデータ提供方法について MaiAgent チームにお問い合わせください。

{% 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/ja/serve/daily-operations/reply/inbox-search.md)
* [すべての会話の機能](/maiagent-user-guide/ja/serve/daily-operations/reply.md)
* [Agent 監視](/maiagent-user-guide/ja/build/agent-ops/evaluations.md#ai-agent-monitoring)
* [利用状況の分析](/maiagent-user-guide/ja/build/agent/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 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/daily-operations/reply/conversation-viewer.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.