本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 收合/展開查詢結果
<a name="expand-collapse-query-results"></a>

**注意**  
功能支援會因索引類型和正在使用的搜尋 API 而有所不同。若要查看您正在使用的索引類型和搜尋 API 是否支援此功能，請參閱[索引類型](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html)。

當您 Amazon Kendra 連線到資料時，它會編目[文件中繼資料屬性](https://docs.aws.amazon.com/kendra/latest/dg/hiw-document-attributes.html)，例如 `_document_title`、 `_created_at`和 `_document_id`，並使用這些屬性或欄位在查詢期間提供進階搜尋功能。

Amazon Kendra的收合和展開查詢結果功能可讓您使用常見文件屬性將搜尋結果分組，並在指定的主要文件下顯示折疊或部分展開。

**注意**  
摺疊和展開查詢結果功能目前只能透過 [Amazon Kendra API](https://docs.aws.amazon.com/kendra/latest/APIReference/welcome.html) 使用。

這在下列類型的搜尋情況下非常有用：
+ 索引中的文件中存在多個版本的內容。當您的最終使用者查詢索引時，您希望他們查看文件的最相關版本，其中包含隱藏/收合的重複項目。例如，如果您的索引包含名為 "NYC leave policy" 的多個文件版本，您可以選擇使用 "Type" 屬性/欄位來摺疊特定群組 "HR" 和 "Legal" 的文件。  
![範例 1](http://docs.aws.amazon.com/zh_tw/kendra/latest/dg/images/expand-collapse-1.png)
+ 您的索引包含多份文件，其中包含有關一種項目或物件的獨特資訊，例如產品庫存。若要方便地擷取和排序項目資訊，您希望最終使用者存取項目或物件連結的所有文件，做為一個搜尋結果。在下列範例中，客戶搜尋「動物印花襯衫」會傳回依名稱分組的結果，並依遞增價格順序排序。  
![範例 2](http://docs.aws.amazon.com/zh_tw/kendra/latest/dg/images/expand-collapse-2.png)

## 摺疊結果
<a name="expand-results"></a>

若要將類似或相關文件分組在一起，您必須指定要收合的屬性 （例如，您可以依 收合/分組文件`_category`)。若要這樣做，請呼叫[查詢 API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html)，並使用 [CollapseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CollapseConfiguration.html) 物件來指定`DocumentAttributeKey`要收合的 。`DocumentAttributeKey` 控制將摺疊哪些欄位搜尋結果。支援的屬性索引鍵欄位包括 `String`和 `Number`。不支援 `String list`和 `Date`類型。

## 使用排序順序選擇主要文件
<a name="primary-document"></a>

若要將主要文件設定為顯示摺疊群組，請在 [CollapseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CollapseConfiguration.html) 下使用 `SortingConfigurations` 參數。例如，若要取得文件的最新版本，您可以依 排序每個摺疊的群組`_version`。您可以使用 指定最多 3 個要排序的屬性/欄位，以及每個屬性/欄位的排序順序`SortingConfigurations`。您可以請求增加排序屬性數量的配額。

根據預設， 會根據其在回應中為每個結果決定的相關性分數來 Amazon Kendra 排序查詢回應。若要變更預設排序順序，請將文件屬性設為可排序，然後設定 Amazon Kendra 使用這些屬性來排序回應。如需詳細資訊，請參閱[排序回應](https://docs.aws.amazon.com/kendra/latest/dg/tuning-sorting-responses.html#sorting-responses)。

## 缺少文件金鑰策略
<a name="missing-doc-key"></a>

如果您的文件沒有摺疊屬性值， Amazon Kendra 提供三個自訂選項：
+ 在一個群組中選擇具有 null 值或遺失值`COLLAPSE`的所有文件。這是預設組態。
+ 選擇具有 null 或遺失值`IGNORE`的文件。忽略的文件不會出現在查詢結果中。
+ 將具有 null 或遺失值`EXPAND`的每個文件選擇為自己的群組。

## 展開結果
<a name="expanding-results"></a>

您可以使用 [CollapseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CollapseConfiguration.html) 物件中的 `Expand` 參數，選擇折疊的搜尋結果群組是否展開。展開的結果會維持用來選取群組主要文件的相同排序順序。

若要設定要展開的摺疊搜尋結果群組數量，您可以在 [ExpandConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ExpandConfiguration.html) 物件中使用 `MaxResultItemstoExpand` 參數。例如，如果您將此值設定為 10，則只有 100 個結果群組中的前 10 個將具有擴展功能。

若要設定展開的結果數量，以顯示每個摺疊的主要文件，請使用 `MaxExpandResultsPerItem` 參數。例如，如果您將此值設定為 3，則每個摺疊的群組最多會顯示 3 個結果。

## 與其他 Amazon Kendra 功能的互動
<a name="cross-feature-interactions"></a>
+ 摺疊和擴展結果不會變更構面數，也不會影響顯示的結果總數。
+ Amazon Kendra [特徵化搜尋結果](https://docs.aws.amazon.com/kendra/latest/dg/featured-results.html)即使與您設定的收合欄位具有相同的欄位值，也不會收合。
+ 摺疊和擴展結果僅適用於類型 的結果`DOCUMENT`。