# 触发一次执行 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在控制台给工作流加一个 Webhook 触发器，得到专属 URL；再建一个 WEBHOOK_TRIGGER 范围的 API Key。
02一次 POST 触发执行JSON 顶层字段自动映射为同名工作流变量，也可以用 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"}' # 顶层字段自动映射为同名工作流变量 → {"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 流程一条工作流就是一个 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。