執行監控與日誌
執行列表、即時事件串流、日誌 / 成本 / tokens、錯誤定位 —— 把執行狀態看清楚。
工作流跑起來之後，能不能看懂「它到底做了什麼、花了多少」，決定你敢不敢把它放進生產。這一頁講執行列表、執行詳情、即時事件、token 與成本記錄、匯出與資料看板。
執行列表頁
左側導覽「執行歷史」。支援卡片與表格兩種檢視，有執行在執行時列表自動重新整理（可暫停）。篩選與排序：
- 關鍵字搜尋 —— 按執行 ID 或工作流名稱
- 狀態篩選 —— PENDING / RUNNING / COMPLETED / FAILED / CANCELLED / INTERRUPTED
- 工作流篩選 —— 只看某一條工作流的歷史
- 排序 —— 開始時間 / 完成時間 / 耗時 / 工作流 / 狀態 / 進度
列表頂部還有一排帶計數的快捷篩選（執行中 / 失敗 / 已完成 / 已中斷），點一下切換。
每條記錄顯示的信息
- 狀態徽章 + 執行 ID + 工作流名稱
- 進度條與步驟完成數（例：5/7）
- 開始時間（相對時間）與耗時
- RUNNING 的記錄額外顯示目前正在跑的步驟
- 已結束的記錄可以直接在列內匯出 JSON / YAML
多選之後可以批次取消執行中的執行，或批次刪除已結束的記錄。
PENDING— 已建立、還沒開始跑。超出並行上限的執行會先排隊在這個狀態，前面的執行完成後自動轉 RUNNING。RUNNING— 至少一個步驟在執行。COMPLETED— 全部步驟跑完（包括因 condition 不滿足被 SKIPPED 的步驟）。FAILED— 某個步驟出錯，執行以失敗結束。CANCELLED— 使用者手動取消。INTERRUPTED— 被服務重啟等系統原因中斷。是否自動續跑見下方「下一步」裡的自動續跑頁。
執行詳情頁
點任意一條執行進入詳情頁。由上到下：
- 頂欄 —— 取消、重新整理、匯出（JSON / YAML）、跳轉到對應的工作流編輯器
- 狀態卡 —— 狀態、進度、耗時，以及 token 快覽（傳送 / 接收 / 合計）
- 主區標籤頁（見下表）
- 底部「執行日誌」流 —— 全部事件的捲動日誌，可按層級（debug / info / warn / error）篩選、按關鍵字搜尋、暫停自動捲動
| 標籤頁 | 內容 |
|---|---|
| 步驟 | 直排時間軸：每步的狀態、耗時、迭代進度。點擊開啟步驟詳情側欄；執行結束後可從指定步驟重跑。 |
| 對話 | 把 Agent 發言、LLM 輸出、工具呼叫、系統訊息按時間合成一條聊天流。 |
| 外部訊息 | 只看 IM 通道的收發記錄（Slack / Telegram 等）。 |
| DAG | 按相依關係畫出的步驟圖，執行狀態即時著色。 |
| 回放 | 按時間軸重播這次執行的過程。 |
| 推理鏈 | Agent 的中間推理內容。 |
| 產物 | 全部產物檔案：預覽、下載、單檔案分享，或者把整個目錄產生一個公開連結。 |
| 性能 | 執行結束後的耗時分析。 |
| 調試 | 設定過中斷點或有偵錯會話時出現。 |
步驟詳情側欄
點時間軸裡的某一步，右側滑出這一步的全部資訊：輸出、事件、推理、產出物、對話幾個分頁（迭代 / 互動 / 編排類步驟有對應的附加分頁），外加起止時間與「從此步驟重新執行」按鈕。失敗步驟的錯誤資訊與重試次數也在這裡看。
即時更新（WebSocket）
執行處於 RUNNING 狀態時，詳情頁透過 WebSocket 接收增量更新，不需要手動重新整理。連線斷開會自動重連（指數退避，最多 5 次）；仍失敗則自動降級為每 2 秒輪詢並提示。
推送訊息類型
| 類型 | 含義 |
|---|---|
full_status | 執行狀態全量快照 |
status_change | 執行狀態 / 進度變化 |
step_update | 單個步驟的狀態更新 |
new_event | 新的執行事件（見下方事件類型） |
artifact_found | 新產物檔案生成 |
user_interaction_request | 步驟請求人工輸入，對話頁會出現回覆框 |
事件類型一覽
每個步驟的事件流用 type 欄位區分事件種類。常見類型按家族列出：
| 事件類型 | 含義 |
|---|---|
agent_starting / agent_completed / agent_failed | Agent 步驟的生命週期 |
llm_call_starting / llm_call_completed | 一次 LLM 呼叫；completed 事件帶這次呼叫的 token 計數 |
llm_streaming_starting / llm_streaming_completed / llm_streaming_failed | 串流 LLM 輸出 |
tool_call_starting / tool_call_completed / tool_call_failed | Agent 工具呼叫，含參數與結果摘要 |
external_message / im_message / telegram_message | IM 通道的訊息收發 |
group_chat_started / group_chat_message / group_chat_summarizing / group_chat_completed | group_chat 步驟的多 Agent 討論過程 |
state_machine_started / state_machine_transition / state_machine_state_completed | state_machine 步驟的狀態流轉 |
agent_based_started / agent_based_completed | agent_based 編排步驟的委派過程 |
user_interaction_request / user_interaction_message / user_interaction_timeout | 執行中向使用者提問、收到回覆、等待逾時 |
claude_code_* | Claude Code 執行時的串流進度事件 |
事件同時帶一個 category 欄位（agent / llm / tool / message / strategy / user_interaction），對話頁的類別篩選按它分組。
對話檢視的篩選
- 關鍵字搜尋 —— 在訊息內容與發言者裡搜
- 按 Agent 篩選 —— 只看某個 Agent 或步驟的訊息
- 類別篩選 —— Agent / LLM / 工具 / 外部訊息 / 策略 / 互動
- 自動捲動開關 —— 新訊息到達時是否跟隨捲到底部
token 與成本
- LLM 相關事件逐次記錄 input / output token，狀態卡即時累加顯示傳送 / 接收 / 合計。
- 執行結束後，
GET /api/executions/{executionId}/cost按所用模型的價格估算這次執行的成本，回傳總額與每一步的明細。 - 成本是事後按 token 用量估算的；平台不提供執行前報價。
導出執行過程
詳情頁頂欄或列表列的「匯出」把一次執行匯出為 JSON 或 YAML 檔案，內容包括執行狀態、結果、效能指標，以及匯出時刻的工作流定義快照與 YAML 原始碼。密碼、API Key、webhook 位址等敏感欄位會自動替換為 [REDACTED]。檔名形如 execution-process-79621f70-completed.json。
匯出裡的工作流定義是匯出時拉取的目前版本；如果工作流在這次執行之後被改過，它可能和執行當時的定義不同。
數據看板
跨執行的彙總檢視在 執行分析 看板：總執行次數、成功率、平均耗時、token 總用量，加上執行趨勢、狀態分佈與 Top 工作流排行，時間範圍可選 24 小時 / 7 天 / 30 天。
錯誤定位
執行 FAILED 時，先在時間軸裡找紅色的那一步，點開步驟詳情：錯誤資訊在「輸出」分頁，過程細節在「事件」分頁（code 步驟的 stderr 也在這裡）。重試過的步驟會顯示重試次數。
常見錯誤的處理方式見 問題排查。
保留期
執行記錄（狀態、結果、事件、效能資料）與產物檔案預設保留 90 天，到期由平台定期清理；具體期限以你的方案或部署設定為準，執行還在跑時不會被清理。