團隊執行記錄

查看團隊每一次執行的記錄——屬於哪一段對話、經過哪些 Agent、各自的 Token 用量與耗時，並可依對話篩選出同一段對話的所有執行。

團隊在 Agent 之間自動移交與委派，過程對使用者是無感的。〈執行記錄〉讓你回頭檢視每一次對話實際「走過哪些 Agent、各花了多少資源」，用來確認團隊有如預期分工，也方便排查與優化。

一、查看執行記錄

在團隊頁切換到〈執行記錄〉檢視，會列出這個團隊的每一次執行。使用者每傳一則訊息給團隊，就會產生一筆記錄。每筆記錄包含：

欄位	說明
記錄 ID	這次執行的唯一識別碼。
對話	這次執行所屬的對話（以對話標題顯示）。點標題可直接開啟〈所有對話〉查看該段對話的完整內容。
狀態	〈執行中〉〈已完成〉〈失敗〉或〈逾時〉。
迭代數	這次執行中，Agent 之間總共來回了幾次。
Token 數	這次執行的總 Token 用量（輸入 in／輸出 out）。
耗時	從收到訊息到完成回覆的總時間。
建立時間	這次執行的時間。點欄位標題可切換由舊到新、由新到舊排序；未指定排序時預設由新到舊。

執行記錄：每筆記錄顯示所屬對話的標題，可一眼看出哪幾筆來自同一段對話

對話標題無法點開？ 需要具備〈對話紀錄〉的存取權限，對話標題才會以連結顯示；沒有權限時只會顯示純文字（滑鼠移到標題上會提示原因）。

二、依對話篩選執行記錄

一段對話通常有好幾則訊息，每則訊息各自產生一筆執行記錄。想集中檢視某一段對話時，可以只列出屬於這段對話的記錄。

1. 以此對話過濾

在要檢視的那筆記錄右側〈操作〉欄，點漏斗圖示 以此對話過濾。

點記錄右側的漏斗圖示「以此對話過濾」

2. 檢視篩選結果

列表上方會出現提示列〈僅顯示對話「…」的執行記錄〉，下方只剩這段對話的記錄；翻頁與排序時篩選仍會保留。此時這些記錄的漏斗圖示會變成灰色，滑鼠移上會顯示〈已在檢視此對話的記錄〉。

要回到完整列表，點提示列右側的 清除 或關閉（×）即可。

篩選後：提示列標示目前檢視的對話，列表只剩這段對話的記錄

使用情境：追查客訴對話是哪個 Agent 回覆的

客服主管收到顧客反映「退貨說明不清楚」，想確認那段對話中每一則回覆分別是由團隊裡的哪個 Agent 處理：

1. 在〈執行記錄〉找到這段對話的任一筆記錄，點 以此對話過濾，列表只剩這段對話的記錄。

2. 逐筆展開，從步驟卡上的 Agent 名稱看出：第一則訊息由〈示範－客服分流助理〉接待後移交給〈示範－退換貨助理〉，之後的追問則由〈示範－退換貨助理〉直接回覆。

3. 點〈對話〉欄的標題開啟原對話，對照實際回覆內容，確認問題出在〈示範－退換貨助理〉後，再回到〈AI 助理〉調整它的設定。

三、展開步驟詳情

點記錄左側的 +（或直接點該列）展開，可看到這次執行依序經過哪些 Agent 節點。每一步是一張步驟卡：

項目	說明
步驟序號與名稱	以〈#序號 · 名稱〉顯示，例如〈#1 · 示範－客服分流助理〉，一眼看出這一步由團隊裡的哪個 Agent 處理。
Token 用量	卡片右側顯示這一步的輸入／輸出 Token（in / out），部分步驟另會附上耗時，讓你看清成本花在哪個 Agent 身上。

步驟詳情：每張步驟卡標示序號與處理的 Agent 名稱，右側為該步驟的 Token 用量

可以用 API 取得執行記錄嗎？ 目前執行記錄只能在後台的〈執行記錄〉檢視查看，尚未列入公開的 API 文件。需要匯出分析時，請洽 MaiAgent 窗口。

看不到記錄？ 執行記錄只在團隊實際被對話觸發後才會產生。若列表是空的，先透過團隊的對話平台與團隊聊幾句，再回來查看。

四、怎麼用這些記錄優化團隊

• 路由不如預期：從步驟卡的 Agent 名稱發現問題被交給了錯誤的 Agent，回到 畫布編排 調整連線的〈觸發條件描述〉，把「什麼時候走這條連線」寫得更明確。

• 迭代數或耗時偏高：可能是 Agent 之間來回移交太多次。檢查是否有多餘的連線，或調整團隊的〈最大迭代數〉與各節點設定。

• 成本集中在某個 Agent：比對各步驟卡的 Token 用量，找出 Token 花最多的 Agent，考慮為它換用較輕量的模型，或縮小它的知識庫與工具範圍。