首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >从注册到被发现:一个智能体资源要经过哪些关卡

从注册到被发现:一个智能体资源要经过哪些关卡

原创
作者头像
用户4859102
发布于 2026-11-17 13:08:31
发布于 2026-11-17 13:08:31
210
举报

在普通应用商店里,“提交成功”和“搜索可见”之间往往只有一个审核状态。智能体资源的情况更复杂:登记材料是否由控制者提交,接入节点是否有资格,发布内容是否被替换,发现节点拿到的是否是当前版本,都需要分别判断。

OpenAgenet(OAN)把这条路径拆成几个可验证阶段:本地准备、Registrar受理、Root接纳、内容分发、Discovery索引和调用前验证。拆分不是为了增加流程,而是为了让每个成功或失败都有明确含义。

第一道关:本地把材料和证明准备完整

OAN登记的对象不只有智能体服务,还包括技能包、MCP服务和工具API。资源提供方需要准备资源DID、DID文档、资源类型、能力描述、标签、版本、端点、协议绑定和控制证明。

签名应在资源提供方控制的本地环境完成,私钥不随普通注册请求上传。自持资源由资源自身证明控制;使用外部controller时,还要取得controller对本次登记的授权。若只是把controller名称写进文档,却拿不出对应授权,材料不应进入可信发布链路。

准备阶段最容易出现的错误,不是复杂密码学失败,而是材料之间互相对不上。例如提交中的资源DID与DID文档 id 不一致,资源类型与元数据声明不同,端点更新了但摘要仍来自旧文件,或者导入的私钥并不对应文档中的公钥。客户端越早发现这些问题,越能减少无意义的远程请求。

四类资源还各有自己的必需信息。智能体服务需要说明任务或会话入口,技能包要给出输入输出、依赖和使用方式,MCP服务需要表达工具集合与传输方式,工具API则应绑定真实接口契约。把一个网页地址填进所有类型,并不能形成可用的资源描述。

资源提供方还应在提交前确定版本语义。相同DID、相同版本、相同内容可以按幂等请求处理;相同版本却提交不同内容应被视为冲突;真正变化的材料应进入有授权的新版本。若版本和摘要没有稳定规则,后续节点就无法判断自己拿到的是重试、更新还是篡改。

OAN公开注册页面示例。图源:OAN技术手册公开部署截图
OAN公开注册页面示例。图源:OAN技术手册公开部署截图

第二道关:Registrar接入并向Root提交

Registrar是资源进入OAN网络的接入节点。它检查字段结构、资源类型、DID与文档的一致性、签名和登记范围,并把合格请求封装为节点间请求提交给Root。服务商还可以按运营规则核验controller背后的企业或个人。

当前参考实现中,公开的单条注册调用会等待Root返回接纳结果。Root接受后,Registrar签发注册VC并保存本地登记记录。因此,调用方收到成功注册响应时,可以确认本次同步登记已经被Root接受,而不只是“排进了一个未知队列”。

但这仍不等于所有发现节点已经可见。后续内容分发和索引属于异步阶段。

Registrar之所以不能直接把材料写入Discovery,是因为接入资格与网络权威状态不是一回事。若每个Registrar都能绕过Root修改发现索引,不同节点很快会出现互相矛盾的版本,调用方也无法判断哪个controller有效。

注册VC同样有明确边界。它记录Registrar对登记事实的可验证声明,便于资源提供方和调用方核对接入来源;它不是资源包本身,也不能证明后续内容分发已经完成。页面如果只展示“已颁发VC”,运维人员仍要继续查看发布任务和发现游标。

一次注册失败时,客户端需要保留请求标识和材料摘要,但不应记录私钥。格式错误、控制证明错误、Registrar无授权、Root版本冲突和上游暂时不可用,应返回不同类别的错误。只有区分可修正错误与可重试错误,自动化客户端才不会对永久无效的材料无限重试。

第三道关:Root核验网络不变量

Root不是简单地相信Registrar转发的材料。它还要核验Registrar身份和授权、请求新鲜度、随机数、请求体摘要、DID文档证明、资源控制关系、版本以及当前controller状态。

