Agent 寻址

Agent寻址为独立 Agent 提供自助接入、身份与鉴权、调用方式与错误处理。开发者完成登记后获得稳定标识,调用方按标识取得服务地址并发起业务请求;出现异常时,按接入、鉴权、寻址、调用、记录五类定位,减少逐个通知与重复配置。

产品能力

平台把 Agent 的接入、身份、寻址与记录分开处理。开发者登记一次名称、能力、服务端点与授权范围,即可获得稳定标识;调用方不需要保存固定地址,按标识查询就能取得当前端点。标识在端点调整后保持不变,调用方重新寻址即可继续使用。

身份与鉴权维护能力说明、端点与授权范围,变更通过登记更新并形成新的记录版本;调用寻址返回端点、版本与可用字段;调用记录保存记录编号、调用方、目标、状态与时间,便于核对与排查。四类能力各自独立,出现问题时可以判断环节,不必整体重做接入。

标识、凭据、端点与授权各自有明确用途:标识说明目标,凭据说明调用方,端点说明请求去向,授权说明可用范围。四者分开说明后,排查不必依赖对内部部署的了解,调用方也能按公开规则准备请求。

  • 接入登记:提交主体材料、Agent 能力与服务端点,取得 Agent 标识。
  • 身份与鉴权:区分目标标识与调用凭据,按授权范围判断能否调用。
  • 调用寻址:按标识返回服务地址、记录版本与可用字段。
  • 调用记录:按记录编号或时间范围查询,用于核对与排查。

适用对象

适合一个人维护 Agent 的独立开发者,也适合需要统一管理多个 Agent 的小团队。企业内部系统之间需要确认身份与端点时,同样可以使用登记与寻址能力。接入方需要自行维护端点、凭据与回调地址,并对 Agent 的业务结果负责;平台只处理身份、端点、授权与记录。

  • 独立开发者:一个人维护一个或多个 Agent,希望调用方能按标识找到服务。
  • 小型团队:多个 Agent 需要统一身份、端点与授权说明。
  • 企业创新团队:内部系统之间调用 Agent,需要确认调用方身份。
  • 同一开发者管理多个 Agent:按主体和用途统一登记,减少逐个维护地址。

接入流程

接入采用自助方式,五步都有对应的确认结果。联调通过前只使用沙箱凭据,避免测试流量进入正式环境。正式启用后,端点、能力说明、授权范围或联系人变化通过变更事项更新,标识保持不变,调用方按标识重新寻址即可。

五步之间不跳步,也不以口头确认代替登记。联调记录与正式记录分开核对,确认字段、错误返回和授权范围一致后再放量使用;出现差异时按版本与记录编号回溯。

  1. 注册完成:主体与联系人信息进入待核对状态。
  2. 创建完成:名称、用途、能力说明与回调地址写入登记。
  3. 沙箱就绪:测试端点与回调可用沙箱凭据调用。
  4. 联调通过:返回字段与错误说明核对一致。
  5. 正式启用:正式凭据生效,沙箱凭据同时停用。

应用场景

独立开发者把检索、生成、通知等 Agent 分别登记,按能力说明对外提供服务。端点调整后更新登记,调用方重新寻址即可,不需要逐个通知修改地址;按用途拆分标识后,停用其中一个也不会影响其他服务。

小型团队用标识区分不同用途的 Agent,减少口头对接与手工配置;企业内部系统在调用前确认身份与授权,调用记录用于核对请求;同一开发者管理多个 Agent 时,按主体和用途统一登记,调用方按标识分别寻址。

四类接入方使用同一套标识与记录规则。规模扩大后增加的是 Agent 数量与调用方数量,登记、鉴权与寻址的做法不变,维护人仍可按 Agent 分别管理。

办理须知

登记前准备主体名称、联系人、Agent 名称与用途、服务端点、协议类型、输入输出字段与错误返回。材料完整可以减少往返核对,也便于一次说明沙箱范围与正式切换安排。

  • 调用凭据只在创建时显示一次,请当场妥善保存;遗失后停用并重建。
  • 沙箱凭据只用于测试端点与回调,不用于正式调用。
  • 平台不保存业务正文,不评价 Agent 效果,不保证业务结果。
  • 涉及个人信息或受限数据时,接入方在提交前完成脱敏,并按授权范围调用。
  • 日常调整走变更事项,按变化类型提交,标识继续沿用。

开始接入

准备主体信息、Agent 能力与端点材料,提交接入申请,按五步完成登记与联调。

申请接入