Azure AI 検索でセマンティックランカーを使ってクエリを書き換える (プレビュー)

[アーティクル]
11/19/2024

Note

現在、この機能はパブリックプレビュー段階にあります。このプレビュー版はサービスレベルアグリーメントなしで提供されています。運用環境のワークロードに使用することはお勧めできません。特定の機能はサポート対象ではなく、機能が制限されることがあります。詳しくは、Microsoft Azure プレビューの追加使用条件に関するページをご覧ください。

クエリの書き換えは、ユーザーのクエリをより効果的なものに変換するプロセスです。 Search Service は、検索クエリ (またはそのバリエーション) を、代替クエリを生成する生成モデルに送信します。

クエリの書き換えを使う検索は、次のように機能します。

ユーザークエリは、要求の search プロパティを使って送信されます。
Search Service は、検索クエリ (またはそのバリエーション) を、代替クエリを生成する生成モデルに送信します。
Search Service は、元のクエリと書き換えられたクエリを使って検索結果を取得します。

クエリの書き換えはオプション機能です。クエリの書き換えを使わないと、Search Service は元のクエリだけを使って検索結果を取得します。

Note

クエリの書き換えは、現在、米国東部、北ヨーロッパ、東南アジアの各リージョンで利用できます。

クエリの書き換えを使用する理由

Azure AI 検索でクエリの書き換えを有効にすると、高い BM25 スコアが表示される場合と表示されない場合があります。これは、ドキュメントがクエリにどの程度関連しているかを示します。クエリの書き換えでは、生成 AI を使って元のクエリを拡張し、用語を追加して検索結果を調整します。

クエリの書き換えが役に立つ可能性がある場合:

ユーザークエリでの入力ミスまたはスペルミスの修正。
検索結果を向上させるためのシノニムによるクエリの拡張。

クエリの書き換えが役に立たない可能性がある場合:

完全一致を必要とする高度に固有のクエリの場合。
一意の識別子または製品コードを検索する場合。

前提条件

セマンティックランカーが有効になっている Basic レベル以上の検索サービス。機能の概要情報が必要な場合は、セマンティックランク付けを確認してください。

重要

現在、クエリの書き換えにはセマンティックランカーが必要です。

セマンティック構成とリッチテキストコンテンツを使用する既存の検索インデックス。このガイドの例では、hotels-sample-index サンプルデータを使って、クエリの書き換えを見ていきます。独自のデータとインデックスを使って、クエリの書き換えをテストできます。
REST API 要求をサポートする Web クライアントが必要です。このガイドの例は、Visual Studio Code と REST Client 拡張機能を使ってテストされました。

ヒント

セマンティックランク付けには、説明または定義を含むコンテンツが最も適しています。

クエリの書き換えを使用して検索要求を行う

この REST API の例では、Search Documents を使って要求を作成します。要求と応答のプロパティについて詳しくは、API リファレンスドキュメントを参照してください。

次の要求をテンプレートとして Web クライアントに貼り付けます。
```
POST https://[search-service-name].search.windows.net/indexes/hotels-sample-index/docs/search?api-version=2024-11-01-preview
{
    "search": "newer hotel near the water with a great restaurant",
    "semanticConfiguration":"en-semantic-config",
    "queryType":"semantic",
    "queryRewrites":"generative|count-5",
    "queryLanguage":"en-US",
    "debug":"queryRewrites",
    "top": 1
}
```
- search-service-name を実際の検索サービスの名前に置き換えます。
- hotels-sample-index が実際のインデックス名と異なる場合は、置き換えます。
- "search" をフルテキスト検索クエリに設定します。ベクトルクエリを指定するのでない限り、クエリの書き換えには検索プロパティが必要です。ベクトルクエリを指定する場合は、"search" のテキストは "vectorQueries" オブジェクトの "text" プロパティと一致する必要があります。検索文字列は、simple 構文または完全な Lucene 構文をサポートできます。
- "semanticConfiguration" を、インデックスに埋め込まれた定義済みセマンティック構成に設定します。
- "queryType" を "semantic" に設定します。 "queryType" を "semantic" に設定すること、または要求に空でない "semanticQuery" プロパティを含めることが必要です。クエリの書き換えにはセマンティックランク付けが必要です。
- "queryRewrites" を "generative|count-5" に設定して、最大 5 つのクエリ書き換えを取得します。カウントは、1 から 10 の任意の値に設定できます。
- "queryLanguage" をクエリの書き換えのターゲット言語 ("en-US") に設定します。次のロケールがサポートされています: en-AU、en-CA、en-GB、en-IN、en-US、ar-EG、ar-JO、ar-KW、ar-MA、ar-SA、bg-BG、bn-IN、ca-ES、cs-CZ、da-DK、de-DE、el-GR、es-ES、es-MX、et-EE、eu-ES、fa-AE、fi-FI、fr-CA、fr-FR、ga-IE、gl-ES、gu-IN、he-IL、hi-IN、hr-BA、hr-HR、hu-HU、hy-AM、id-ID、is-IS、it-IT、ja-JP、kn-IN、ko-KR、lt-LT、lv-LV、ml-IN、mr-IN、ms-BN、ms-MY、nb-NO、nl-BE、nl-NL、no-NO、pa-IN、pl-PL、pt-BR、pt-PT、ro-RO、ru-RU、sk-SK、sl-SL、sr-BA、sr-ME、sr-RS、sv-SE、ta-IN、te-IN、th-TH、tr-TR、uk-UA、ur-PK、vi-VN、zh-CN、zh-TW。
- 応答でクエリの書き換えを取得するには、"debug" を "queryRewrites" に設定します。テストのため "debug": "queryRewrites" プロパティを設定します。パフォーマンスを向上させるため、運用環境ではデバッグを使わないでください。
- "top" を 1 に設定して、最高の検索結果のみを返します。
クエリを実行して結果を返す要求を送信します。

