产品能力

Agent寻址提供接入登记、身份与鉴权、调用寻址与调用记录四项能力。开发者登记一次身份,调用方按标识取得端点并完成调用,不需要在调用方保存固定地址,也不必为每次端点调整重复对接;能力范围以接入时确认的内容为准。

能力总览

四项能力可以单独使用,也可以组合使用。接入登记是入口,身份、寻址与记录围绕登记内容展开;登记内容变化时形成新的记录版本,调用方按版本判断是否需要同步调整。

能力作用结果
接入登记提交 Agent 材料、能力与服务端点取得 Agent 标识
身份与鉴权维护能力说明、端点与授权范围形成新的记录版本
调用寻址按标识返回端点、版本与可用字段调用方取得服务地址
调用记录保存记录编号、调用方、目标 Agent、状态与时间可核对、可排查

接入登记与身份鉴权

接入登记接收 Agent 名称、用途、能力说明、服务端点、协议类型、输入输出字段与错误返回,核对后分配标识。标识用于识别目标,登记内容形成记录版本,后续变化按版本递增,调用方可以据此确认当前端点是否有效。

身份与鉴权维护能力说明、端点与授权范围。授权范围说明可调用的字段与期限,由目标 Agent 主体确认;调用凭据用于证明调用方身份,与目标标识分开保管,避免把公开的定位信息当成调用权限。

登记与身份信息以记录版本为准。调用方看到版本变化时,按当前端点与字段调整,不使用旧版本继续请求;接入方也不需要为每次调整重新走一遍注册流程。

调用寻址与记录

调用方按标识发起寻址,节点校验调用方身份与目标状态,判断是否在授权范围内,返回端点、记录版本与可用字段。超出授权范围的请求不返回结果;标识不存在或目标停用时返回对应错误,调用方按类型处理。

每次寻址与调用形成记录,包含记录编号、调用方、目标 Agent、状态与时间,可按记录编号或时间范围查询。记录用于核对与排查,不包含业务正文;业务结果由调用方与目标 Agent 直接交换,平台不留存内容。

适合的使用者

这些使用者的共同点是:Agent 由自己维护,端点可能调整,调用方不止一个。通过统一标识与登记更新,可以减少逐个通知与重复配置,也能在出现问题时按记录定位到具体调用。

  • 独立开发者:一个人维护一个或多个 Agent,需要稳定的对外标识。
  • 小型团队:需要统一管理 Agent 身份、端点与授权说明。
  • 企业创新团队:在内部系统之间调用 Agent,需要确认调用方身份。
  • 多 Agent 开发者:为多个 Agent 分别登记,按用途管理标识。

能力边界

平台不替 Agent 执行业务任务,不保存业务正文,不评价 Agent 效果,也不保证业务结果。平台处理的是身份、端点、授权与调用记录,业务能力由 Agent 自身提供,质量与可用性由接入方维护。

业务请求的超时、重试与结果处理由调用方按自身业务规则决定;端点不可达时联系目标主体,不通过反复请求绕过问题。需要调整授权或端点时,按登记流程办理。

能力范围以接入时确认的清单为准。未确认的能力不默认提供,需要增加时按变更事项办理;平台不因登记而获得 Agent 业务内容的处置权。

查看接入流程

了解自助注册、创建 Agent、配置沙箱、联调测试与切换正式的具体安排。

查看接入流程