a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
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文档→自动写代码→部署→用户授权→完成
|
||
- 适配器统一接口，任意适配器可热插拔 |