更新已有资源时,Root依据当前已接纳版本中的controller验证授权,而不是只看新文档自报的controller。相同版本但内容不同的请求应被拒绝;过期controller、重放随机数或摘要不匹配也不能写入当前状态。

通过检查后,Root形成该资源版本的接受记录和可信发布事实,并创建持久化的发布任务。它负责执行既定规则,不替资源提供方声明业务能力,也不保证端点永远在线。

Root还需要处理并发更新。假设两个客户端都读取到版本5,并分别尝试提交版本6。即使两份请求都由当时的controller合法签署,也不能让后到请求静默覆盖先到请求。版本、内容摘要和当前controller应在同一个比较更新中判断;其中一份被接受后,另一份必须基于新状态重新处理。

随机数防重放解决的是另一类问题。攻击者即便截获一份完整合法请求,也不能在有效窗口内反复提交,借此制造重复写入或重新触发旧状态。随机数、时间窗口、目标节点和请求体摘要共同绑定,才有能力区分“同一业务的安全幂等重试”和“原封不动的恶意重放”。

接纳记录与发布任务分开保存,也是一项故障恢复设计。如果Root已接受资源,但向内容分发层发送时暂时失败,后台循环可以从持久任务继续,而不要求资源提供方重新发起一次可能改变语义的登记。发布成功后更新任务状态,才能避免进程重启后丢失工作。

从材料校验到接纳的工作流。图源:OAN技术手册
从材料校验到接纳的工作流。图源:OAN技术手册

第四道关:内容分发与发现索引

Root接纳后,后台发布循环把资源包、DID文档、元数据和证明交给内容分发层。Discovery节点再按自己的同步游标取得增量内容,重新计算摘要、验证Root证明和治理状态,并按授权域过滤资源。

通过验证的资源先进入结构化索引。启用语义引擎时,语义索引可以作为派生步骤异步构建。因此还会出现一种正常中间状态:资源已经能按DID精确查到,但自然语言语义召回尚未完成。系统需要分别记录同步、校验、结构化索引和语义索引状态,而不能只给出一个模糊的“处理中”。

内容分发平台负责传播,不取得Root的状态维护权;Discovery负责查询,不得改写资源的controller、版本或发布事实。这种职责分离让第三方发现服务可以建设不同的索引和检索体验,同时仍能核验共同的来源证据。

Discovery同步时不能只看“文件能否下载”。它还要确认资源包摘要、Root证明、资源版本、生命周期和本节点授权域。如果材料损坏或证明不匹配,应进入拒绝记录或隔离状态,而不是为了维持搜索数量把它写入索引。

同步游标使节点能够从已确认位置继续拉取,而不是每次扫描全部资源。游标推进必须和本地处理结果协调:如果先推进游标再写索引,进程崩溃可能永久漏掉一批资源;如果索引成功却不记录游标,重启后会重复处理。实现可以采用幂等写入和持久检查点消除这类边界问题。

对于多发现节点网络,“已可发现”还必须说明在哪个节点、哪个授权域可见。某资源出现在官方发现服务,不意味着所有第三方节点都已同步;某行业节点因授权域不匹配而不展示,也不一定是故障。状态页面和测试报告应带上目标节点,避免把局部可见写成全网事实。

精确发现和语义发现解决不同问题

如果调用方已经知道资源DID,按DID精确查找最确定,也最适合自动化流程。它回答的是“这个明确标识的资源当前有什么记录”。结构化查询则可以按资源类型、能力标签、版本或授权域筛选。

语义发现适合用户只描述任务、不知道资源名称的情况。它可以扩大候选召回,但相关性分数不能绕过身份、授权域、生命周期和证据验证。一个文本上非常相似却已撤销的资源,不应因为排名靠前而重新变成可用结果。

结构化发现位于两者之间。调用方知道自己需要 mcp_service、某个能力标签和特定协议版本时,可以用确定字段过滤,结果更容易复现,也便于自动化验收。语义发现则适合“帮我找一个能分析遥感影像异常的服务”这类表达不完全对应标签树的问题。

