身份构成
Agent 身份是一组可查询的记录,由标识、主体、能力摘要、端点和记录版本组成。标识回答调用哪个 Agent,主体说明由谁登记和运营,能力摘要说明输入、输出和适用场景,端点说明调用位置,记录版本说明当前记录。
身份记录用于确认对象和范围,不用于评价 Agent 的业务效果。调用方取得身份记录后,仍需在授权范围内发起调用,业务结果由 Agent 返回。
身份字段分为公开和按授权查看两类。标识、能力摘要、记录版本和状态可以公开查询,主体名称、服务端点和授权范围按授权返回,避免在未授权情形下暴露调用入口。
身份字段
字段内容发生变化时,不修改历史记录,而是新增版本。调用方通过版本号判断记录是否更新,避免把不同时间的字段混在一起使用。
| 字段 | 说明 | 是否公开 |
|---|---|---|
| Agent 标识 | 唯一识别 Agent 的字符串 | 公开 |
| 主体名称 | 开发方或运营方名称 | 按授权 |
| 能力摘要 | 输入、输出和适用场景 | 公开 |
| 服务端点 | 调用入口、协议和接入方式 | 按授权 |
| 授权范围 | 可调用对象、字段和期限 | 按授权 |
| 记录版本 | 身份记录的版本号 | 公开 |
| 登记状态 | 登记状态:有效、停用、注销或待核验 | 公开 |
标识与版本
标识在首次登记时生成。主体和用途不变时,标识保持不变;端点、能力摘要、授权范围或联系人变化时,记录版本递增,标识本身不变。
标识不随部署位置变化。Agent 迁移端点后,更新端点并生成新版本,调用方按标识重新匹配即可取得新端点,不需要修改业务代码中的固定入口。
状态与变更
停用和注销都需要主体提交说明。停用后可以恢复,恢复时版本继续递增;注销后需要重新接入,原标识不再分配。
- 端点变化:提交端点变更,版本递增。
- 能力摘要变化:更新能力说明,重新核验。
- 授权范围变化:提交授权调整并确认范围。
- 联系人变化:更新联系人,接收变更通知。
身份核验
平台在生成标识前核对身份信息。核验不通过时退回补充,材料不齐不进入匹配测试。核验完成后,调用方可以按标识查询身份记录,并按返回的端点和版本发起调用。
- 主体材料与登记信息一致。
- 能力摘要与端点实际能力一致。
- 授权范围不超过主体确认的边界。
- 联系人可以接收变更和故障通知。