跟「對話」頁面不是同一件事

側邊欄日誌與用量底下的系統日誌，查的是客人（或呼叫 API 的服務）跟 agent 之間真實發生過的對話。這跟對話頁面（見〈怎麼新增、切換、找回對話〉）完全不同—— 那個是你自己拿 agent 測試用的地方，這裡是稽核與除錯真實流量用的地方。要看客人 到底問了什麼、AI 怎麼回、送了幾則、有沒有送失敗，來這裡查。

看這頁需要檢視對話紀錄這個能力，見〈自訂角色與能力的連帶關係〉。

第一步：選一顆 Agent

進來先看到的是 agent 清單，每一列列出代理名稱跟聊天室數量。上方搜尋 代理...是在目前載入的清單裡直接過濾名稱，不會重新呼叫後端。點一列就會進到 這顆 agent 的聊天室列表。

進到一顆 Agent 之後：聊天室列表在看什麼

左側列表一列代表一個聊天室（session），每列顯示：

• 圖示——一般客人對話是人形圖示，API 呼叫進來的是程式碼圖示。
• 標題——聊天室名稱，沒有名稱時顯示「未命名聊天室」。
• 摘要——不是 AI 事後生成的東西，是這段對話裡第一句使用者訊息的前 200 字。比自動命名更能一眼看出這段在問什麼。
• 時間與訊息數——最後一則訊息的時間（沒有訊息就退回建立時間），跟這段 對話總共幾則訊息。

列表排序是照最後有動靜的時間排，不是建立時間——三週前開的對話今天又有 新訊息，它就會跳回最上面，不用往下翻很久才找到還在講的那幾段。

怎麼篩選

搜尋聊天室——打關鍵字後會 debounce 400ms 才送出查詢（不用等你打完按 Enter），比對的是後端全文搜尋：聊天室標題或任何一則訊息內容命中都算， 不是只比對標題。

起訖日期——這裡有個容易搞混的地方：日期篩的是聊天室的建立日期， 不是「最後一則訊息的時間」。如果一段對話是很久以前開始的、但今天才剛有 新回覆，篩「今天」不會篩到它——因為篩的是「這段對話從什麼時候開始」， 不是「最近有沒有動靜」。跟前面提到的排序邏輯（照最後動靜排）是兩件不同 的事，篩選跟排序刻意各自看不同的時間欄位。

匯出 CSV

列表標題右邊的下載圖示會把目前套用的搜尋／日期篩選條件送給後端匯出， 不是匯出全部聊天室——先篩好範圍再匯出，拿到的才是你要的那一批。

匯出的 CSV 一列是一則訊息，不是一個聊天室一列，欄位包含：聊天室 ID／名稱、是否為 API 呼叫、訊息 ID、時間、角色、內容、工具呼叫、引用來源、 使用的模型、token 用量。

兩個實際使用上要注意的限制：

• 匯出上限 2 萬列，超過的部分會被截斷，畫面上不會另外跳警告——篩選範圍 太大（例如整個組織、跨好幾個月）時，建議先縮小日期範圍再匯出，不然拿到的 資料可能悄悄少了一段。
• 匯出需要另一個能力：檢視列表用的是「檢視對話紀錄」（log.view）， 匯出 CSV 用的是另一個獨立能力「匯出對話紀錄」（log.export）。如果你看得到 聊天室列表，按下匯出卻一直失敗，很可能是角色只給了檢視、沒有給匯出——去 〈自訂角色與能力的連帶關係〉檢查角色設定，不是系統故障。