实际产品可以把两种方式组合:先按授权域、资源类型、状态和版本做硬过滤,再对合格集合计算语义相关性。这样,语义模型负责排序与扩展召回,协议不变量负责划定候选边界。若把顺序反过来,模型可能先召回大量无权展示或已经失效的材料,既浪费计算,也增加误用风险。

按DID精确查询则适合端到端演示、自动化依赖和已知合作伙伴。它不受名称歧义和模型波动影响,也能直接核对预期资源是否已同步。因此,测试注册发布链路时通常应优先用DID查询,语义检索另做独立质量评估。

OAN公开发现页面示例。图源:OAN技术手册公开部署截图
OAN公开发现页面示例。图源:OAN技术手册公开部署截图

找到以后,还不能直接等同于“允许调用”

Discovery返回的是候选资源。调用方至少还要核对返回DID、版本、资源包摘要、注册凭证或相关登记证据、Root可信发布证明、生命周期、治理状态和端点协议。真正建立业务连接时,服务端自己的认证、授权、限流和业务规则仍然有效。

由此可以看出,OAN链路中至少有四种“完成”:Registrar返回登记结果,Root完成接纳,内容分发层持久化材料,Discovery完成索引。它们分别对应接入、权威状态、传播和可查询性。把四者分开记录,运维人员才能判断一次延迟究竟发生在注册、发布、同步还是索引。

对普通用户来说,这些后台关卡未必都要出现在页面上;对网络而言,它们必须留下可核验状态。可信发现的价值不只是“搜到一个答案”,而是能够解释这个答案从哪里来、为什么此刻可见,以及下一步还需要验证什么。

页面、SDK和运维端应该分别显示什么

面向普通发布者的页面可以把复杂状态归纳为“材料已提交、Root已接受、正在分发、目标发现节点已可见”,并在失败时给出可行动的原因。它不必展示每个内部表名,却不能用一个永久旋转的“处理中”遮住故障阶段。

SDK需要提供更稳定的机器语义,包括请求标识、资源DID、目标节点、版本、错误类型和重试建议。自动化程序据此决定继续轮询、修正材料还是停止。若只返回自然语言提示,调用方很容易把版本冲突当成网络超时反复提交。

运维端则要观察各循环的队列、游标、最后成功时间、拒绝原因和积压量。注册速率上升而Discovery完成量停滞时,应直接看到差距。节点重启后,持久任务与同步游标还要能够继续推进,不能靠人工重跑整批资源恢复。

这三种视角使用同一条事实链,却服务不同读者。一个成熟的端到端流程,不是把所有内部细节都暴露给用户,而是让每个角色都得到足以作出下一步判断的信息。

如果要验收整条链路,最稳妥的办法是为测试资源保留唯一DID和请求标识,先保存注册响应,再等待Root状态、内容分发确认和指定Discovery的DID精确查询结果,最后核对返回版本与摘要。任何一步超时都停止向后宣称成功,并保存当时的游标和错误。这种门禁比“页面上能搜到一个同名资源”严格得多,也更容易在版本升级后发现回归。

说明:本文依据OAN当前公开技术手册、白皮书和黄皮书整理。实际传播时间与索引能力取决于节点配置,语义检索也不替代身份和授权校验。

参考资料

  1. OAN黄皮书
  2. OAN白皮书:Open Infrastructure for Trusted Agent Interconnection
  3. OpenAgenet官方网站
  4. OpenAgenet官网技术手册
  5. OpenAgenet GitHub公开代码组织
  6. OpenAgenet(OAN)百度百科词条历史版本(资料入口,词条状态以百度百科页面为准)

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 第一道关:本地把材料和证明准备完整
  • 第二道关:Registrar接入并向Root提交
  • 第三道关:Root核验网络不变量
  • 第四道关:内容分发与发现索引
  • 精确发现和语义发现解决不同问题
  • 找到以后,还不能直接等同于“允许调用”
  • 页面、SDK和运维端应该分别显示什么
  • 参考资料
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档