开放中心
接入说明
开放中心为具备开发能力的合作方提供统一接入入口。平台关心的是协议是否符合规范，而不是接入方采用什么语言、框架或部署方式。
复制当前文档全文，便于直接交给 AI 生成接入代码、联调脚本或测试样例。
适用对象
- 希望将现有服务、工具、自动化流程或内部能力接入平台的团队。
- 希望将业务能力封装为平台可调用技能的合作方。
- 需要围绕统一协议开展联调、测试、运维和交付的技术团队。
接入原则
协议优先
平台以消息结构和字段语义识别能力，不要求绑定某一种开发语言或 SDK。
本地直连
默认接入入口为本地 Server。联调阶段建议先完成本地协议闭环，再扩展到其他部署形态。
标识稳定
task_id、instance_id、request_id 等标识需要贯穿消息链路，不能随意省略或临时变更。
标准接入流程
- 1与本地 Server 建立 WebSocket 连接。
- 2收到 welcome 消息后，在规定时间内发送 register 完成节点注册。
- 3使用注册成功返回的 client_id 作为 node_id，发送 skill_register 注册技能列表。
- 4根据 execution_mode 接收 skill_start 或 skill_invoke，并按对应协议回传状态、推送或结果。
- 5通过 heartbeat、skill_status、skill_push 等消息维持运行状态同步。
关键标识说明
| 标识 | 产生方 | 作用 | 接入要求 |
|---|---|---|---|
node_id | Server 在注册成功后分配 | 标识当前接入节点 | 后续 skill_register、心跳和相关消息应与该节点保持一致 |
task_id | Server 在任务调度时分配 | 标识一次真实任务上下文 | 对 skill_start、skill_invoke、skill_push、skill_result 非常重要，建议完整透传 |
instance_id | Server 在技能下发前生成 | 标识技能实例 | 后续状态变更、停止和回传需持续使用同一个实例 ID |
request_id | 调用链生成 | 关联阻塞调用、Agent 请求和服务器信息请求 | skill_result、agent_reply、server_info_reply 必须准确回填 |
requestId | 注册与通用响应层使用 | 关联 register / response 这类顶层请求响应 | 与 request_id 并存，命名大小写不能混用 |
重要说明
`task_id` 不是展示字段，而是调度主键
平台会使用 task_id 进行任务绑定、上下文恢复、推送归档、结果同步和部分业务联动。接入方如果省略 task_id，虽然个别场景可能还能靠 instance_id 回补，但会直接增加联调和运行风险。
接入提示
开放中心文档以协议为准，不限定具体开发语言。接入时请优先保证字段名称、标识关联关系、消息方向和返回约束一致。