为降低调用方因记不住智能体名称或手动维护路由而带来的使用成本，智能体空间提供了语义检索功能。本文介绍如何开启、关闭 A2A 智能体空间语义检索功能。 ## 背景信息当智能体空间中只有少量智能体时，调用方通常可以通过固定名称、固定 ID 或明确路由逻辑指定目标智能体。但在多团队协作、能力颗粒度变细或任务描述更加自然语言化的场景中，调用方往往不知道应该调用哪个具体智能体。此时，语义检索可以根据用户任务意图、智能体名称、描述和能力边界，自动在空间中匹配更合适的目标智能体。 ## 适用场景 ### 开启语义检索 * **跨团队智能体复用** 当数据、运营、文档、审批等能力由不同团队分别维护时，可以把经过审核的智能体注册到同一个空间，调用方只需面向空间发起检索、调用，无需逐个了解智能体的外部服务地址。 * **复杂任务自动拆解与路由** 用户输入接近自然语言任务，例如“分析上周销售变化并生成复盘”，主智能体需要在空间中优先匹配数据分析类智能体，再继续调用文档生成或消息通知类智能体。 ### 关闭语义检索 * **生产链路固定编排** 如果某条生产链路必须始终调用确定的目标智能体，例如风控审核、订单履约、规则计算等场景，关闭语义检索通常更稳妥。这样调用方将基于固定标识或业务逻辑选择目标，降低误匹配风险。 * **调试验证** 如果智能体处于联调、验收或问题排查阶段，可以关闭语义检索，先排除匹配链路带来的不确定性，便于更快定位能力、配置或返回结果中的问题。 ## 工作原理首次开启语义检索后，平台会基于空间内智能体的关键描述信息构建索引（即理解“这个智能体适合处理什么任务”），再结合调用方输入的自然语言任务进行召回；新注册或更新的智能体会自动同步构建、刷新索引。关闭语义检索后，平台不会立即清除存量索引，仅停止新增索引构建，但空间内智能体的发现方式会从“按意图匹配”变为“按固定目标选择”。重新启用语义检索时，仅对期间新增、更新的智能体刷新索引，存量数据可直接复用。

注意

智能体注销时，平台将自动清理对应索引。平台会对频繁注册、注销行为进行监控与管控，以避免异常操作产生额外成本。

## 前提条件已创建智能体空间。[了解更多](https://www.volcengine.com/docs/86681/2229303) ## 操作步骤 1. 登录 [AgentKit 控制台](https://console.volcengine.com/agentkit)。 2. 在左侧导航树中选择“基础组件 \> A2A中心”。 3. 在 A2A 智能体空间下拉框，单击目标 A2A 智能体空间右侧的“... \> 编辑”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6aca9fc721bd65673a4fcccc96030a91.png) 4. 在“智能体语义检索”区域，单击开关控件，开启或关闭智能体语义检索功能。

注意

开启语义检索功能前，请确保您注册至空间中的智能体名称、描述、能力边界清晰，否则可能返回多个相似候选或匹配到错误智能体。

关闭语义检索功能后，智能体调用 A2A 智能体空间时，不再支持按照调用意图返回匹配度高的智能体，该操作可能影响智能体动态发现能力，请谨慎操作。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_05b16de50b257f4577aae1a850f443f7.png) 5. 单击“确定”按钮，完成操作。 ## 验证结果开启语义检索后，您可以调用 [SearchAgentCards](https://www.volcengine.com/docs/86681/2249670?lang=zh) 接口 `Prompt` 中传入接近真实业务表达的自然语言任务，若接口返回匹配度最高的前 `TopK` 个智能体，表示已实现按调用意图动态发现并查询智能体。