コンテンツにスキップ

Amazon Bedrock

Amazon Bedrock は、統合APIを通じて主要なAI企業の基盤モデルへのアクセスを提供するフルマネージドAWSサービスです。ブランドはAWS上で生成AIアプリケーションを構築・スケーリングできます。

連携について

BrazeとAmazon Bedrockの連携により、Amazon Bedrockの認証情報をBrazeに接続し、カスタムAIエージェントの構築時にBedrockでホストされているモデルを使用できます。この連携を利用すると、エージェントはAmazon Bedrockで利用可能なモデルを使って、パーソナライズされたコピーの生成、リアルタイムの意思決定、カタログフィールドの更新を行えます。

Amazon Bedrockを接続すると、Brazeはカスタムエージェント向けにキュレートされたBedrockモデルのセットを表示します。Brazeで利用可能なモデルは、AWSアカウント内の全カタログとは異なる場合があります。

Brazeはこの連携にAmazon Bedrockのbedrock-mantleエンドポイントを使用します。Amazon Bedrockでは、モデルおよび機能のサポートが異なる別のbedrock-runtimeエンドポイントについてもドキュメントで説明されています。そのため、利用可能性や動作についてAWSのドキュメントを確認する際は、bedrock-mantleのガイダンスに従ってください。

前提条件

要件 説明
Amazon Bedrock にアクセスできる AWS アカウント モデルがホストされている AWS リージョンで Amazon Bedrock にアクセスできる AWS アカウント。サポートが必要な場合は、管理者または AWS サポートにお問い合わせください。
Amazon Bedrock モデルへのアクセス 使用する予定の Bedrock モデルへの、AWS アカウントでのアクセス権。Anthropic のモデルなど、一部のモデルでは AWS アカウントへのアクセス権の付与が必要です。すべてのモデルがすべての AWS リージョンで利用できるわけではありません。接続する前に、Amazon Bedrock コンソールまたは Regional availability by models で各モデルのリージョン別の利用可否を確認してください。
認証情報 長期の Amazon Bedrock API キー、またはワークスペースで IAM ロール認証が有効になっている場合は、Braze が引き受けることができる IAM ロールのいずれか。
Braze インスタンス Braze インスタンスは、API の概要ページで確認するか、Braze のオンボーディングマネージャーから入手できます。

統合

Amazon Bedrock を Braze に接続するには、次の手順に従います。

  1. Braze ダッシュボードで パートナー連携 > テクノロジーパートナー に移動し、Amazon Bedrock を検索して選択します。
  2. 認証方法 で、API キー または AWS IAM ロール (利用可能な場合) を選択します。
  3. 選択した方法の設定を完了します。
    • API キー: 長期の Amazon Bedrock API キー を入力します。Bedrock モデルがホストされている AWS リージョン を選択します。保存 を選択します。
    • AWS IAM ロール: Braze に表示される値を使用して IAM ロールの信頼ポリシーを設定し、Braze にロールの詳細を入力します。
      1. Braze AWS アカウント ID をコピーし、IAM ロールの信頼ポリシーでそのアカウントを信頼します。
      2. Braze external ID をコピーし、sts:ExternalId 条件を使用してロールの信頼ポリシーでその値を必須にします。新しい値が必要な場合は、新しい external ID を生成 を選択します。
      3. Braze が Amazon Bedrock にアクセスするために必要なアクションを許可する権限ポリシーを IAM ロールにアタッチします。ポリシーには bedrock:CallWithBearerToken と bedrock-mantle:CallWithBearerToken を含める必要があります。Braze はロールを引き受ける際に短期のベアラートークンを生成するため、これらの権限が許可されていない場合、AWS はベアラートークンによる呼び出しを拒否します。また、Braze がモデルを一覧表示して呼び出せるように、ポリシーに bedrock:ListInferenceProfiles、bedrock:InvokeModel、bedrock:InvokeModelWithResponseStream を含め、さらに bedrock-mantle エンドポイント用に bedrock-mantle:CreateInference も含める必要があります。ポリシーの例:
        {
          "Version": "2012-10-17",
          "Statement": [
            {
              "Effect": "Allow",
              "Action": [
                "bedrock:CallWithBearerToken",
                "bedrock:ListInferenceProfiles",
                "bedrock:InvokeModel",
                "bedrock:InvokeModelWithResponseStream"
              ],
              "Resource": "*"
            },
            {
              "Effect": "Allow",
              "Action": [
                "bedrock-mantle:CreateInference",
                "bedrock-mantle:CallWithBearerToken"
              ],
              "Resource": "*"
            }
          ]
        }
        

        より制限の厳しいポリシーにする場合は、必要に応じて "Resource": "*" を特定のモデルまたは推論プロファイルの ARN に置き換えてください。詳細については、Amazon Bedrock actions and resources を参照してください。

      4. Amazon Bedrock の権限を持つ IAM ロールの AWS ロール ARN を入力します。ARN は arn:aws:iam::<account-id>:role/<role-name> の形式と一致する必要があります。
      5. Bedrock モデルがホストされている AWS リージョン を選択します。
      6. 保存 を選択します。

保存すると、Braze に接続済みのステータスと接続日時が表示されます。エージェントコンソールでカスタムエージェントを作成する際に、Amazon Bedrock モデルを選択できるようになります。

統合が機能していることを確認するには、エージェントコンソールに移動し、Bedrock モデルのいずれかを使用してテストエージェントを作成します。「ジョークを言って」などの指示を入力し、テスト呼び出しを実行して、モデルが想定どおりに応答することを確認します。

統合を削除するには、Amazon Bedrock 統合 ページで 接続解除 を選択します。

Amazon Bedrock のアカウントや認証情報に関する問題については、AWS サポートにお問い合わせください。

New Stuff!