# 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 でホストされているモデルがサポートされています。モデルを展開した後、その ARN を Amazon Bedrock コンソールから取得できます。<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 秘密キーを入力します。これは、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 | 接続の名前。名前を入力しないと既定名が使用されます。 |

## 新しい接続の作成

分析コネクタへの接続は、分析 アクティビティ センター、既存のアプリケーションの データ ロード エディタ、または既存のスクリプトの スクリプト から作成できます。次の手順に従って、接続を作成します。

次の手順を実行します。

1. データ ロード エディターまたは スクリプト を使用してコネクタにアクセスします。

2. [接続の新規作成] をクリックします。

3. [スペース] で、接続が配置されるスペースを選択します。

4. データ コネクタのリストから Amazon Bedrock - Converse API を選択します。

5. 接続ダイアログの項目に入力します。

6. [作成] をクリックします。

データ ロード エディタ または スクリプト の [データ接続] の下に接続が表示されるようになりました。

接続を作成したら、接続を使用して、リクエストと接続に対するプラットフォームの応答を含むデータをロードできます。さらに、チャートの数式にも使用できます。詳細は以下をご覧ください。

* [Amazon Bedrock - Converse API 接続からのデータの選択とロード](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-converse-api-load.htm)

* [ビジュアライゼーション数式での Amazon Bedrock - Converse API 接続の使用](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-converse-api-use.htm)