QoderWake需通过Connector机制接入企业系统，依赖预定义配置与权限沙盒：一、启用Connector模块；二、配置HTTP/HTTPS API端点；三、注入KMS托管的鉴权凭证；四、映射外部数据至QoderWake Schema；五、绑定权限红线与审计策略。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将QoderWake接入企业已有系统并实现API调用与数据互通，则需通过其Connector机制完成第三方系统对接。QoderWake不提供通用API密钥管理界面，所有外部系统连接均依赖于预定义的Connector配置与权限沙盒约束。以下是具体配置步骤：
一、启用QoderWake Connector模块
Connector是QoderWake与外部系统建立安全通信的唯一通道，所有对接必须在启用该模块后进行。该模块默认关闭，需管理员在QoderWake控制台中手动激活，并绑定对应数字员工身份。
1、登录QoderWake管理控制台，进入「Agent管理」→「数字员工列表」。
2、选择目标数字员工，点击「编辑配置」→「扩展能力」标签页。
3、找到「Connector接入模块」开关，将其设置为启用状态。
4、保存配置后，系统将自动加载Connector基础运行时环境，等待下一步凭证注入。
二、配置HTTP/HTTPS外部API端点
QoderWake仅支持通过标准HTTP/HTTPS协议调用外部RESTful接口，不支持WebSocket、gRPC或数据库直连。所有请求地址必须携带完整协议头与路径，且需确保网络可达性与TLS证书有效性。
1、在Connector配置页点击「新增连接器」，选择「自定义HTTP API」类型。
2、输入目标系统API的完整URL，例如：https://api.hr-system.example.com/v2/users?status=active。
3、在「请求头（Headers）」区域添加必要认证字段，如Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...。
4、勾选「启用响应校验」，并填入预期的HTTP状态码范围（如200–299），防止无效响应被误解析。
三、注入鉴权凭证与动态参数
QoderWake禁止明文存储敏感凭证，所有密钥类参数必须通过环境变量注入或由QoderWake内置密钥管理服务（KMS）托管。URL中不得硬编码密钥，应使用${VAR_NAME}占位符引用。
1、进入「安全中心」→「凭证管理」，点击「新建凭证」，类型选择「API Token」。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
2、粘贴第三方系统颁发的长期Token或OAuth2 Access Token，设置有效期为7天自动轮换（不可设为永不过期）。
3、返回Connector配置页，在URL中将原静态Token替换为${HR_API_TOKEN}，系统将在运行时自动注入。
4、如需传递动态参数（如当前数字员工ID），在「请求参数」栏添加键值对：agent_id=${AGENT_ID}。
四、映射外部数据结构至QoderWake Schema
QoderWake要求所有接入系统的返回数据必须符合其预定义的Schema规范，否则将触发数据清洗失败并中断流程。部门与用户字段命名、类型、必填性均不可偏离官方文档定义。
1、下载QoderWake官方Schema模板（JSON Schema v4），路径为：https://docs.qoder.com/wake/schema/qoderwake-connector-user-v1.json。
2、对照第三方系统实际返回JSON，使用「字段映射表」逐项对齐：user_id→id、email→contact.email、department_ids→org_unit_ids。
3、在Connector配置页的「响应映射」区域，粘贴转换规则JSON，例如：{"user_id": "$.data.user.id", "email": "$.data.contact.email"}。
4、点击「测试映射」，上传样例响应体，确认所有必填字段解析结果为非空值。
五、绑定权限红线与审计策略
每条Connector连接均需绑定权限红线策略，用于限制其可执行的操作类型与数据访问深度。未绑定红线的Connector无法提交任何写操作请求，仅允许GET类只读调用。
1、在Connector配置页底部，点击「关联权限策略」→「新建策略」。
2、策略名称填写为HR-READONLY-NO-DELETE，操作类型勾选「允许GET」，禁用「POST/PUT/DELETE」。
3、在「数据范围限制」中指定可访问字段白名单，例如仅允许返回user_id、name、email、department_ids，屏蔽salary、id_card等敏感字段。
4、启用「操作留痕」开关，确保每次调用均写入独立审计日志，日志保留周期设为180天。
