新创建的waker需通过cli、quest会话或webhook显式触发任务,因其本身仅为执行容器。cli方式最底层可控,需确认在线状态、构造submit命令并执行;quest支持自然语言指令或快捷卡片;webhook适用于外部系统集成,须带有效签名和合规payload。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让新创建的Waker立即执行一个具体任务,比如触发紧急回滚、提交日志快照或拉取最新PR列表,但点击“创建完成”后界面没有自动跳转到任务发送入口,也没有明显的“运行”按钮——这是因为QoderWake中Waker本身只是执行体容器,任务必须通过独立的触发通道显式投递,不能靠Waker界面直接唤起。
通过CLI命令行向Waker发送任务
这是最底层、最可控的方式,适用于调试、自动化脚本集成或需精确控制参数的场景。
第一步:确认Waker已启用且处于在线状态。在终端执行qw list --active,输出中目标Waker的STATUS列必须为【online】,若显示offline或pending,请先检查其绑定的数字员工是否已通过实名认证并完成首次心跳注册。
第二步:构造submit命令。格式为qoderwake submit --waker-id <waker_id> --event-type <type> --payload <json_string></json_string></type></waker_id>,其中--waker-id必须与Waker详情页URL末尾的UUID完全一致(例如https://app.qoder.com/waker/8a3f9c1e-2b4d-4e8f-9a0c-7d6e5f1a2b3c中的8a3f9c1e-2b4d-4e8f-9a0c-7d6e5f1a2b3c)。
第三步:执行命令。例如:qoderwake submit --waker-id 8a3f9c1e-2b4d-4e8f-9a0c-7d6e5f1a2b3c --event-type rollback --payload '{"env":"prod","target":"main"}'。成功后终端将返回trace_id及HTTP 202 Accepted响应。
通过Quest会话流触发Waker任务
适合日常高频操作,无需离开当前工作界面,支持自然语言描述和上下文感知。
方法一:直接输入指令
在任意Quest会话中,中栏输入框键入/run @waker:8a3f9c1e-2b4d-4e8f-9a0c-7d6e5f1a2b3c rollback --env=prod,回车即触发。注意@waker:前缀不可省略,否则系统会尝试匹配全局事件类型而非定向投递给该Waker。
方法二:使用快捷指令卡片
若该Waker已配置悬浮快捷按钮(见《QoderWake自定义快捷指令》教程),鼠标移至右栏顶部边缘等待2秒,呼出横向面板→找到对应按钮→单击即可。此方式会自动注入预设payload,无需手动拼接JSON。
通过Webhook外部系统调用Waker
当你的CI/CD流水线、监控告警平台或低代码平台需要主动唤醒Waker时,必须使用此方式。所有Webhook请求必须携带有效签名,否则会被沙盒拦截。
第一步:获取Waker专属Webhook URL。进入Waker详情页→「接入设置」→「Webhook端点」,点击「生成新密钥」,系统将生成形如https://api.qoder.com/v1/webhook/waker/8a3f9c1e-2b4d-4e8f-9a0c-7d6e5f1a2b3c?sig=sha256_xxxx的地址。
第二步:构造POST请求。Header中必须包含X-Qoder-Signature: sha256=xxx(签名值由密钥+payload body计算得出),Body为纯JSON,字段需与Waker所绑定的事件Schema严格一致。例如Waker配置了rollback事件,则body至少含{"env":"prod"},缺字段将导致400 Bad Request。
第三步:发送请求。使用curl、Postman或流水线插件发起调用,响应状态码202表示已入队,401表示签名失效,403表示payload校验失败。










