Guanghu Domestic Migration a27e87cb99 chore: import sanitized domestic snapshot for REPO-007
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc

[SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
2026-07-17 15:59:55 +08:00

2.0 KiB
Raw Blame History

第三方服务对接框架

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(模块注册/共享/校验)→ 适配器注册到模块注册中心
  • 神笔马良MagicPenAG-TEAM-05→ 铸渊写代码的能力基座

前置依赖

  • AG-ZY-01 铸渊部署(编程能力)
  • AG-TEAM-05 神笔马良MagicPen写代码的框架
  • AG-USER-03 密钥管理(对接需要密钥)

验收标准

  • 预置服务(钉钉/微信等用户说一句话→5分钟内完成对接
  • 新服务铸渊读API文档→自动写代码→部署→用户授权→完成
  • 适配器统一接口,任意适配器可热插拔