# 對話檢視器

### 功能簡介 <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>

#### 情境一：品質監控 <a href="#use-case-quality-monitoring" id="use-case-quality-monitoring"></a>

**需求**：主管每日抽查對話品質，確認 AI 回覆是否符合標準

**操作流程**：

1. 每日從收件匣隨機選擇 10 筆對話
2. 使用對話查看器逐一檢視
3. 檢查重點：
   * AI 回覆是否準確
   * 語氣是否適當
   * 是否正確使用工具
   * 知識庫引用是否相關
4. 標記需要改善的對話
5. 提供回饋給 AI 訓練團隊

#### 情境二：客服訓練 <a href="#use-case-customer-service-training" id="use-case-customer-service-training"></a>

**需求**：使用實際對話案例訓練新進客服人員

**操作流程**：

1. 篩選出優秀的對話範例（處理得當的複雜問題）
2. 使用對話查看器進行逐步解說
3. 重點說明：
   * 如何理解客戶需求
   * 如何有效使用工具
   * 如何引導對話流程
   * 如何妥善結束對話
4. 讓新人模擬類似情境

#### 情境三：問題診斷 <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" %}
**延伸功能**

* [收件匣搜尋功能](/conversations/inbox-search.md)
* [所有對話的功能](/conversations/reply.md)
* [回覆品質控管](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/blob/main/zh-tw/channels/quality.md)
* [使用分析](/org/usage.md)
  {% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.maiagent.ai/conversations/conversation-viewer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.