啟用或停用語意排名工具
語意排名器是依使用量計費的進階功能。 根據預設,當您建立新的搜尋服務時,會關閉語意排名器,但具有 參與者 許可權的任何人都可以啟用它。 如果您不希望任何人不小心啟用此功能,您可以使用 管理 REST API 來停用全服務。
檢查可用性
若要檢查您的區域中是否有語意排名器,請參閱 Azure AI 搜尋區域清單。
啟用語意排名工具
請遵循下列步驟,在服務層級啟用語意排名工具。 啟用之後,即可供所有索引使用。 您無法針對特定索引開啟或關閉該工具。
開啟 Azure 入口網站。
瀏覽至您的搜尋服務。 在 [概 觀] 頁面上,確定定價層已設定為 [基本 ] 或更新版本。
在左側瀏覽窗格中,選取 [設定>語意排名器]。
選取 [免費方案] 或 [標準方案]。 您可以隨時在免費方案與標準方案之間切換。
免費方案每月上限為 1,000 個查詢。 在免費方案中的前 1,000 個查詢之後,錯誤訊息表示您在下一個語意查詢上用盡了配額。 當配額用盡時,您應該升級至標準方案,以繼續使用語意排名。
使用 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。