# 觸發一次執行 POST /api/webhooks/{id}/trigger → {"executionId": "exec_51a2"} # 輪詢狀態：這次停在了人工審批 GET /api/v1/executions/exec_51a2 → {"status": "AWAITING_APPROVAL"} # 批准後繼續跑（數值可先改再批） POST /api/v1/approvals/{approvalId}/approve # 完成後拿結果和產物 GET /api/v1/executions/exec_51a2/result GET /api/v1/executions/exec_51a2/artifacts
接入路徑
15 分鐘，從建 Webhook 到拿到第一個結果
四個 HTTP 請求跑通全流程，不需要 SDK；任何能發請求的語言都能接。
01建 Webhook，拿 URL 和 Key在控制台給 workflow 加一個 Webhook 觸發器，得到專屬 URL；再建一個 WEBHOOK_TRIGGER 範圍的 API Key。
02一次 POST 觸發執行JSON 頂層欄位自動對應為同名 workflow 變數，也可以用 variableMapping 顯式對應；payload 上限 1MB。
03輪詢執行狀態，拿結果用回傳的 executionId 查執行詳情；跑完後從 result 端點拿輸出，從 artifacts 端點下載檔案。
04要人審的動作走審批 API執行會停在 manual_approval 步驟上；用審批端點列出待批項、批准或拒絕，拒絕或逾時就什麼都不改。
# 第 2 步：從你的系統裡發一次 POST curl -X POST https://your-host/api/webhooks/{id}/trigger \ -H "X-API-Key: <your-api-key>" \ -d '{"ticket_id": "T-1024", "lang": "zh"}' # 頂層欄位自動對應為同名 workflow 變數 → {"executionId": "exec_51a2"} # 第 3 步：輪詢狀態，跑完拿結果 curl https://your-host/api/v1/executions/exec_51a2/result \ -H "X-API-Key: <your-api-key>"
能力清單
寫程式碼的人會在意的六件事
7 種語言的沙箱程式碼步驟Python、JavaScript、TypeScript、Bash、Ruby、Lua、CLI 都能寫；變數以 WF_VAR_* 環境變數注入，預設 30 秒逾時，生產環境跑在受控出網的 Docker 沙箱裡。
YAML 定義，走你的 Git 流程一條 workflow 就是一個 YAML 檔案：提交、diff、回復全在你熟悉的儲存庫裡做；畫布和 YAML 雙向同步，改哪邊都行。
MCP 接入你自己的工具把內部服務包成 MCP Server 掛給 Agent，AI 步驟就能直接呼叫你的系統，不用等平台出連接器。
斷點調試器9 類中斷點，命中即暫停，改完變數繼續；失敗後從指定步驟重跑，已完成的 LLM 步驟不重複計費。
14 端點 v1 API，最小權限觸發執行、查結果、批審批、下載產物各有獨立的權限範圍；6 種範圍按需組合，給每個接入系統發各自的 Key。
鏈式觸發 DELAYED_COMPLETIONA 跑完後 N 秒自動觸發 B，可設 maxRuns 上限；長流程拆成幾段，每段單獨看日誌和成本。
誠實邊界
三件事，先說在前面
省得接到一半才發現。
沒有幾百個 SaaS 連接器對外部系統的呼叫寫在程式碼步驟裡，或者包成 MCP 工具掛給 Agent；對寫程式碼的團隊，這一步就是幾行 HTTP 請求。
沒有執行前成本預估 API每次執行的 token 用量和成本都逐次記錄，事後核算是細的；但執行之前拿不到報價，預算控制要靠審批門控和 maxRuns。
限制先寫在明面上Webhook payload 上限 1MB；程式碼步驟預設 30 秒逾時；HMAC-SHA256 簽章只作為相容模式保留，新接入用 API Key。