代理检索是按使用情况计费的高级功能。 默认情况下，所有搜索服务都注册在免费计划中，该计划免费提供每月津贴。 若要在使用免费配额后启用继续访问，可以切换到标准计划。
从搜索服务 REST API 版本 2026-04-01开始，语义排名器和代理检索的计费许可是分开的。 使用 knowledgeRetrieval 来独立于 semanticSearch控制付费代理检索的使用情况。
先决条件
账单拆分
对于搜索服务 REST API 版本 2026-04-01 及更高版本，knowledgeRetrieval 独立于 semanticSearch 控制代理式检索计费。 若要控制语义排名器计费，请参阅 “启用或禁用语义排名器计费”。
对于搜索服务 REST API 2025-11-01-preview 及更早版本，semanticSearch 控制是否同意使用语义排序器和付费代理式检索。 将忽略该 knowledgeRetrieval 属性。
计费计划
代理检索服务有两种计费方案。 有关以货币计价的信息，请参阅 Azure AI 搜索 定价。
| Plan |
Description |
Availability |
| 免费（默认值） |
免费提供每月令牌津贴。 使用免费额度后，任何将产生付费的请求都会返回一个需要付款的错误。 |
在所有定价层上都可用。 |
| 标准 |
在使用完每月免费额度后，采用按使用量计费的方式。 |
需要基本层或更高版本。 |
启用主动检索计费
按照以下步骤将代理检索切换到标准计费计划。
请在 Azure 门户中打开您的搜索服务。
在 “概述 ”页上，确保定价层为“基本”或“更高”。
在左窗格中，选择“设置>功能。
在“知识检索”下，选择标准卡中的“选择计划”。
使用服务 - 创建或更新（搜索管理 REST API）将knowledgeRetrieval设置为standard：
PATCH https://management.chinacloudapi.cn/subscriptions/{{subscription-id}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2026-03-01-preview
Content-Type: application/json
Authorization: Bearer {{management-access-token}}
{
"properties": {
"knowledgeRetrieval": "standard"
}
}
将会通过 Microsoft Entra ID 对管理 REST API 调用进行身份验证。 有关说明，请参阅使用 REST API 管理Azure AI 搜索服务。
Important
如果您之前依赖 semanticSearch 来启用付费 agentic retrieval 用量，则必须在将 agentic retrieval 工作负载迁移到 Search Service REST API standard 或更高版本之前，显式地将 2026-04-01 设置为 knowledgeRetrieval。 现有 semanticSearch=standard 同意不会延续到 knowledgeRetrieval。
禁用代理检索计费
按照以下步骤将代理检索切换回免费计费计划。
请在 Azure 门户中打开您的搜索服务。
在左窗格中，选择“设置>功能。
在“知识检索”下，选择免费卡中的“选择计划”。
使用服务 - 创建或更新（搜索管理 REST API）将knowledgeRetrieval设置为free：
PATCH https://management.chinacloudapi.cn/subscriptions/{{subscription-id}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2026-03-01-preview
Content-Type: application/json
Authorization: Bearer {{management-access-token}}
{
"properties": {
"knowledgeRetrieval": "free"
}
}
将会通过 Microsoft Entra ID 对管理 REST API 调用进行身份验证。 有关如何进行身份验证的说明，请参阅使用 REST API 管理 Azure AI 搜索服务。
相关内容
