セマンティック ランカーを構成して検索結果でキャプションを返す

セマンティック ランク付けは、最初の結果セットを反復処理し、意味的に最も関連性の高い結果をスタックの最上位に昇格させる L2 ランク付け手法を適用します。 また、最も関連性の高い用語と語句を強調表示したセマンティック キャプションと、セマンティック回答を取得することもできます。

この記事では、セマンティック再ランク付けの検索インデックスを構成する方法について説明します。

前提条件

• Basic レベル以上の検索サービスは、リージョンの可用性に応じて異なります。

• 検索サービスで有効になっているセマンティック ランカー。

• リッチ テキスト コンテンツを含む既存の検索インデックス。 セマンティック ランク付けは、文字列 (ベクトル以外) フィールドに適用され、情報または説明であるコンテンツに最適です。

クライアントを選択する

次のツールおよびソフトウェア開発キット (SDK) のいずれかを使用して、セマンティック構成を追加できます。

• インデックス デザイナーを使用してセマンティック構成を追加する Azure portal。
• REST クライアントを使用する Visual Studio Code
• Azure SDK for .NET
• Azure SDK for Python
• Azure SDK for Java
• Azure SDK for JavaScript

セマンティック構成を追加する

"セマンティック構成" は、セマンティック ランク付けのフィールド入力を設定する、インデックス内のセクションです。 再構築することなく、セマンティック構成をいつでも追加または更新できます。 複数の構成を作成すると、既定値を指定できます。 クエリ時に、クエリ要求のセマンティック構成を指定するか、空白のままにして既定値を使用します。

セマンティック構成には、名前と次のプロパティがあります。

プロパティ	特性
[タイトル] フィールド	短い文字列 (理想的には 25 語以下)。 このフィールドは、ドキュメントのタイトル、製品の名前、または一意の ID である場合があります。 適切なフィールドがない場合は、空白のままにします。
コンテンツ フィールド	自然言語形式のテキストのより長いチャンク。機械学習モデルで最大トークン入力制限が適用されます。 一般的な例としては、ドキュメントの本文、製品の説明、またはその他の自由形式のテキストがあります。
キーワード フィールド	ドキュメントのタグなどのキーワードのリスト、または項目のカテゴリなどの記述用語。

指定できるタイトル フィールドは 1 つだけですが、コンテンツおよびキーワード フィールドはいくつあっても構いません。 コンテンツおよびキーワード フィールドについては、優先順位の低いフィールドが切り捨てられる可能性があるため、優先順位の順に一覧表示します。

すべてのセマンティック構成プロパティで、割り当てるフィールドは次のようにする必要があります。

• searchable および retrievable として属性付ける
• Edm.String、Collection(Edm.String) 型の文字列、Edm.ComplexType の文字列サブフィールド

Azure Portal

1. Azure portal にサインインし、セマンティック ランク付けが有効になっている検索サービスに移動します。

2. 左側のナビゲーション ウィンドウの [インデックス] からインデックスを選択します。

3. [セマンティック構成] を選択し、次に [セマンティック構成の追加] を選択します。

   

4. [新しいセマンティック構成] ページで、セマンティック構成名を入力し、セマンティック構成で使用するフィールドを選択します。 検索可能および取得可能な文字列フィールドのみが対象です。 コンテンツ フィールドとキーワード フィールドを優先順位に従って一覧表示するようにしてください。

   

5. [保存] を選択して構成設定を保存します。

6. インデックス ページでもう一度 [保存] を選択して、セマンティック構成をインデックスに保存します。

REST API

1. インデックスの作成または更新要求を作成します。

2. セマンティック構成をインデックス定義に (たとえば scoringProfiles または suggesters の後に) 追加します。 既定値の指定は省略可能ですが、複数の構成がある場合に便利です。

   "semantic": {
       "defaultConfiguration": "my-semantic-config-default",
       "configurations": [
           {
               "name": "my-semantic-config-default",
               "prioritizedFields": {
                   "titleField": {
                       "fieldName": "HotelName"
                   },
                   "prioritizedContentFields": [
                       {
                           "fieldName": "Description"
                       }
                   ],
                   "prioritizedKeywordsFields": [
                       {
                           "fieldName": "Tags"
                       }
                   ]
               }
           },
                       {
               "name": "my-semantic-config-desc-only",
               "prioritizedFields": {
                   "prioritizedContentFields": [
                       {
                           "fieldName": "Description"
                       }
                   ]
               }
           }
       ]
   }
   

.NET SDK

Azure SDK for .NET の SemanticConfiguration クラスを使用します。

以下は、Azure SDK チームによって作成されたセマンティック ランク付けサンプルの例です。

string indexName = "hotel";
SearchIndex searchIndex = new(indexName)
{
    Fields =
    {
        new SimpleField("HotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true, IsFacetable = true },
        new SearchableField("HotelName") { IsFilterable = true, IsSortable = true },
        new SearchableField("Description") { IsFilterable = true },
        new SearchableField("Category") { IsFilterable = true, IsSortable = true, IsFacetable = true },
    },
    SemanticSearch = new()
    {
        Configurations =
        {
            new SemanticConfiguration("my-semantic-config", new()
            {
                TitleField = new SemanticField("HotelName"),
                ContentFields =
                {
                    new SemanticField("Description")
                },
                KeywordsFields =
                {
                    new SemanticField("Category")
                }
            })
        }
    }
};

プレビュー バージョンからの移行

セマンティック ランク付けコードがプレビュー API を使用している場合、このセクションでは安定バージョンに移行する方法について説明します。 一般提供を確認するには、変更ログを確認してください。

• 2024-07-01 (REST)
• Azure SDK for .NET (11.5) の変更ログ
• Azure SDK for Python (11.4) の変更ログ
• Azure SDK for Java (11.6) の変更ログ
• Azure SDK for JavaScript (12.0) の変更ログ

セマンティック ランカーの queryLanguage

2023 年 7 月 14 日の時点で、セマンティック ランカーは言語に依存しません。 多言語コンテンツで構成された結果を再ランク付けでき、特定の言語に対するバイアスがありません。 プレビュー バージョンでは、セマンティック ランク付けによってフィールド アナライザーで指定された言語とは異なる結果の優先度が下がります。

セマンティック ランク付けに queryLanguage を使用している場合は、コード内での使用を停止します。 queryLanguage プロパティは、スペル修正などの機能には引き続き適用できますが、セマンティック ランク付けにはされません。

セマンティック ランカーの searchFields

バージョン 2021-04-30-Preview 以降を対象とする REST API およびすべての SDK パッケージでは、searchFields プロパティはセマンティック ランク付けに使用されなくなりました。

代わりに、(検索インデックス内の) semanticConfiguration プロパティを使用して、セマンティック ランク付けに使用される検索フィールドを決定します。 フィールドの優先順位付けを指定するには、この記事の手順に従って、インデックス スキーマに semanticConfiguration を追加します。

searchFields を使用してフル テキスト検索の対象を指定したフィールドのリストに制限する場合、クエリ要求に残しておけます。

次のステップ

セマンティック クエリを実行して、セマンティック構成をテストします。

セマンティック クエリの作成