代理检索是按使用情况计费的高级功能。 默认情况下，所有搜索服务都注册在免费计划中，该计划免费提供每月津贴。 若要在使用免费配额后启用继续访问，可以切换到标准计划。
从搜索服务 REST API 版本 2026-04-01 开始，语义排名器和代理检索的计费许可是分开的。 使用 knowledgeRetrieval 来独立于 semanticSearch控制付费代理检索的使用情况。
先决条件
在任意提供代理检索功能的区域中提供的 Azure AI 搜索服务。
搜索服务的所有者或参与者权限。
搜索管理 REST API 版本 2026-03-01-preview 或更高版本以设置
knowledgeRetrieval属性。
账单拆分
对于搜索服务 REST API 版本 2026-04-01 及更高版本，knowledgeRetrieval 独立于 semanticSearch 控制代理检索计费。 若要控制语义排名器计费，请参阅 “启用或禁用语义排名器计费”。
对于搜索服务 REST API 版本 2025-11-01-preview 及更早的版本，semanticSearch 控制对语义排名器和付费代理主动检索使用情况的同意。 将忽略该 knowledgeRetrieval 属性。
计费计划
代理检索服务有两种计费方案。 有关以货币计价的信息，请参阅 Azure AI 搜索 定价。
| Plan | Description | Availability |
|---|---|---|
| 免费（默认值） | 免费提供每月令牌津贴。 使用免费额度后，任何将产生付费的请求都会返回一个需要付款的错误。 | 在所有定价层上都可用。 |
| 标准 | 在使用完每月免费额度后，采用按使用量计费的方式。 | 需要基本层或更高版本。 |
启用主动检索计费
按照以下步骤将代理检索切换到标准计费计划。
- Azure 门户
- REST
请在 Azure 门户中打开您的搜索服务。
在 “概述 ”页上，确保定价层为“基本”或“更高”。
在左窗格中，选择“设置>功能。
在“知识检索”下，选择标准卡中的“选择计划”。
禁用代理检索计费
按照以下步骤将代理检索切换回免费计费计划。
