# 创建 Amazon Bedrock - Converse API 连接

要与 Amazon Bedrock 进行通信，请创建与 Amazon Bedrock - Converse API 分析源的连接。正在 Analytics 活动中心、数据加载编辑器 或 脚本 的“创建”页面中创建连接。

## 配置设置

有关配置外部控制参数的完整详细信息，请参阅：

* [使用 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 | 控制令牌使用的可能性。通常排除可能性较小的令牌的可能性越高。<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 | 连接的名称。如果不输入名称，则使用默认名称。 |

## 创建新连接

您可以从 Analytics 活动中心、现有应用程序中的 数据加载编辑器 或现有脚本中的 脚本 创建到分析连接器的连接。按照以下步骤创建连接。

执行以下操作：

1. 通过数据加载编辑器或 脚本 访问连接器。

2. 单击创建新连接。

3. 在空间下，选择连接所在的空间。

4. 从数据连接器列表中选择 Amazon Bedrock - Converse API。

5. 填写连接对话框字段。

6. 单击创建。

连接就会在 数据加载编辑器 或 脚本 中的数据连接下列出。

一旦创建了连接，就可以使用它加载带有请求和平台对请求的响应的数据。此外，您还可以在图表表达式中使用它。有关更多信息，请参阅：

* [从 Amazon Bedrock - Converse API 连接选择并加载数据](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-converse-api-load.htm)

* [在可视化表达式中使用 Amazon Bedrock - Converse API 连接](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-converse-api-use.htm)