次に、クエリの書き換えを使った検索結果を評価します。

応答を評価する

クエリの書き換えを含む応答の例を次に示します。

"@search.debug": {
  "semantic": null,
  "queryRewrites": {
    "text": {
      "inputQuery": "newer hotel near the water with a great restaurant",
      "rewrites": [
        "new waterfront hotels with top-rated eateries",
        "new waterfront hotels with top-rated restaurants",
        "new waterfront hotels with excellent dining",
        "new waterfront hotels with top-rated dining",
        "new water-side hotels with top-rated restaurants"
      ]
    },
    "vectors": []
  }
},
"value": [
  {
    "@search.score": 58.992092,
    "@search.rerankerScore": 2.815633535385132,
    "HotelId": "18",
    "HotelName": "Ocean Water Resort & Spa",
    "Description": "New Luxury Hotel for the vacation of a lifetime. Bay views from every room, location near the pier, rooftop pool, waterfront dining & more.",
    "Description_fr": "Nouvel h\u00f4tel de luxe pour des vacances inoubliables. Vue sur la baie depuis chaque chambre, emplacement pr\u00e8s de la jet\u00e9e, piscine sur le toit, restaurant au bord de l'eau et plus encore.",
    "Category": "Luxury",
    "Tags": [
      "view",
      "pool",
      "restaurant"
    ],
    "ParkingIncluded": true,
    "LastRenovationDate": "2020-11-14T00:00:00Z",
    "Rating": 4.2,
    "Location": {
      "type": "Point",
      "coordinates": [
        -82.537735,
        27.943701
      ],
      "crs": {
        "type": "name",
        "properties": {
          "name": "EPSG:4326"
        }
      }
    },
    //... more properties redacted for brevity
  }
]

注意すべき重要なポイントがいくつかあります。

"debug" プロパティを "queryRewrites" に設定しているため、応答にはテキスト入力クエリとクエリの書き換えを含む @search.debug オブジェクトが含まれます。
"queryRewrites" プロパティを "generative|count-5" に設定しているため、応答には最大 5 つのクエリの書き換えが含まれます。
"inputQuery" の値は、クエリの書き換えのために生成モデルに送られたクエリです。入力クエリは、ユーザーの "search" クエリと常に同じとは限りません。

クエリの書き換えを行わない応答の例を次に示します。

