QoderWake怎么用API触发任务执行？-人工智能-PHP中文网

必须通过http请求调用qoderwake api触发任务，需携带event_type与target_context，且强制身份认证：oauth 2.0或api key；调用/v1/skill/execute端点，传skill_id、input_payload、target_workspace；成功返回202及execution_id，可凭此查询执行详情。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

qoderwake怎么用api触发任务执行？

你需要通过HTTP请求调用QoderWake开放API来触发任务执行，而不是在界面点击或发送自然语言指令。QoderWake不响应自由对话，所有任务必须携带明确的event_type与target_context才能激活对应数字员工并加载其长期记忆。

准备有效身份凭证

QoderWake API强制要求身份认证，不支持匿名调用。你必须提前获取合法访问凭据，否则所有请求将被拒绝并返回401错误。

方法一：使用OAuth 2.0客户端凭证授权（推荐用于生产环境）
1、登录QoderWake管理控制台，在「QoderWake > 开发者设置 > OAuth应用」中创建新应用，记录生成的client_id与client_secret。
2、向https://api.qoder.com/v1/auth/token发送POST请求，请求体为application/x-www-form-urlencoded格式，包含grant_type=client_credentials、client_id和client_secret字段。
3、从返回JSON中提取access_token值，并在后续所有API请求头中添加Authorization: Bearer 此处填入获取到的token值。

方法二：使用API Key直连（适用于测试或轻量集成）
1、进入「系统设置 > API密钥管理」，点击「生成新密钥」，权限范围至少勾选task.execute。
2、复制生成的密钥字符串——该字符串以qwk_开头且长度严格为48位。
3、在调用API时，于HTTP请求头中添加X-QoderWake-Api-Key: qwk_xxx，并确保Content-Type设为application/json。

构造并发送任务触发请求

任务触发必须走/v1/skill/execute端点，且请求体需符合QoderWake Schema规范，缺字段或类型错误会导致400响应。

第一步：确认目标Skill已注册并启用
进入「技能中心」→「已发布技能」列表，找到你要调用的Skill，检查其状态是否为“已启用”，并记下skill_id（如sk-7a2f9d4e）。

Agent CLI (Cursor + Qoder)

代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。

下载

第二步：组织请求参数
准备一个JSON对象作为请求体，至少包含以下三个字段：
– skill_id：上一步获取的唯一标识符；
– input_payload：结构化输入数据，例如{"repo_url": "https://github.com/org/repo", "branch": "main"}；
– target_workspace：指定执行上下文，如"prod-db-migration"或"team-audit-sandbox"。

第三步：发起POST请求
使用curl命令示例：

curl -X POST https://api.qoder.com/v1/skill/execute \<br>  -H "Authorization: Bearer eyJhbGciOi..." \<br>  -H "Content-Type: application/json" \<br>  -d '{"skill_id":"sk-7a2f9d4e","input_payload":{"repo_url":"https://github.com/org/repo"},"target_workspace":"prod-db-migration"}'

注意：若请求头中未携带有效Authorization或X-QoderWake-Api-Key，服务器将立即返回401且不记录任何日志。

验证执行结果与调试追踪

成功提交后，QoderWake会立即返回一个带execution_id的响应体，这是后续排查问题的关键线索。

1、检查HTTP响应状态码：202 Accepted表示任务已入队，非202即失败；
2、提取响应体中的execution_id字段（如"exec_9b3c8f1a"），它可用于查询执行详情；
3、调用GET /v1/execution/{execution_id}接口，获取实时状态、trace_id、开始时间、退出码及标准输出摘要；
4、若状态为failed，重点查看error_message字段内容，常见原因包括input_payload缺失必填字段、target_workspace不存在、或Skill内部逻辑抛出异常。

这一步操作起来很简单，直接把execution_id粘贴进调试接口URL里就能看到完整执行链路。