你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

启用或禁用语义排序器

语义排序器是一项高级功能，按使用量计费。 默认情况下，对所有服务禁用了语义排序器。

检查可用性

检查 Azure 网站上的“各区域的产品可用性”页，查看你的区域是否已列出。

启用语义排名

按照以下步骤在服务级别启用语义排序器。 启用后，它可供所有索引使用。 不能为特定索引打开或关闭它。

Azure 门户

1. 打开 Azure 门户。

2. 导航到你的搜索服务。 在“概述”页上，确保该服务属于“基本”计费层或更高的计费层。

3. 在左侧导航窗格中，选择“语义排名”。

4. 选择“免费计划”或“标准计划”。 可以随时在免费计划与标准计划之间切换。

   

免费计划上限为每月 1000 条查询。 完成免费计划的前 1000 条查询之后，下次发出语义查询时，你将收到一条错误消息，通知你的配额已用完。 发生这种情况时，你需要升级到标准计划，才能继续使用语义排名。

REST

若要使用 REST API 启用语义排名，可以使用创建或更新服务 API。

将会通过 Microsoft Entra ID 对管理 REST API 调用进行身份验证。 有关如何进行身份验证的说明，请参阅使用 REST API 管理 Azure AI 搜索服务。

• 管理 REST API 版本 2023-11-01 提供了配置属性。

• 需要拥有所有者或参与者权限才能启用或禁用功能。

注意

创建或更新支持两种 HTTP 方法：PUT 和 PATCH。 PUT 和 PATCH 都可用于更新现有服务，但只有 PUT 可以用来创建新服务。 使用 PUT 来更新现有服务时，如果未在请求中指定属性，则会将服务中的所有属性替换为默认值。 使用 PATCH 来更新现有服务时，它只会替换请求中指定的属性。 使用 PUT 更新现有服务时，可能会意外引入意外的缩放或配置更改。 在现有服务上启用语义排名时，建议使用 PATCH 而不是 PUT。

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2023-11-01
    {
      "properties": {
        "semanticSearch": "standard"
      }
    }

使用 REST API 禁用语义排名

若要反转功能启用，或为了充分防止意外使用和收费，你可以在搜索服务上使用“创建”或“更新服务 API”禁用语义排名。 禁用该功能后，任何包含语义查询类型的请求都将被拒绝。

将会通过 Microsoft Entra ID 对管理 REST API 调用进行身份验证。 有关如何进行身份验证的说明，请参阅使用 REST API 管理 Azure AI 搜索服务。

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2023-11-01
    {
      "properties": {
        "semanticSearch": "disabled"
      }
    }

若要重新启用语义排名，请重新运行上述请求，将“semanticSearch”设置为“free”（默认值）或“standard”。

后续步骤

配置语义排名，以便可以测试内容的语义排名。