你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
注释
Azure AI 搜索可通过Azure门户、REST API 和Azure SDK获取。 它也是 Foundry IQ 的基础；Foundry IQ 是一个托管式知识层，可将企业内容转化为供 Microsoft Foundry 门户中的智能体使用的、可复用且具备权限感知能力的知识库。
代理检索是按使用情况计费的高级功能。 默认情况下，所有搜索服务都注册在免费计划中，该计划免费提供每月津贴。 若要在使用免费配额后启用继续访问，可以切换到标准计划。
从搜索服务 REST API 版本 2026-04-01开始，语义排名器和代理检索的计费许可是分开的。 使用 knowledgeRetrieval 来独立于 semanticSearch控制付费代理检索的使用情况。
先决条件
在任何区域内提供代理检索的 Azure AI 搜索服务。
所有者或参与者对搜索服务的访问权限。
搜索管理 REST API 版本 2026-03-01-preview 或更高版本以设置
knowledgeRetrieval属性。
账单拆分
使用搜索管理 REST API 设置计费同意。 下表显示了根据应用程序使用的搜索服务 REST API 版本生效的属性。
| 搜索服务 REST API 版本 | 语义排名器计费 | 代理检索计费 |
|---|---|---|
| 2026-04-01 及之后 | 由 semanticSearch 控制 |
由 knowledgeRetrieval 控制 |
| 2025-11-01-preview 及更早版本 | 由 semanticSearch 控制 |
由 semanticSearch 控制 |
对于搜索服务 REST API 版本 2026-04-01 及更高版本，knowledgeRetrieval 独立于 semanticSearch 控制代理式检索计费。 若要控制语义排名器计费，请参阅 “启用或禁用语义排名器计费”。
对于搜索服务 REST API 2025-11-01-preview 及更早版本，semanticSearch 控制是否同意使用语义排序器和付费代理式检索。 将忽略该 knowledgeRetrieval 属性。
计费计划
代理检索服务有两种计费方案。 有关以货币计价的信息，请参阅 Azure AI 搜索 定价。
| 计划 | 描述 | Availability |
|---|---|---|
| 免费（默认值） | 免费提供每月令牌津贴。 在免费限额用完后，将产生付费使用的请求将返回“需要付款”错误。 | 在所有定价层上都可用。 |
| 标准 | 在使用完每月免费额度后，采用按使用量计费的方式。 | 需要基本层或更高版本。 |
启用主动检索计费
按照以下步骤将智能体检索切换到标准计费计划。
- Azure 门户
- REST
请在 Azure 门户中打开您的搜索服务。
在 “概述 ”页上，确保定价层为“基本”或“更高”。
在左窗格中，选择“设置>功能。
在“知识检索”下，选择标准卡中的“选择计划”。
禁用智能体检索计费
按照以下步骤将智能体检索切换回免费计费计划。
