次の方法で共有

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

  • [アーティクル]

セマンティック ランカーはプレミアム機能であり、使用量に基づいて請求されます。 既定では、セマンティック ランカーは新しい検索サービスに対して無効になっていますが、共同作成者のアクセス許可を持っていれば誰でも有効にできます。 誰かが誤って有効にするのを防ぐために、REST API を使って無効にすることができます。

可用性を確認する

リージョンの一覧をチェックして、ご自身のリージョンが含まれているかどうかを確認してください。

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

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

  1. Azure portal を開きます。

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

  3. 左側のナビゲーション ウィンドウで、[設定]>[セマンティック ランカー] を選択します。

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

    Azure portal でのセマンティック ランク付けの有効化のスクリーンショット。

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

REST API を使ってセマンティック ランカーを無効にする

有効にした機能を無効にするため、または誤った使用および課金を完全に防ぐために、検索サービスに対して作成または更新のサービス 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" に設定して前の要求を再実行します。

次のステップ

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