QoderWake数字员工需先确保沙盒就绪并完成Jenkins联动配置。检查“数字程序员”实例状态为Ready，填写环境URL、凭证、快照ID；按权限选Webhook桥接、SDK反向接管或声明式协同；在事件总线配置HTTP回调端点并启用；最后通过curl测试验证连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让QoderWake数字员工自动完成代码构建、测试、部署全流程，但卡在CI/CD配置环节，找不到入口或不确定该填什么参数——这通常是因为Jenkins与QoderWake的协同路径未对齐，或沙盒环境尚未绑定真实执行上下文。
确认QoderWake沙盒已就绪
QoderWake必须先拉起一个具备完整工具链的隔离容器，才能承接CI/CD任务。跳过此步会导致后续所有调用返回“sandbox not found”错误。
登录QoderWake管理控制台→进入“角色部署”页面→找到已启用的“数字程序员”实例→点击右侧“状态检查”按钮。
若状态显示为“Ready”，说明Docker容器、浏览器内核、设备驱动均已加载完毕；若显示“Pending Init”，需返回环境绑定表单，确认测试环境URL、加密凭证、数据快照ID三项是否全部填写且无空格残留——【空格会导致同步初始化失败且无明确报错】。
选择Jenkins联动路径
根据你的运维权限和基础设施现状，从以下三种方式中选一种执行：
方法一：Webhook事件桥接（适合已有稳定Jenkins主节点，且无法修改Agent权限）
在Jenkins中安装Generic Webhook Trigger Plugin→为Pipeline项目配置Webhook URL与Secret Token→在Git仓库设置Payload URL指向该地址→Jenkinsfile末尾添加curl命令调用QoderWake沙盒API。
方法二：Connector SDK反向接管（适合希望彻底清除本地环境差异的团队）
在QoderWake控制台「Connector管理」中创建Jenkins类型实例→获取connector_id与webhook_secret→在Jenkins系统配置中新增「QoderWake Agent」并填入connector_id→启用自动注册模式。
方法三：声明式协同（适合已使用Jenkinsfile统一管理环境策略的成熟团队）
在Jenkinsfile中声明qoderwake_runtime_profile字段→指定沙盒镜像版本、内存限制、超时阈值→QoderWake Runtime Profile将自动校验该配置是否匹配已注册的沙盒模板。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
配置QoderWake端回调接收
第一步：在QoderWake控制台进入「事件总线」→点击「新建回调端点」→协议选择HTTP，URL填写Jenkins的接收地址（如https://jenkins.example.com/qoder-callback），验证方式选HMAC-SHA256，密钥填入与Jenkins中一致的Secret Token。
第二步：勾选“仅接收exit_code=0的执行结果”，避免失败构建污染下游流程。
第三步：点击「启用」，系统立即生成回调签名头X-Qoder-Signature，并写入沙盒环境变量QODER_CALLBACK_SIG。
这一步做完后，QoderWake沙盒每次执行完毕都会把结果推送到Jenkins指定地址。
验证CI/CD流水线连通性
步骤一：在Jenkins中新建一个自由风格项目，仅含一个Execute shell构建步骤：
curl -X POST https://api.qoder.com/v1/sandbox/execute -H "Authorization: Bearer ${QODER_TOKEN}" -d '{"task_id":"test-ci-01","env":"dev-sandbox","timeout":300}'
步骤二：保存并立即构建该项目。
步骤三：查看Jenkins控制台输出——若出现“callback_url received, artifact_url: https://artifacts.qoder.com/xxx.zip”，说明QoderWake已成功执行并回传结果；若卡在“Waiting for sandbox response”超过30秒，检查QoderWake服务是否监听9000端口，以及防火墙是否放行TCP 9000。