"@search.debug": {
  "semantic": null,
  "queryRewrites": {
    "text": {
      "inputQuery": "",
      "rewrites": []
    },
    "vectors": []
  }
},
"value": [
  {
    "@search.score": 7.774868,
    "@search.rerankerScore": 2.815633535385132,
    "HotelId": "18",
    "HotelName": "Ocean Water Resort & Spa",
    "Description": "New Luxury Hotel for the vacation of a lifetime. Bay views from every room, location near the pier, rooftop pool, waterfront dining & more.",
    "Description_fr": "Nouvel h\u00f4tel de luxe pour des vacances inoubliables. Vue sur la baie depuis chaque chambre, emplacement pr\u00e8s de la jet\u00e9e, piscine sur le toit, restaurant au bord de l'eau et plus encore.",
    "Category": "Luxury",
    "Tags": [
      "view",
      "pool",
      "restaurant"
    ],
    "ParkingIncluded": true,
    "LastRenovationDate": "2020-11-14T00:00:00Z",
    "Rating": 4.2,
    "Location": {
      "type": "Point",
      "coordinates": [
        -82.537735,
        27.943701
      ],
      "crs": {
        "type": "name",
        "properties": {
          "name": "EPSG:4326"
        }
      }
    },
    //... more properties redacted for brevity
  }
]

クエリの書き換えを行うベクトルクエリ

検索要求にベクトルクエリを含めて、キーワード検索とベクトル検索を 1 つの要求と統合された応答に組み合わせることができます。

クエリの書き換えを行うベクトルクエリを含むクエリの例を次に示します。ベクトルクエリを含むように前の例を変更しました。

POST https://[search-service-name].search.windows.net/indexes/hotels-sample-index/docs/search?api-version=2024-11-01-preview
{
    "search": "newer hotel near the water with a great restaurant",
    "vectorQueries": [
        {
            "kind": "text",
            "text": "newer hotel near the water with a great restaurant",
            "k": 50,
            "fields": "Description",
            "queryRewrites": "generative|count-3"
        }
    ],
    "semanticConfiguration":"en-semantic-config",
    "queryType":"semantic",
    "queryRewrites":"generative|count-5",
    "queryLanguage":"en-US",
    "debug":"queryRewrites",
    "top": 1
}

注意すべき重要なポイントがいくつかあります。

要求に "vectorQueries" オブジェクトを追加しました。このオブジェクトには、"kind" が "text" に設定されたベクトルクエリが含まれます。
"text" の値は "search" の値と同じです。クエリの書き換えが機能するためには、これらの値を同じにする必要があります。

応答には、テキストクエリとベクトルクエリの両方に対するクエリの書き換えが含まれます。

クエリの書き換えのデバッグ

クエリの書き換えをテストして、意図したとおりに動作することを確認する必要があります。応答でクエリの書き換えを取得するには、クエリ要求で "debug": "queryRewrites" プロパティを設定します。 "debug" の設定は、テスト目的では省略可能です。パフォーマンスを向上させるため、運用環境ではこのプロパティを設定しないでください。

応答の text.rewrites と vectors プロパティには空の配列が含まれる場合があります。

{
  "@odata.context": "https://demo-search-svc.search.windows.net/indexes('hotels-sample-index')/$metadata#docs(*)",
  "@search.debug": {
    "semantic": null,
    "queryRewrites": {
      "text": {
        "rewrites": []
      },
      "vectors": []
    }
  },
  "@search.semanticPartialResponseReason": "Transient",
  "@search.semanticQueryRewriteResultType": "OriginalQueryOnly",
  //... more properties redacted for brevity
}

前の例の応答には、"Transient" という値の @search.semanticPartialResponseReason プロパティが含まれます。このメッセージは、少なくとも 1 つのクエリが完了しなかったことを意味します。応答には、値が "OriginalQueryOnly" の @search.semanticQueryRewriteResultType プロパティも含まれます。このメッセージは、クエリの書き換えを使用できないことを意味します。検索結果の取得には、元のクエリのみが使われます。

次のステップ

セマンティックの順位付けは、キーワード検索とベクトル検索を 1 つの要求と統合された応答に結合するハイブリッドクエリで使用できます。

セマンティックランカーを使用するハイブリッドクエリ

次の方法で共有

Azure AI 検索でセマンティックランカーを使ってクエリを書き換える (プレビュー)

クエリの書き換えを使用する理由

前提条件

クエリの書き換えを使用して検索要求を行う

応答を評価する

クエリの書き換えを行うベクトルクエリ

クエリの書き換えのデバッグ

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure AI 検索でセマンティック ランカーを使ってクエリを書き換える (プレビュー)

クエリの書き換えを使用する理由

前提条件

クエリの書き換えを使用して検索要求を行う

応答を評価する

クエリの書き換えを行うベクトル クエリ

クエリの書き換えのデバッグ

次のステップ

フィードバック

その他のリソース

Azure AI 検索でセマンティックランカーを使ってクエリを書き換える (プレビュー)

クエリの書き換えを行うベクトルクエリ