注册与接入

注册与接入分为提交材料、登记核验、生成标识、首次匹配和正式调用五步。材料不齐时不进入匹配测试,测试标识不进入正式匹配结果。接入方需要说明 Agent 能力、端点、授权范围和联系人,按步骤准备可以减少往返补充。

接入前准备

接入前先确认三件事:Agent 是否有稳定身份和明确能力边界,端点是否可访问并能处理请求,主体是否能够承担变更通知和故障处理责任。三项条件不具备时,登记后也难以稳定调用。

  • 明确 Agent 名称、用途和适用场景。
  • 整理输入输出字段和调用说明。
  • 确定授权对象、字段范围和期限。
  • 指定可以接收变更通知的联系人。

提交材料

材料用于核对主体、能力和授权范围。涉及多 Agent 清单、跨主体授权和互通范围时,在提交时一并说明。

  • 主体证明和联系人信息。
  • Agent 名称、用途和能力说明。
  • 服务端点、协议类型和接入方式。
  • 输入输出字段和调用说明。
  • 授权对象、字段范围和期限。

登记步骤

测试标识只用于接入验证。验证完成后停用测试标识,正式标识从首次匹配结果开始生效。

登记时按 Agent 逐个提交,一个主体登记多个 Agent 的,分别说明用途和授权对象。核验通过后生成的标识保持稳定,端点变化不再重新分配。登记完成后按记录版本发起首次匹配。

  1. 提交材料:提交主体证明、Agent 能力清单、服务端点和授权范围。
  2. 登记核验:检查材料完整性和标识唯一性,核对能力摘要与端点实际能力。
  3. 生成标识:生成 Agent 标识、记录版本和调用凭据。
  4. 首次匹配:使用测试标识完成一次匹配和调用,确认端点和版本正确。
  5. 正式调用:测试通过后切换正式标识,在授权范围内发起业务调用。

测试与正式调用

首次匹配用于确认三件事:调用方能在授权范围内找到目标,返回的端点可以访问,记录版本与登记一致。三项都通过后,再切换正式标识。

正式调用阶段,调用方应保存返回的记录版本。端点或能力变化后,旧版本会失效,重新匹配可以取得当前端点和字段。

首次匹配不通过时,按返回的错误类型核对材料、端点或授权范围,修正后重新测试,不直接切换正式标识。

变更与退出

变更不改变标识,只递增记录版本。停用保留记录,注销后标识不复用;需要重新接入时按新 Agent 登记。

变化办理事项是否重新接入
端点变化提交端点变更否
能力摘要变化更新能力说明否
授权范围变化提交授权调整否
联系人变化更新联系人否
Agent 停用提交停用说明否,保留记录
Agent 注销提交注销说明是,标识不复用

材料核对要点

核对发现不一致时,平台退回补充。补充完成后重新核验,不跳过首次匹配。

  • 主体证明与登记主体一致。
  • 能力摘要与实际端点能力一致。
  • 授权范围不超过主体确认的边界。
  • 端点协议和接入方式可以完成调用。
  • 联系人可以接收变更和故障通知。

开始接入

准备主体证明、Agent 清单、服务端点、授权范围和联系人信息,提交后按五步流程完成登记。

申请接入