啟用或停用語意排名工具

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

檢查可用性

請檢查區域清單，以查看您的區域是否已列出。

啟用語意排名工具

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

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"(預設) 或 "standard"。

下一步

設定語意排名工具，以便測試內容的語意排名。