能力范围
Agent 身份由标识、主体、能力摘要、端点和记录版本组成。标识在首次登记时生成,主体和用途不变时保持不变;端点、能力或授权范围变化时,通过记录版本更新体现。调用方在正式调用前确认版本,可以避免使用过期端点。
寻址匹配支持两种方式。已知目标时按标识精确查询,取得端点、版本和状态;不确定目标时按能力条件筛选候选,再由授权范围过滤。超出授权范围的 Agent 不出现在结果中,匹配结果只包含授权范围内的字段。
互通发生在不同主体之间。双方分别登记身份和授权范围,调用方按目标标识发起请求,平台核对双方记录后返回端点和可用字段。业务结果由 Agent 返回,平台只保留定位问题所需的调用记录。
- 身份登记:记录主体、能力摘要、端点和授权范围。
- 寻址匹配:按标识查询或按能力条件筛选。
- 多 Agent 互通:不同主体的 Agent 按授权范围互相调用。
- 调用记录查询:按请求编号核对匹配与调用结果。
适用对象
服务面向需要在系统之间确认 Agent 身份、查找目标并控制调用范围的机构。接入方应能说明 Agent 的能力边界、服务端点和可调用对象。
一个主体可以登记多个 Agent,不同 Agent 分别取得标识和记录版本。部门或业务线可以据此划分授权范围,调用记录按主体和 Agent 分别保留。
- 智能体开发方:为 Agent 申请稳定标识,说明能力范围、服务端点和可调用对象。
- 企业平台:把内部 Agent 接入统一入口,按部门或业务线划分授权范围,保留调用记录。
- 跨主体集成方:在多个主体之间完成 Agent 发现与调用,按标识查询目标并控制可访问能力。
接入流程
注册与接入分为五步,材料不齐时不进入匹配测试。每一步都有对应的核对内容,前一步不通过时不进入下一步。
- 提交材料:提交主体证明、Agent 能力清单、服务端点和授权范围。
- 登记核验:核对材料完整性、标识唯一性,以及能力摘要与端点实际能力是否一致。
- 生成标识:生成 Agent 标识、记录版本和调用凭据。
- 首次匹配:使用测试标识完成一次匹配和调用,确认返回的端点和版本正确。
- 正式调用:测试通过后切换正式标识,调用方在授权范围内发起业务调用。
应用场景
一个主体可以按业务线登记多个 Agent,各自持有标识;调用方按能力条件找到目标,再按授权范围发起调用,无需在业务代码中维护固定入口。
两个主体各自登记 Agent,通过标识确认对方身份,按授权范围交换能力摘要和端点。业务数据由双方系统直接处理,平台只保留调用记录。
Agent 调用外部工具或多个模型时,按能力和授权范围匹配目标。目标端点变化时更新记录,调用方重新匹配即可,不必修改业务代码中的固定入口。
办理须知
接入前应确认 Agent 有稳定身份、明确能力边界和可访问的端点。授权对象、字段范围和期限需要提前确定,并指定可以接收变更通知的联系人。
接入方对 Agent 的业务行为负责,平台只处理身份、寻址、授权和记录。需要变更端点、能力或授权范围时,提交变更申请,原记录保留。
- Agent 需要有稳定身份和明确的能力边界,端点应可访问并能处理请求。
- 接入方应说明授权对象、字段范围和期限,并指定可以接收变更通知的联系人。
- 涉及个人信息时先完成脱敏;国家秘密和重要数据不得接入。
- 平台只处理身份、寻址、授权和调用记录,不保存业务正文,也不评价 Agent 的业务效果。
登记 Agent 身份
准备主体材料、能力清单、服务端点和授权范围,提交接入申请。受理人员会说明核对要点和后续步骤。