クエリ結果の折りたたみ/展開 - Amazon Kendra
結果の折りたたみソート順を使用してプライマリドキュメントを選択するドキュメントのキーストラテジーの欠損結果の拡張他の Amazon Kendra 機能の操作

クエリ結果の折りたたみ/展開

注記

機能のサポートは、使用されているインデックスタイプと検索 API によって異なります。使用しているインデックスタイプと検索 API でこの機能がサポートされているかどうかを確認するには、インデックスのタイプに関するページを参照してください。

Amazon Kendra をデータに接続すると、Kendra は _document_title、_created_at、_document_id などのドキュメントメタデータ属性をクロールし、クエリ時の高度な検索機能を提供するために、これらの属性またはフィールドを使用します。

Amazon Kendra のクエリ結果の折りたたみと展開機能を使用すると、共通のドキュメント属性を使用して検索結果をグループ化して、指定したプライマリドキュメントの下に (折りたたみまたは部分的に展開) 表示できます。

注記

クエリ結果の折りたたみと展開機能は、現在 Amazon Kendra API 経由でのみ利用できます。

これは、次のような検索状況で役に立ちます。

  • インデックス内のドキュメントに複数のバージョンのコンテンツが存在する。エンドユーザーがインデックスをクエリする際に、重複を非表示または折りたたむことにより、最も関連性の高いバージョンのドキュメントを表示する場合。例えば、インデックスに「NYC leave policy」という名前のドキュメントの複数のバージョンが含まれている場合、「Type」属性/フィールドを使用して、特定のグループ「HR」と「Legal」のドキュメントを折りたたむことができます。

    例 1

  • インデックスには、商品在庫など、1 種類の項目またはオブジェクトに関する固有の情報を含む複数のドキュメントが含まれています。アイテム情報の取得やソートしやすくするために、エンドユーザーがアイテムやオブジェクトにリンクされたすべてのドキュメントに 1 つの検索結果としてアクセス可能にする。以下の例では、「animal print shirts」を検索すると、名前でグループ化され、価格の昇順でソートされた結果が返されています。

    例 2

結果の折りたたみ

類似または関連するドキュメントをグループ化するには、折りたたむ属性を指定する必要があります (例えば、_category でドキュメントを折りたたんだり、グループ化したりできます)。これを行うには、クエリ API を呼び出し、CollapseConfiguration オブジェクトを使用して折りたたむ DocumentAttributeKey を指定します。DocumentAttributeKey は、どのフィールドで検索結果を折りたたむかをコントロールします。サポートされている属性キーフィールドには、String と Number が含まれます。String list と Date タイプはサポートされていません。

ソート順を使用してプライマリドキュメントを選択する

折りたたまれたグループにプライマリドキュメントが表示されるように設定するには、CollapseConfiguration の SortingConfigurations パラメータを使用します。例えば、ドキュメントの最新バージョンを取得するには、折りたたまれた各グループを _version でソートします。SortingConfigurations を使用して、ソートする属性/フィールドを 3 つまで指定し、各属性/フィールドのソート順を指定できます。ソート属性数のクォータの引き上げをリクエストできます。

デフォルトでは、Amazon Kendra はクエリのレスポンスを、レスポンスの各結果について決定する関連性スコアでソートされます。デフォルトのソート順序を変更するには、ドキュメント属性をソート可能にしてから、その属性を使用してレスポンスをソートするように Amazon Kendra を設定します。詳細については、「Sorting responses」を参照してください。

ドキュメントのキーストラテジーの欠損

ドキュメントに折りたたみ属性値がない場合、Amazon Kendra には次の 3 つのカスタマイズオプションがあります。

  • COLLAPSE を選択して、null 値または欠損値を含むすべてのドキュメントを 1 つのグループに折りたたみます。これはデフォルトの設定です。

  • IGNORE を選択して、null 値または欠損値を含むドキュメントを無視します。無視したドキュメントは、クエリ結果に表示されません。

  • EXPAND を選択して、null または欠落しているドキュメントをそれぞれ独自のグループに展開します。

結果の拡張

CollapseConfiguration オブジェクトの Expand パラメータを使用して、折りたたまれた検索結果のグループを展開するかどうかを選択できます。展開された結果では、グループのプライマリドキュメントを選択したときと同じソート順序が維持されます。

折りたたまれた検索結果グループの数を展開するように構成するには、ExpandConfiguration オブジェクトの MaxResultItemstoExpand パラメータを使用します。例えば、この値を 10 に設定すると、100 個の結果グループのうち最初の 10 個だけが展開機能を持ちます。

折りたたまれたプライマリドキュメントごとに表示する展開結果の数を設定するには、MaxExpandResultsPerItem パラメータを使用します。例えば、この値を 3 に設定すると、折りたたまれたグループごとに最大 3 つの結果が表示されます。

他の Amazon Kendra 機能の操作

  • 結果を折りたたんだり展開したりしても、ファセットの数は変化せず、表示される結果の総数にも影響しません。

  • Amazon Kendra 注目の検索結果は、設定した折りたたみフィールドと同じフィールド値であっても折りたたまれません。

  • 結果の折りたたみと展開は、DOCUMENT タイプの結果にのみ適用されます。