用途:介绍 Crayon 工作流的三种触发方式——MCP 工具、HTTP Webhook 和 cron 定时调度。
MCP 工具(Claude):run_workflow 按名称运行工作流并传入 JSON 输入,返回 run_id、status 和 result;run_node 运行单个节点(包装为工作流以保证持久性),可选 workflow_name 用于连接解析;list_runs 列出近期运行;get_run 按 ID 获取运行(支持前缀匹配);get_trace 获取含操作树与时序的完整执行轨迹。
Webhook:异步模式 POST /dev/api/workflows/{workflow_name}/start,立即返回 202 与 runId,后台运行,可用 GET /dev/api/runs/{runId} 轮询状态;同步模式 POST /dev/api/workflows/{workflow_name}/run,阻塞至完成,成功返回 200,出错返回 500。两者默认实时执行,请求体传 "test_mode": true 可改为测试模式。测试模式下副作用节点只描述将执行的动作而不真正执行;Webhook 与 cron 默认实时运行。
认证:Webhook 需在 Authorization 头携带 Bearer 令牌,令牌为 auth-server 签名的 Ed25519 JWT。可通过 Dev UI 的 Trigger 标签生成(有效期 7d、30d、90d、365d),或通过 MCP 的 generate_webhook_token,或调用 POST /dev/api/webhook-token 并传 {"expiresIn": "30d"}。URL 格式为 https://{fly_app_name}.fly.dev/dev/api/workflows/{name}/start,工作流名含特殊字符时需 URL 编码。
Cron 调度:auth-server 作为外部调度器按 cron 表达式与时区发送 HTTP 请求,并可从 Fly.io 的 auto_stop 自动唤醒机器。可通过 Dev UI 的 Schedule 标签创建、暂停、恢复、删除,或用 MCP 工具 list_cron_jobs、create_cron_job、update_cron_job、delete_cron_job、list_cron_runs 管理。调度器每 15 秒轮询一次;连续失败 10 次的作业自动禁用;运行状态跟踪触发与工作流结果,状态为 triggered → success | error | timeout。cron 默认实时运行,创建或更新时在输入 JSON 中加 "test_mode": true 可改为测试模式。
限制:资料未提供速率限制、并发上限、令牌撤销方式及具体错误码细节。