> 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/serve/daily-operations/reply/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. **選擇要查看的對話**
   * 在對話列表中找到目標對話
   * 點選對話，右側就會顯示完整對話內容

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%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>- 使用的 Agent<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>，以及倒讚時在「提供回饋」視窗勾選的原因與補充文字，都會記錄在該則回覆上，可在這裡逐則查看；整體比例見[使用分析：使用者滿意度](/build/agent/usage.md#user-satisfaction-rate)。使用者端的操作方式見 [MaiGPT：對回覆按讚、倒讚與提供回饋](/work/maigpt/chat.md#message-feedback)。

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

對話層級的成本看 <mark style="color:blue;">詳情</mark> 面板的 [Credit 消耗彙總](/serve/daily-operations/reply.md#credit-summary)：每一輪 AI 回覆的 Credit 加總、平均與最高最低，並可匯出 CSV。要看單一輪回覆的 Token 數、處理時間與執行步驟，到 AgentOps 的對話詳情頁，見 [自動評估與 Agent 監控](/build/agent-ops/evaluations.md#monitoring-field-descriptions)。

{% hint style="info" %}
成本統計有助於找出特別貴的回覆，再回頭調整 Agent 設定或知識庫。
{% 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>

MaiAgent 依使用情境提供兩種取得方式：

| 需求                | 建議方式                        | 輸出    |
| ----------------- | --------------------------- | ----- |
| 批次分析 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>」，待狀態為「已完成」後下載 Excel 檔案；列表的「使用者」欄會標示每份匯出是誰建立的

{% hint style="info" %}
批次 Excel 以每次「使用者提問與 AI 回覆」的問答紀錄為單位，適合品質分析；它不是包含所有訊息與附件原始檔的完整封存包。

匯出目前僅包含互動對話；若在 Agent 監控把來源篩選為「排程執行」，匯出按鈕會停用。詳見 [依成員與來源篩選對話紀錄](/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 問答紀錄，並依 Agent、日期或關鍵字篩選。

請以 `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" %}
**延伸功能**

* [收件匣搜尋功能](/serve/daily-operations/reply/inbox-search.md)
* [所有對話的功能](/serve/daily-operations/reply.md)
* [Agent 監控](/build/agent-ops/evaluations.md#ai-agent-monitoring)
* [使用分析](/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/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.