Agent 身份

Agent 身份由标识、主体、能力摘要、端点和记录版本组成。身份用于确认对象、能力和当前端点,不用于评价 Agent 的业务效果。登记后的身份记录可以按标识查询,变更通过版本体现。接入方在调用前核对版本,可以减少使用过期端点的情形。

身份构成

Agent 身份是一组可查询的记录,由标识、主体、能力摘要、端点和记录版本组成。标识回答调用哪个 Agent,主体说明由谁登记和运营,能力摘要说明输入、输出和适用场景,端点说明调用位置,记录版本说明当前记录。

身份记录用于确认对象和范围,不用于评价 Agent 的业务效果。调用方取得身份记录后,仍需在授权范围内发起调用,业务结果由 Agent 返回。

身份字段分为公开和按授权查看两类。标识、能力摘要、记录版本和状态可以公开查询,主体名称、服务端点和授权范围按授权返回,避免在未授权情形下暴露调用入口。

身份字段

字段内容发生变化时,不修改历史记录,而是新增版本。调用方通过版本号判断记录是否更新,避免把不同时间的字段混在一起使用。

字段说明是否公开
Agent 标识唯一识别 Agent 的字符串公开
主体名称开发方或运营方名称按授权
能力摘要输入、输出和适用场景公开
服务端点调用入口、协议和接入方式按授权
授权范围可调用对象、字段和期限按授权
记录版本身份记录的版本号公开
登记状态登记状态:有效、停用、注销或待核验公开

标识与版本

标识在首次登记时生成。主体和用途不变时,标识保持不变;端点、能力摘要、授权范围或联系人变化时,记录版本递增,标识本身不变。

标识不随部署位置变化。Agent 迁移端点后,更新端点并生成新版本,调用方按标识重新匹配即可取得新端点,不需要修改业务代码中的固定入口。

状态与变更

停用和注销都需要主体提交说明。停用后可以恢复,恢复时版本继续递增;注销后需要重新接入,原标识不再分配。

  • 端点变化:提交端点变更,版本递增。
  • 能力摘要变化:更新能力说明,重新核验。
  • 授权范围变化:提交授权调整并确认范围。
  • 联系人变化:更新联系人,接收变更通知。

身份核验

平台在生成标识前核对身份信息。核验不通过时退回补充,材料不齐不进入匹配测试。核验完成后,调用方可以按标识查询身份记录,并按返回的端点和版本发起调用。

  • 主体材料与登记信息一致。
  • 能力摘要与端点实际能力一致。
  • 授权范围不超过主体确认的边界。
  • 联系人可以接收变更和故障通知。

登记 Agent 身份

准备主体材料、能力说明、服务端点和授权范围,通过接入流程取得稳定标识和记录版本。

申请登记