技术架构

系统由登记、匹配、解析、授权和记录五个模块组成,模块之间通过标识和记录版本对齐状态。技术实现服务于身份确认和寻址,不介入业务执行。调用方按标识取得端点,平台按版本判断记录是否一致。

设计目标

架构围绕三件事:身份记录可查询,匹配结果可核对,调用过程可追溯。每个模块只处理职责内的字段,业务正文不进入平台。

模块之间以标识和记录版本对齐。登记产生版本,匹配和解析读取版本,授权按版本判断范围,记录保存本次请求的结果。

技术实现不改变业务分工。平台只保存身份、匹配、授权和记录字段,业务正文留在参与方系统,调用结果不经过平台转发。

模块职责

模块边界清晰,便于接入方判断问题归属。身份问题查登记,找不到目标查匹配,端点问题查解析,权限问题查授权,历史问题查记录。

模块之间不共享业务数据,只共享标识、版本和授权判断结果。一个模块的职责变化,不影响其他模块的字段定义。

模块职责不处理
登记主体、标识、能力和端点登记不保存业务正文
匹配按标识或能力筛选候选不评价 Agent 业务效果
解析返回端点、版本和状态不保证目标服务可用性
授权判断调用方是否在范围内不代替业务合同
记录保存匹配、调用和变更记录不修改登记内容

数据流

数据流单向推进,前一步不通过时不进入下一步。材料不齐不生成标识,授权不通过不返回端点。

  1. 开发方提交材料,登记模块生成标识和版本。
  2. 调用方提交匹配请求,匹配模块筛选候选。
  3. 授权模块按双方标识判断范围。
  4. 解析模块返回端点和版本。
  5. 记录模块保存本次请求结果。

版本一致性

登记、匹配和解析都以记录版本为准。版本不一致时,系统返回版本错误,不拼接旧数据。调用方收到版本错误后应重新匹配。

端点、能力摘要和授权范围变化时递增版本,标识保持不变。这样可以在不改变调用方引用的情况下完成更新。

版本号由登记模块生成,匹配、解析和授权读取同一版本。读取到旧版本时返回错误,调用方重新匹配取得新版本后再调用。

记录与变更

记录模块只追加记录,不覆盖历史结果。需要更正时新增一条变更记录,保留原记录,便于回溯匹配和调用过程。

记录用于核对目标、排查失败和确认授权范围,不保存业务正文。

追加记录的方式便于核对历史。变更记录与原记录同时保留,出现争议时可以按时间和版本还原处理过程。

  • 匹配记录:请求编号、调用方、目标与所选版本。
  • 调用记录:双方标识、时间与结果状态。
  • 变更记录:变更字段、前后版本与提交时间。

了解安全边界

查看身份、凭据、授权、数据和记录的控制方式,确认接入后需要承担的责任。

查看安全与边界