# 對話檢視器

### 功能簡介

對話查看器是 MaiAgent 後台管理介面中的對話檢視頁面，讓管理者與客服人員能夠以更清晰、詳細的方式查看完整的對話記錄。透過對話查看器頁面，您可以專注檢視單一對話的所有細節，包含訊息內容、時間軸、使用工具記錄等資訊。

{% hint style="info" %}
對話查看器特別適合用於品質監控、客服訓練、問題追蹤等情境，讓您能更有效地分析對話內容。
{% endhint %}

***

### 開啟對話查看器

#### 從收件匣進入

1. **進入對話列表**
   * 點選左側選單「<mark style="color:blue;">客服對話</mark>」
   * 點選「<mark style="color:blue;">所有對話</mark>」
2. **選擇要查看的對話**
   * 在對話列表中找到目標對話
   * 點選對話即可進入對話查看器頁面

***

### 介面說明

#### 主要區塊

<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>

#### 訊息顯示

* **使用者訊息**：顯示在左側，使用淺色背景
* **AI 回覆**：顯示在右側，使用品牌色背景
* **系統訊息**：置中顯示，使用灰色文字
* **時間戳記**：每則訊息下方顯示發送時間

***

### 進階功能

#### 工具使用記錄

對話查看器會清楚顯示 AI 助理在對話中使用的工具：

```
[工具呼叫] 知識庫查詢
查詢關鍵字: 退貨流程
查詢結果: 找到 3 筆相關文件
使用時間: 2025-12-10 14:23:15
```

#### 知識庫引用追蹤

AI 回覆如果引用知識庫內容，會標示引用來源：

```
[引用來源] 退換貨政策.pdf
相關段落: "商品到貨 7 天內可申請退貨..."
相似度: 95%
```

#### Token 使用統計

顯示該對話的 Token 消耗：

* **使用者輸入**: 120 Tokens
* **AI 回覆**: 350 Tokens
* **工具呼叫**: 80 Tokens
* **總計**: 550 Tokens

{% hint style="info" %}
Token 統計有助於分析對話成本與優化 AI 助理設定。
{% endhint %}

***

### 應用情境

#### 情境一：品質監控

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

**操作流程**：

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

#### 情境二：客服訓練

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

**操作流程**：

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

#### 情境三：問題診斷

**需求**：使用者反應 AI 回覆不正確，需要找出原因

**操作流程**：

1. 透過搜尋功能找到該對話
2. 使用對話查看器詳細檢視
3. 分析問題點：
   * 檢查使用者問題是否被正確理解
   * 查看 AI 呼叫了哪些工具
   * 確認知識庫查詢結果是否相關
   * 檢視 AI 的推理過程
4. 找出問題根源（知識庫不足 / 工具設定錯誤 / Prompt 需優化）
5. 進行相應調整

***

### 匯出對話記錄

#### 匯出步驟

1. 在對話查看器中點選「<mark style="color:blue;">匯出</mark>」按鈕
2. 系統會將對話記錄匯出為 PDF 格式
3. PDF 檔案會自動下載至您的裝置

{% hint style="warning" %}
**隱私提醒**

匯出的對話記錄可能包含使用者個人資訊，請妥善保管，遵守隱私政策與相關法規。
{% endhint %}

***

### 常見問題

#### Q：對話查看器與一般對話視窗有何不同？

**A**：對話查看器提供更完整的資訊，包含工具使用記錄、知識庫引用追蹤、Token 使用統計等進階資訊，適合用於分析、監控與訓練。一般對話視窗則適合日常回覆操作。

#### Q：可以在對話查看器中直接回覆嗎？

**A**：不行。對話查看器是唯讀介面，主要用於檢視與分析。如需回覆對話，請回到對話列表中操作。

#### Q：對話查看器會顯示已刪除的訊息嗎？

**A**：不會。對話查看器只顯示當前存在的訊息記錄。已刪除的訊息無法復原顯示。

#### Q：對話查看器載入速度慢怎麼辦？

**A**：可能原因與解決方式：

* **對話過長**：超過 100 則訊息的對話載入較慢，請稍候
* **網路問題**：檢查網路連線狀況
* **包含大型附件**：圖片或檔案過多會影響載入速度

***

### 相關功能

{% hint style="info" %}
**延伸功能**

* [收件匣搜尋功能](https://docs.maiagent.ai/conversations/inbox-search)
* [所有對話的功能](https://docs.maiagent.ai/conversations/reply)
* [回覆品質控管](https://docs.maiagent.ai/conversations/broken-reference)
* [使用分析](https://docs.maiagent.ai/org/usage)
  {% endhint %}