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

# 在 Amazon Bedrock 中使用重新排名器模型
<a name="rerank-use"></a>

您可以直接使用重新排名器模型，或在知識庫查詢期間擷取結果時使用。選擇您偏好方法的索引標籤，然後遵循下列步驟：

------
#### [ Console ]

您無法直接在 中使用重新排名器模型 AWS 管理主控台，但您可以在查詢知識庫時使用重新排名器模型，方法如下：

1. 當您查詢知識庫時，請選擇 ![](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/configurations.png) 圖示以開啟**組態**窗格。

1. 展開**重新排名**區段。

1. 選擇**選取模型**，然後選取重新排名模型。

1. 如果您的 Amazon Bedrock Knowledge Bases 服務角色缺少[使用重新排名器模型的許可](rerank-prereq.md)，請選取**更新服務角色**以修改具有適當許可的角色。

1. (選用) 在**其他重新排名選項**區段中，修改您需要的任何選項。

1. 輸入提示，然後選取**執行**。回應是套用重新排名器模型之後的結果。

如需執行知識庫查詢的詳細說明，請參閱 [查詢知識庫並擷取資料](kb-test-retrieve.md) 和 [查詢知識庫並根據擷取的資料產生回應](kb-test-retrieve-generate.md)。

------
#### [ API ]

如需在知識庫查詢期間使用重新排名器模型的說明，請參閱 [查詢知識庫並擷取資料](kb-test-retrieve.md)和 [查詢知識庫並根據擷取的資料產生回應](kb-test-retrieve-generate.md)。

若要直接搭配 Amazon Bedrock API 使用重新排名器模型，請傳送具有 [Amazon Bedrock 代理人執行時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt)的[重新排名](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rerank.html)請求。

下列是必要欄位：


****  

| 欄位 | 基本描述 | 
| --- | --- | 
| queries | 一個 [RerankQuery](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankQuery.html) 物件的陣列。指定 TEXT 做為 type，並在 textQuery 欄位中包含查詢。 | 
| sources | 要提交至重新排名模型的 [RerankSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankSource.html) 物件陣列。對於每個 RerankSource，指定 INLINE 做為 type，並在 inlineDocumentSource 欄位中包含 [RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html) 物件。請參閱下方以取得 RerankDocument 的相關詳細資訊。 | 
| rerankingConfiguration | 包含所要使用重新排名模型的 Amazon Resource Name (ARN)，和重新排名後要傳回的結果數量，以及選擇性包含模型的推論組態。您可以將其他模型組態指定為鍵/值對。如需詳細資訊，請參閱 Cohere 文件網站上的[重新排名](https://docs.cohere.com/reference/rerank)。 | 

以下是選填欄位：


****  

| 欄位 | 使用案例 | 
| --- | --- | 
| nextToken | 在上一個回應中傳回的字符，您可以包含此字符以提供下一批次的結果。 | 

所包含 `RerankSource` 物件的格式取決於文件的格式。若要查看不同 `RerankSource` 類型的格式，請選擇對應至文件格式的索引標籤：

------
#### [ String ]

如果文件是字串，請將 [RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html) 物件 `type` 的欄位值指定為 `TEXT`，並在 `text` 欄位中包含文件。例如：

```
{
    "inlineDocumentSource": {
        "textDocument": {
            "text": "string"
        },
        "type": "TEXT"
    },
    "type": "INLINE"
}
```

------
#### [ JSON object ]

如果文件是 JSON 物件，請將 [RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html) 物件中的 `type` 欄位值指定為 `JSON`，並在 `jsonDocument` 欄位中包含此文件。例如：

```
{
    "inlineDocumentSource": {
        "jsonDocument": JSON value,
        "type": "JSON"
    },
    "type": "INLINE"
}
```

------

對 `Rerank` 請求的回應會在 `results` 欄位中傳回 [RerankResult](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankResult.html) 物件的清單。每個物件皆包含下列欄位：
+ `document` – 包含您提交之文件的相關資訊。
+ `relevanceScore` – 文件的相關性分數，由重新排名模型指派。
+ `index` – 指出文件相對於清單中其他文件的排名。分數越低，排名越高。

如果顯示的結果太多，則回應會在 `nextToken` 欄位中傳回值。在此情況下，若要查看下一批結果，請在後續請求中包含該字符。

------