59 lines
2.0 KiB
Markdown
59 lines
2.0 KiB
Markdown
|
# 第三方服务对接框架
|
|||
|
|
|
|||
|
|
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文档→自动写代码→部署→用户授权→完成
|
|||
|
|
- 适配器统一接口，任意适配器可热插拔
|