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

启用或禁用语义排序器

  • 项目

语义排序器是一项高级功能，按使用量计费。 默认情况下，语义排序器在新搜索服务上处于关闭状态，但具有参与者权限的任何人都可以启用它。 如果不想无意中启用语义排序器，可以使用 REST API 进行禁用。

检查可用性

检查区域列表以查看区域是否已列出。

启用语义排序器

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

  1. 打开 Azure 门户。

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

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

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

    屏幕截图显示如何在 Azure 门户中启用语义排名。

免费计划上限为每月 1000 条查询。 执行了免费计划的前 1,000 次查询后，再尝试进行语义查询时，系统会显示错误消息，指示查询配额已用尽。 当查询配额用完时，应升级到标准计划，这样才能继续使用语义排名。

使用 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”。

后续步骤

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