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

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

注記

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

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

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

注記

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

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

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

    例 1

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

    例 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。