折叠/展开查询结果
注意
功能支持因所用索引类型和搜索 API 而异。要查看您使用的索引类型和搜索 API 是否支持此功能，请参阅索引类型。
当您将 Amazon Kendra 连接到您的数据时，它会抓取文档元数据属性（例如，_document_title、_created_at、和 _document_id），并在查询时使用这些属性或字段提供高级搜索功能。
Amazon Kendra 的“折叠和展开查询结果”功能允许您使用常用文档属性对搜索结果进行分组，并在指定的主文档下显示搜索结果（折叠或部分展开）。
注意
折叠和展开查询结果功能目前只能通过 Amazon KendraAPI 使用。
这在以下几种搜索情况下很有用：
-
索引中的文档中存在多个版本的内容。当您的最终用户查询索引时，您希望他们看到包含隐藏/折叠重复项的最相关的文档版本。例如，如果您的索引包含名为“NYC leave policy”的文档的多个版本，则可以选择使用“Type”属性/字段折叠特定组“HR”和“Legal”的文档。
-
您的索引包含多个文档，其中包含有关一种商品或对象（例如产品库存）的唯一信息。为了方便地捕获项目信息以及对其排序，您希望最终用户能够将项目或对象链接的所有文档作为一个搜索结果进行访问。在以下示例中，客户搜索“animal print shirts”会返回按名称分组并按价格升序排序的结果。
折叠结果
要将相似或相关的文档分为一组，您必须指定要折叠的属性（例如，您可以按 _category 折叠文档或对其分组）。为此，请调用 Query API 并使用 CollapseConfiguration 对象来指定要折叠的 DocumentAttributeKey。DocumentAttributeKey控制哪些字段的搜索结果将处于折叠状态。支持的属性键字段包括String和Number。 String list不支持和Date类型。
使用排序顺序选择主文档
要将主文档配置为在折叠的组中显示，请使用 CollapseConfiguration 下的 SortingConfigurations 参数。例如，要获取文档的最新版本，可以按 _version 对每个折叠的组进行排序。您使用 SortingConfigurations 最多可以指定 3 个要作为排序依据的属性/字段以及每个属性/字段的排序顺序。您可以请求增加排序属性的数量的限额。
默认情况下，Amazon Kendra按其为响应中的每个结果确定的相关性分数对查询响应进行排序。要更改默认排序顺序，请将文档属性设置为可排序，然后配置Amazon Kendra为使用这些属性对响应进行排序。有关更多信息，请参阅 响应。
缺少文档密钥策略
如果您的文档没有折叠属性值，则会Amazon Kendra提供三个自定义选项：
-
选择一个组中包含空值或缺失值
COLLAPSE的所有文档。这是默认配置。 -
选择值为空或缺失值的
IGNORE文档。被忽略的文档不会出现在查询结果中。 -
将
EXPAND每个具有空值或缺失值的文档选择为一组。
扩大结果
您可以使用 collapseC onfiguration 对象中的Expand参数选择是否展开折叠的搜索结果组。展开的结果与为该组选择主文档时使用的排序顺序相同。
要配置要展开的折叠搜索结果组的数量，可以使用 e x pandConfiguration 对象中的MaxResultItemstoExpand参数。例如，如果将此值设置为 10，则只有 100 个结果组中的前 10 个具有扩展功能。
要配置每个折叠的主文档显示的展开结果数，请使用MaxExpandResultsPerItem参数。例如，如果您将此值设置为 3，则每个折叠的组最多会显示 3 个结果。
与其他 Amazon Kendra 功能交互
-
折叠和展开结果不会改变分面的数量，也不会影响显示的结果总数。
-
即使 Amazon Kendra 精选搜索结果的字段值与您配置的折叠字段相同，也不会折叠。
-
折叠和展开结果仅适用于
DOCUMENT类型的结果。
