# 建立 Amazon Bedrock - Converse API 連線

若要與 Amazon Bedrock 通訊，建立連線至 Amazon Bedrock - Converse API 分析來源。在 分析 活動中心、資料載入編輯器 或 指令碼 的「建立」頁面建立連線。

## 可進行的設定

如需設定外部控制參數的完整詳細資訊，請參閱：

* [使用 Converse API](https://docs.aws.amazon.com/bedrock/latest/userguide/conversation-inference-call.html)：瞭解 Converse API 特有的組態參數。

* [基礎模型的推論請求參數和回應欄位](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html)：瞭解您正在使用的模型特有的組態參數。

可在連線對話方塊中進行的設定

| 欄位 | 說明和選項 |
| --- | --- |
| Model ID or ARN | 輸入您要使用的模型的 ID 或 ARN。此資訊可在 Amazon Bedrock 主控台的模型卡頁面中找到。<br><br>支援託管於 Amazon Bedrock Marketplace 的模型。部署模型後，可從 Amazon Bedrock 主控台取得其 ARN。<br><br>您正在使用的模型支援跨區域推論 (CRIS)。<br><br>並非所有模型都可在每個區域中使用。 |
| AWS Region | 選擇託管 AWS 資源的適當地理區域。 |
| Use FIPS Endpoint (US Regions Only) | 選取連線和 AWS 之間的通訊是否使用遵守聯邦資訊處理標準 (FIPS) 特定版本的加密。 |
| Authentication Method | 選擇連線的驗證方式。您可以選取 AWS Auth v4 Signature (預設) 或 Bedrock API Key。 |
| AWS Access Key | 當 Authentication Method 設定為 AWS Auth v4 Signature (預設) 時適用。<br><br>輸入 AWS 存取金鑰 ID，這是存取金鑰對的一部分 (其他是密碼金鑰)，您將需要提供作為認證，以驗證 AWS 帳戶。 |
| AWS Secret Key | 當 Authentication Method 設定為 AWS Auth v4 Signature (預設) 時適用。<br><br>輸入 AWS 密碼金鑰，這是存取金鑰對的一部分 (其他是存取金鑰 ID)，您將需要提供作為認證，以驗證 AWS 帳戶。 |
| Bedrock API Key | 當 Authentication Method 設定為 Bedrock API Key 時適用。<br><br>從 Amazon Bedrock 輸入 API 金鑰。 |
| System Prompt | 選用參數。此文字欄位可讓您在透過提示提供之前，於其中插入您要向模型提供的內容資訊和其他準則。如需更多資訊，請檢閱[官方 Converse API 文件](https://docs.aws.amazon.com/bedrock/latest/userguide/conversation-inference-call.html)。 |
| Maximum Token Count | 設定模型產生的回應長度。 |
| Temperature | 控制模型的回應隨機性。一般而言，值越低，隨機性就越低。<br><br>要使用的設定取決於此參數針對您正在使用的特定模型如何配置。如需更多資訊，請參閱 [Amazon Bedrock 文件](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html)。 |
| Top P | 控制 Token 使用的可能性。通常，值越低，越容易排除較不可能的 Token。<br><br>要使用的設定取決於此參數如何針對您正在使用的特定模型進行配置。如需詳細資訊，請參閱 [Amazon Bedrock 文件](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html)。 |
| Configuration - Guardrails | Amazon Bedrock - Converse API 連接器支援在 Amazon Bedrock 主控台中設定的防護措施。防護措施會套用至要求。<br><br>防護措施有助於保護模型使用者免受惡意和不當內容的侵害。可以設定下列設定：<br><br><ul> <li> <p> <span>Guardrail Identifier (ARN)</span>：您正在使用的防護措施識別碼。</p> </li> <li> <p> <span>Guardrail Version</span>：您正在使用的防護措施版本。</p> </li> <li> <p> <span>Guardrail Trace</span>：提供追蹤功能的追蹤，用於在封鎖不需要的內容時檢視模型程序。</p> </li> </ul><br><br>護欄不適用於所有 Amazon Bedrock 模型。 |
| Association Field | 指定關聯欄位，即輸入資料表格中包含唯一識別碼的欄位。<br><br>在對傳回的結果表格進行端點請求以使用索引鍵與來源欄位表格關聯時，需要在來源資料中包含此欄位。指定的欄位將作為回應中的欄位傳回，並使回應與資料模型中的來源資料相關聯。這可以是具有唯一 ID 的任何欄位，可以來自來源資料，也可以作為表格載入過程的一部分。 |
| Name | 連線的名稱。如果沒有輸入名稱，則使用預設名稱。 |

## 建立新連線

您可以從 分析 活動中心、從現有應用程式中的 資料載入編輯器，或從現有指令碼中的 指令碼 建立連線至分析連接器。按照以下步驟建立連線。

請執行下列動作：

1. 透過資料載入編輯器或 指令碼 存取連接器。

2. 按一下建立新連線。

3. 在空間之下，選取連線所在的空間。

4. 從資料連接器清單中選取 Amazon Bedrock - Converse API。

5. 填寫連線對話方塊欄位。

6. 按一下建立。

您的連線現在列在 資料載入編輯器 或 指令碼 中的資料連線下。

建立連線後，您可以用來載入資料，連同請求和平台的回應。此外，您可以在圖表運算式中使用。如需詳細資訊，請參閱：

* [從 Amazon Bedrock - Converse API 連線中選取和載入資料](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-converse-api-load.htm)

* [在視覺化運算式中使用 Amazon Bedrock - Converse API 連線](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-converse-api-use.htm)