啟用或停用語意排名工具

語意排名器是依使用量計費的進階功能。 根據預設，當您建立新的搜尋服務時，會關閉語意排名器，但具有 參與者 許可權的任何人都可以啟用它。 如果您不希望任何人不小心啟用它，您可使用 REST API 來停用它。

檢查可用性

若要檢查您的區域中是否有語意排名器，請參閱 Azure AI 搜尋區域清單。

啟用語意排名工具

請遵循下列步驟，在服務層級啟用語意排名工具。 啟用之後，即可供所有索引使用。 您無法針對特定索引開啟或關閉該工具。

Azure 入口網站

1. 開啟 Azure 入口網站。

2. 瀏覽至您的搜尋服務。 在 [概 觀] 頁面上，確定定價層已設定為 [基本 ] 或更新版本。

3. 在左側瀏覽窗格中，選取 [設定>語意排名器]。

4. 選取 [免費方案] 或 [標準方案]。 您可以隨時在免費方案與標準方案之間切換。

   

免費方案每月上限為 1,000 個查詢。 在免費方案中的前 1,000 個查詢之後，錯誤訊息表示您在下一個語意查詢上用盡了配額。 當配額用盡時，您應該升級至標準方案，以繼續使用語意排名。

REST

若要使用 REST API 啟用語意排名工具，您可以使用建立或更新服務 API。

管理 REST API 呼叫是透過 Microsoft Entra ID 進行驗證。 如需如何驗證的指示，請參閱使用 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 來停用語意排名器。 停用此功能之後，會拒絕包含語意查詢類型的任何要求。

管理 REST API 呼叫是透過 Microsoft Entra ID 進行驗證。 如需如何驗證的指示，請參閱使用 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 （default） 或 Standard。

後續步驟

設定語意排名工具