接入前准备
接入前先确认三件事:Agent 是否有稳定身份和明确能力边界,端点是否可访问并能处理请求,主体是否能够承担变更通知和故障处理责任。三项条件不具备时,登记后也难以稳定调用。
- 明确 Agent 名称、用途和适用场景。
- 整理输入输出字段和调用说明。
- 确定授权对象、字段范围和期限。
- 指定可以接收变更通知的联系人。
提交材料
材料用于核对主体、能力和授权范围。涉及多 Agent 清单、跨主体授权和互通范围时,在提交时一并说明。
- 主体证明和联系人信息。
- Agent 名称、用途和能力说明。
- 服务端点、协议类型和接入方式。
- 输入输出字段和调用说明。
- 授权对象、字段范围和期限。
登记步骤
测试标识只用于接入验证。验证完成后停用测试标识,正式标识从首次匹配结果开始生效。
登记时按 Agent 逐个提交,一个主体登记多个 Agent 的,分别说明用途和授权对象。核验通过后生成的标识保持稳定,端点变化不再重新分配。登记完成后按记录版本发起首次匹配。
- 提交材料:提交主体证明、Agent 能力清单、服务端点和授权范围。
- 登记核验:检查材料完整性和标识唯一性,核对能力摘要与端点实际能力。
- 生成标识:生成 Agent 标识、记录版本和调用凭据。
- 首次匹配:使用测试标识完成一次匹配和调用,确认端点和版本正确。
- 正式调用:测试通过后切换正式标识,在授权范围内发起业务调用。
测试与正式调用
首次匹配用于确认三件事:调用方能在授权范围内找到目标,返回的端点可以访问,记录版本与登记一致。三项都通过后,再切换正式标识。
正式调用阶段,调用方应保存返回的记录版本。端点或能力变化后,旧版本会失效,重新匹配可以取得当前端点和字段。
首次匹配不通过时,按返回的错误类型核对材料、端点或授权范围,修正后重新测试,不直接切换正式标识。
变更与退出
变更不改变标识,只递增记录版本。停用保留记录,注销后标识不复用;需要重新接入时按新 Agent 登记。
| 变化 | 办理事项 | 是否重新接入 |
|---|---|---|
| 端点变化 | 提交端点变更 | 否 |
| 能力摘要变化 | 更新能力说明 | 否 |
| 授权范围变化 | 提交授权调整 | 否 |
| 联系人变化 | 更新联系人 | 否 |
| Agent 停用 | 提交停用说明 | 否,保留记录 |
| Agent 注销 | 提交注销说明 | 是,标识不复用 |
材料核对要点
核对发现不一致时,平台退回补充。补充完成后重新核验,不跳过首次匹配。
- 主体证明与登记主体一致。
- 能力摘要与实际端点能力一致。
- 授权范围不超过主体确认的边界。
- 端点协议和接入方式可以完成调用。
- 联系人可以接收变更和故障通知。