跳轉到主要內容
文件運行手動執行

手動執行工作流程

在編輯器裡點「執行」,或在列表裡批次執行 —— 並看懂右側的即時事件串流。

手動執行是你把工作流跑起來最基本的方式 —— 開發調試、一次性業務需求、定期非定時的彙報都走這個入口。這一篇講清楚"在哪裡點、對話框裡每一項是什麼、跑起來後看什麼"。

三種手動執行入口

1. 在編輯器裡點「執行」

最常用。適合你正在改一條工作流、想立刻試一跑。

2. 在工作流列表卡片上點「▶ 執行」

適合一條已經穩定的工作流、不想打開編輯器的時候。

3. 批量執行

在工作流列表頂部勾選多條,點「批量執行」。彈窗裡:

  • 每條工作流分別填 variables(或直接用默認值)
  • 選併發數(1–10)控制同時開幾條
  • 選失敗策略:一條失敗是否中斷其它條

執行對話框拆解

無論哪個入口,點「執行」後會彈一個結構一致的對話框:

參數(variables)區

自動按 workflow.variables 展示每個參數:

  • 有默認值的預填
  • 必填的加紅色星號
  • 有 description 的 hover 可看解釋
  • 枚舉類型用下拉菜單
  • 數組 / 對象類型直接編輯 JSON

Dry-run 開關

強烈建議第一次跑勾選。詳見上面 Quickstart。

觸發來源 (debug)

默認 manual。如果想模擬"定時觸發"或"Webhook 觸發"來調試,可以切換 —— 某些步驟的 condition 可能依賴這個。

Recovery 開關(Pro+)

工作流聲明瞭 recovery.autoResumeOnRestart 時,對話框裡多一個"本次執行是否允許自動續跑"的 toggle。詳見 自動續跑

Debug 開關(Pro+)

勾選後本次執行進入 debug 模式 —— 可以設斷點、單步執行、看變量、修改變量。詳見 斷點調試

啟動後的行為

點「開始執行」後:

  1. 前端立刻創建一個 execution 記錄(狀態 PENDING),頁面自動跳到執行詳情。
  2. 平台调度器拉起执行(通常 < 200ms 内从 PENDING 变 RUNNING)。
  3. 頁面建立 SSE 連接,每個事件推過來實時刷新 UI。
  4. 畫布中"正在跑的 step"被高亮;完成的標綠色,失敗的標紅色。

右側實時事件流

執行詳情頁的右欄是一條"日誌+事件"混合流。重要事件類型:

  • execution.started / execution.finished — 執行的起止
  • step.started / step.completed / step.failed / step.skipped — 步驟生命週期
  • step.log — code step 的 stdout / stderr
  • agent.message — Agent 的一條中間發言(group_chat 裡最常見)
  • agent.tool_call — Agent 調了一個工具 + 參數 + 返回值
  • artifact.emitted — 產生了一份產物(Markdown / Excel / 圖像 / JSON)
  • breakpoint.hit — 命中了斷點
  • approval.requested / approval.granted / approval.denied

每個事件帶時間戳、層級(debug / info / warn / error)、歸屬 step。過濾欄可以按類型 / 層級篩選。

中途取消

執行詳情頁右上角的「取消」按鈕可以主動停止一個 RUNNING 的 execution:

  1. 狀態先變成 CANCELLING
  2. 當前正在跑的 step 收到中斷信號(code step 會收到 SIGTERM,LLM step 主動 abort)
  3. 所有 step 停下來後狀態變 CANCELLED

有些耗時操作(長網絡超時)可能無法立刻響應 —— 沙箱級硬超時會兜底,最多 5 分鐘一定能停下。

跑完後怎麼看結果

執行詳情頁

  • 甘特圖 — 整體時間線、每個 step 的耗時
  • step 列表 — 按順序的 step 狀態概覽
  • step 詳情 — 輸入 / 輸出 / 事件日誌 / 工具調用
  • 變量面板 — 這一步執行前的所有可用變量快照
  • 產物欄 — 生成的文件,點開預覽或下載

代幣與成本

頂部摘要條顯示:總耗時、總 tokens (in / out)、總成本 (USD)。點展開可看每個 LLM step 的單獨消耗。

常見操作

用同樣的參數重跑一次

執行詳情頁右上角「重試」按鈕 —— 用這次 execution 的 variables 立刻再發起一次新 execution。方便對比兩次結果。

從中間某一步重跑

點某個 step 旁的「從這一步重試」—— 前面已完成的 step 結果保留,從這一步開始重新走。適合"某個 step 出錯修好後不想從頭再花錢"。

導出執行報告

頂部「導出」可以把整次 execution 的元數據 + step 詳情 + 產物導出為 JSON。適合事後回溯或分享給同事。

什麼時候該用手動執行,什麼時候用其它觸發

  • 手動 — 開發調試、一次性需求、"我現在就想讓它跑"
  • 定時調度 — 固定頻率自動觸發
  • 網路鉤子 — 外部系統事件驅動

下一步