固定链路先关掉语义检索：字节用 TopK 验收按意图发现

CodexQA 团队2026年9月2日阅读约 2 分钟

页面最近更新时间是 2026-09-02。AgentKit 规定生产固定编排和联调验收应关闭语义检索。关闭后不立即清索引，只停新增。验收看 SearchAgentCards 是否返回前 TopK 个智能体，本页没有写具体 K。

火山引擎 AgentKit 文档《开启或关闭智能体语义检索》的页面最近更新时间是 2026.09.02 14:55:59。A2A 智能体空间的语义检索，是给记不住智能体名称、也不想手写路由的调用方用的。本页讲什么时候开、关掉之后索引怎么留，以及用哪个接口验收。没有匹配分数。

什么时候开，什么时候关

智能体少的时候，调用方可以用固定名称、固定 ID 或明确路由。团队变多、能力拆得更细、任务更接近自然语言时，调用方往往不知道该叫哪一个。语义检索会按任务意图、智能体名称、描述和能力边界，在空间里匹配目标。

适合开启的有两类。一类是跨团队复用：数据、运营、文档、审批由不同团队维护，审核过的智能体注册进同一空间，调用方面向空间检索和调用，不用逐个记外部地址。另一类是复杂任务拆解，例如「分析上周销售变化并生成复盘」：主智能体先匹配数据分析类，再调用文档生成或消息通知类。

适合关闭的也有两类。生产链路必须始终调用确定目标时，例如风控审核、订单履约、规则计算，关掉更稳妥，调用方按固定标识或业务逻辑选择，降低误匹配。联调、验收或排查时也可以关掉，先排除匹配链路的不确定性，再定位能力、配置或返回结果。

首次开启后，平台按空间内智能体的关键描述建索引，用来理解这个智能体适合处理什么任务，再按自然语言任务召回。新注册或更新的智能体会自动建索引、刷新索引。

关闭后，平台不会立即清除存量索引，只停止新增索引。发现方式从「按意图匹配」变成「按固定目标选择」。重新开启时，只刷新关闭期间新增或更新的智能体，存量索引可以直接复用。

智能体注销时，平台自动清理对应索引。频繁注册、注销会被监控和管控，以免额外成本。

开启前，名称、描述和能力边界要清楚，否则可能返回多个相似候选，或匹配到错误智能体。关闭后，调用这个空间时不再按意图返回匹配度高的智能体，动态发现会受影响。

验收方式写在本页：开启后调用 SearchAgentCards，在 Prompt 里传入接近真实业务的自然语言任务。接口若返回匹配度最高的前 TopK 个智能体，就表示已经按调用意图做动态发现。本页没有写 TopK 等于几，也没有写匹配分。

出处：字节，火山引擎 AgentKit，开启或关闭智能体语义检索，2026-09-02，https://www.volcengine.com/docs/agentkit/enabling-or-disabling-semantic-retrieval

觉得有用，转给同事

微信扫码

用微信扫一扫，在手机上打开后即可转发。