QoderWake自动化任务必须通过API触发，需先创建应用获取client_id与client_secret，再换取access_token；调用/v1/quest/start启动任务，严格遵循Quest规范；高危操作须调用/v1/quest/{id}/confirm二次确认；轮询状态时避免限流，最终根据state下载产物或处理失败原因。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
您需要让QoderWake在收到外部系统通知后立即执行代码扫描、审批流转或告警响应等自动化任务，而不是依赖人工点击或定时器——这必须通过API触发实现，否则任务永远停留在待命状态。
获取并配置有效访问凭证
所有API调用都必须携带合法身份凭证，缺失或过期将直接返回401错误，且不会记录任何调试痕迹。
登录QoderWake管理后台，进入【开发者中心】→【应用管理】页面，点击“新建应用”，填写名称为“CRM告警联动”，回调域名填入https://crm.example.com，勾选task.execute与event.write权限。
保存后系统生成client_id与client_secret，【务必立即复制client_secret并离线保存，该值仅显示一次】。
向https://api.qoder.com/v1/auth/token发送POST请求，Body为x-www-form-urlencoded格式，包含grant_type=client_credentials、client_id与client_secret。响应中提取access_token字段值，有效期24小时。
构造标准任务启动请求
QoderWake不接受任意JSON结构，必须严格遵循Quest规范，否则解析失败即终止，不触发重试。
向https://api.qoder.com/v1/quest/start发送POST请求，Header中设置Authorization: Bearer 此处填入获取到的token值与X-QoderWake-Workspace-ID: wk-7a3f9b2e（工作区ID需从控制台「工作区设置」中复制）。
请求体JSON必须包含spec字段，其下至少定义type（如code.scan）、target（如repo:gitlab/internal/backend）和urgency（low/medium/high），缺一不可。
若spec中未声明input_schema匹配的参数，例如code.scan类型缺少branch_name字段，接口将返回422错误并附带缺失字段清单，任务不会进入排队队列。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
完成高危操作显式授权
当任务涉及代码推送、数据库变更或生产环境重启时，QoderWake强制要求二次确认，这是不可绕过的安全红线。
第一步：收到初始响应后，提取其中quest_id值（形如qst-8d4c1f9a）。
第二步：立即调用/v1/quest/{id}/confirm接口，发送空JSON Body，Header保持相同鉴权头。
第三步：仅当该接口返回200 OK，任务才真正进入执行队列；若超时未确认，quest_id将在15分钟后自动失效，需重新发起/start请求。
轮询并获取执行结果
不要用固定间隔死循环轮询，QoderWake对高频/status请求实施令牌桶限流，连续5次429错误将临时封禁该API Key。
调用/v1/quest/{id}/status获取当前状态，响应中state字段可能为Action Required（等待确认）、Running、Ready或Failed。
当state为Ready时，调用/v1/quest/{id}/artifacts下载产物包，响应为zip二进制流，文件名固定为artifact-{quest_id}.zip。
若state为Failed，响应body中error_code字段会明确标出原因，例如permission.denied表示数字员工无对应仓库写权限，需回退至「Agent管理」调整角色策略。
