站点定位
Agent寻址解决的是独立 Agent 被找到与被确认的问题。开发者登记一次身份与端点,调用方按标识取得服务地址,再按授权范围发起业务请求;端点调整后更新登记,调用方重新寻址即可。
站点把登记、鉴权、寻址与记录分开说明,便于接入方判断每一步需要准备什么、得到什么结果,也便于出现问题时定位环节,不需要把整条链路重新排查。
站点的说明按接入、身份、调用与错误分开组织,接入方可以按需要查看对应内容,不必一次读完所有材料。
提供什么
服务围绕身份、端点、授权与记录展开,不介入 Agent 的业务执行。接入方保留对自身 Agent 与业务数据的控制,平台只维护登记内容与调用记录。
这些内容构成接入的基础信息,具体字段与流程以接入时确认的材料为准。
- 接入登记:提交主体与 Agent 材料,取得标识。
- 身份与鉴权:区分目标标识与调用凭据,按授权判断。
- 调用寻址:按标识返回端点与记录版本。
- 错误处理:按五类错误说明原因与处理方式。
- 调用记录:保存记录编号、目标、状态与时间。
服务对象
面向独立开发者、小型团队与企业创新团队,也为管理多个 Agent 的开发者提供接入与寻址能力。接入方需要维护 Agent 端点、凭据与回调地址,并对业务结果负责;不同规模的接入方使用同一套登记与调用规则。
服务对象不同,登记与调用规则一致;差别主要在 Agent 数量、调用方数量与内部维护分工。
工作方式
接入从注册到启用的顺序固定,五步各有确认结果。开发者自行完成日常的凭据轮换、端点变更与记录查询,平台负责核对材料与维护登记内容;操作结果写入记录,便于双方核对。
规则变化通过版本记录说明,影响调用字段、错误码或记录字段时提升版本号。调用方按当前版本核对字段与错误处理,不依赖口头说明。
平台核对材料后进入沙箱,联调通过再切换正式;日常操作由开发者完成,减少等待。
边界
平台的职责止于登记、寻址与记录,Agent 的业务任务、内容质量与交付结果由接入方自行承担。身份与寻址信息只用于确认对象、端点与授权范围,不用于其他用途。
涉及个人信息、第三方内容或受限数据时,按已确认的接入约定办理;未获授权的请求不提供结果。接入方应确保提交材料与实际上线情况一致。
接入方需要自行确认 Agent 的适用场景与数据使用边界,平台不参与 Agent 的业务运营,也不对其输出作评价。