设计目标
架构围绕三件事:身份记录可查询,匹配结果可核对,调用过程可追溯。每个模块只处理职责内的字段,业务正文不进入平台。
模块之间以标识和记录版本对齐。登记产生版本,匹配和解析读取版本,授权按版本判断范围,记录保存本次请求的结果。
技术实现不改变业务分工。平台只保存身份、匹配、授权和记录字段,业务正文留在参与方系统,调用结果不经过平台转发。
模块职责
模块边界清晰,便于接入方判断问题归属。身份问题查登记,找不到目标查匹配,端点问题查解析,权限问题查授权,历史问题查记录。
模块之间不共享业务数据,只共享标识、版本和授权判断结果。一个模块的职责变化,不影响其他模块的字段定义。
| 模块 | 职责 | 不处理 |
|---|---|---|
| 登记 | 主体、标识、能力和端点登记 | 不保存业务正文 |
| 匹配 | 按标识或能力筛选候选 | 不评价 Agent 业务效果 |
| 解析 | 返回端点、版本和状态 | 不保证目标服务可用性 |
| 授权 | 判断调用方是否在范围内 | 不代替业务合同 |
| 记录 | 保存匹配、调用和变更记录 | 不修改登记内容 |
数据流
数据流单向推进,前一步不通过时不进入下一步。材料不齐不生成标识,授权不通过不返回端点。
- 开发方提交材料,登记模块生成标识和版本。
- 调用方提交匹配请求,匹配模块筛选候选。
- 授权模块按双方标识判断范围。
- 解析模块返回端点和版本。
- 记录模块保存本次请求结果。
版本一致性
登记、匹配和解析都以记录版本为准。版本不一致时,系统返回版本错误,不拼接旧数据。调用方收到版本错误后应重新匹配。
端点、能力摘要和授权范围变化时递增版本,标识保持不变。这样可以在不改变调用方引用的情况下完成更新。
版本号由登记模块生成,匹配、解析和授权读取同一版本。读取到旧版本时返回错误,调用方重新匹配取得新版本后再调用。
记录与变更
记录模块只追加记录,不覆盖历史结果。需要更正时新增一条变更记录,保留原记录,便于回溯匹配和调用过程。
记录用于核对目标、排查失败和确认授权范围,不保存业务正文。
追加记录的方式便于核对历史。变更记录与原记录同时保留,出现争议时可以按时间和版本还原处理过程。
- 匹配记录:请求编号、调用方、目标与所选版本。
- 调用记录:双方标识、时间与结果状态。
- 变更记录:变更字段、前后版本与提交时间。