セマンティック ランカーを有効または無効にする

  • [アーティクル]

セマンティック ランカーは、使用量に基づいて課金されるプレミアム機能です。 既定では、セマンティック ランカーはすべてのサービスで無効になっています。

可用性を確認する

Azure Web サイト上の「リージョン別の利用可能な製品」ページで、お使いのリージョンが一覧にあるかどうか確認します。

セマンティック ランク付けを有効にする

セマンティック ランカーをサービス レベルで有効にするには、以下の手順に従います。 有効になると、すべてのインデックスで使用できるようになります。 特定のインデックスに対して有効または無効にすることはできません。

  1. Azure portal を開きます。

  2. お使いの検索サービスに移動します。 [概要] ページで、サービスが Basic 以上の課金対象レベルであることを確認します。

  3. 左側のナビゲーション ウィンドウで、セマンティック ランク付けを選択します。

  4. [無料プラン]または [Standard プラン] を選択します。 無料プランと Standard プランは、いつでも切り替えて使用できます。

    Screenshot of enabling semantic ranking in the Azure portal.

Free プランは、1 か月あたり 1,000 件のクエリに制限されています。 Free プランで最初の 1,000 件のクエリを実行すると、次にセマンティック クエリを発行するときに、クォータを使い果たしたことを通知するエラー メッセージが表示されます。 この場合、セマンティック ランク付けを引き続き使用するには、Standard プランにアップグレードする必要があります。

REST API を使用してセマンティック ランク付けを無効にする

機能の有効化を無効にする、または偶発的な使用と課金から完全に守るため、検索サービスでは Create または Update Service API を使ってセマンティック ランク付けを無効にできます。 この機能を無効にすると、セマンティック クエリ タイプが含まれるあらゆる要求が拒否されます。

Management REST API 呼び出しは、Microsoft Entra ID を介して認証されます。 認証方法の詳細については、「REST API を使用して Azure AI Search サービスを管理する」を参照してください。

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" に設定します。

次のステップ

コンテンツのセマンティック ランク付けをテストできるように、セマンティック ランク付けの構成を行います。