能力总览
四项能力可以单独使用,也可以组合使用。接入登记是入口,身份、寻址与记录围绕登记内容展开;登记内容变化时形成新的记录版本,调用方按版本判断是否需要同步调整。
| 能力 | 作用 | 结果 |
|---|---|---|
| 接入登记 | 提交 Agent 材料、能力与服务端点 | 取得 Agent 标识 |
| 身份与鉴权 | 维护能力说明、端点与授权范围 | 形成新的记录版本 |
| 调用寻址 | 按标识返回端点、版本与可用字段 | 调用方取得服务地址 |
| 调用记录 | 保存记录编号、调用方、目标 Agent、状态与时间 | 可核对、可排查 |
接入登记与身份鉴权
接入登记接收 Agent 名称、用途、能力说明、服务端点、协议类型、输入输出字段与错误返回,核对后分配标识。标识用于识别目标,登记内容形成记录版本,后续变化按版本递增,调用方可以据此确认当前端点是否有效。
身份与鉴权维护能力说明、端点与授权范围。授权范围说明可调用的字段与期限,由目标 Agent 主体确认;调用凭据用于证明调用方身份,与目标标识分开保管,避免把公开的定位信息当成调用权限。
登记与身份信息以记录版本为准。调用方看到版本变化时,按当前端点与字段调整,不使用旧版本继续请求;接入方也不需要为每次调整重新走一遍注册流程。
调用寻址与记录
调用方按标识发起寻址,节点校验调用方身份与目标状态,判断是否在授权范围内,返回端点、记录版本与可用字段。超出授权范围的请求不返回结果;标识不存在或目标停用时返回对应错误,调用方按类型处理。
每次寻址与调用形成记录,包含记录编号、调用方、目标 Agent、状态与时间,可按记录编号或时间范围查询。记录用于核对与排查,不包含业务正文;业务结果由调用方与目标 Agent 直接交换,平台不留存内容。
适合的使用者
这些使用者的共同点是:Agent 由自己维护,端点可能调整,调用方不止一个。通过统一标识与登记更新,可以减少逐个通知与重复配置,也能在出现问题时按记录定位到具体调用。
- 独立开发者:一个人维护一个或多个 Agent,需要稳定的对外标识。
- 小型团队:需要统一管理 Agent 身份、端点与授权说明。
- 企业创新团队:在内部系统之间调用 Agent,需要确认调用方身份。
- 多 Agent 开发者:为多个 Agent 分别登记,按用途管理标识。
能力边界
平台不替 Agent 执行业务任务,不保存业务正文,不评价 Agent 效果,也不保证业务结果。平台处理的是身份、端点、授权与调用记录,业务能力由 Agent 自身提供,质量与可用性由接入方维护。
业务请求的超时、重试与结果处理由调用方按自身业务规则决定;端点不可达时联系目标主体,不通过反复请求绕过问题。需要调整授权或端点时,按登记流程办理。
能力范围以接入时确认的清单为准。未确认的能力不默认提供,需要增加时按变更事项办理;平台不因登记而获得 Agent 业务内容的处置权。