Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
2.0 KiB
2.0 KiB
第三方服务对接框架
ICE编号: AG-USER-04 优先级: P3·规划中 备注: 标准化对接协议·OAuth/APIKey/Webhook三种鉴权·铸渊现场写代码对接·适配器标准接口 | 前置: AG-ZY-01+AG-TEAM-05+AG-USER-03 状态: 待接力 负责人: 自由接单 预计周期: 4~6周
AG-USER-04 · 第三方服务对接框架
定位
让人格体能够对接任何暴露了API的第三方软件。用户说「帮我接钉钉」→人格体自动完成全部技术工作→用户只点授权。
核心功能
- 标准化对接协议(不管接什么软件,走同一套流程)
- 三种鉴权模式适配:OAuth / API Key / Webhook
- 对接代码模板库(常见服务的预置模板,加速对接)
- 铸渊(编程人格体)现场写新对接代码的能力
- 适配器标准接口:send / receive / query / subscribe
- 适配器版本管理(API改版时铸渊自动更新)
完整流程
用户:「帮我把钉钉接进来」
↓
语言人格体:理解意图→拆解为技术需求→转发铸渊
↓
编程人格体(铸渊):
→ 查钉钉API文档
→ 在用户代码仓库写对接代码
→ 配置鉴权·路由·错误处理
→ 部署到用户服务器
↓
弹出授权页→用户点授权→密钥写入(AG-USER-03)
↓
完成:以后用户说「发到钉钉群」→人格体直接调用
与现有架构的关系
- 插座协议v1.0(模块接入标准)→ 对接框架的底层规范
- GMP协议v1.0(模块注册/共享/校验)→ 适配器注册到模块注册中心
- 神笔马良MagicPen(AG-TEAM-05)→ 铸渊写代码的能力基座
前置依赖
- AG-ZY-01 铸渊部署(编程能力)
- AG-TEAM-05 神笔马良MagicPen(写代码的框架)
- AG-USER-03 密钥管理(对接需要密钥)
验收标准
- 预置服务(钉钉/微信等):用户说一句话→5分钟内完成对接
- 新服务:铸渊读API文档→自动写代码→部署→用户授权→完成
- 适配器统一接口,任意适配器可热插拔