コンテンツにスキップ

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 リージョン を選択します。保存 を選択します。Claude モデルの場合は、Braze がプロンプトの正確なトークン数をカウントできるように、キーの IAM ユーザーに bedrock-mantle:CountTokens も許可することをお勧めします。AWS 管理の AmazonBedrockLimitedAccess ポリシーにはこの権限が含まれていません。
    • AWS IAM ロール: Braze に表示される値を使用して IAM ロールの信頼ポリシーを設定し、Braze にロールの詳細を入力します。
      1. Braze AWS アカウント ID をコピーし、IAM ロールの信頼ポリシーでそのアカウントを信頼します。
      2. Braze external ID をコピーし、sts:ExternalId 条件を使用してロールの信頼ポリシーでその ID を必須にします。新しい値が必要な場合は、新しい 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 をポリシーに含める必要があります。さらに、bedrock-mantle:CountTokens も許可することをお勧めします。これにより、Braze は Claude モデルでプロンプトの正確なトークン数をカウントできます。この権限がない場合、Braze はトークン数を推定するため、モデルのコンテキストウィンドウに収めるために長いプロンプトを必要以上に短縮することがあります。ポリシーの例:
        {
          "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",
                "bedrock-mantle:CountTokens"
              ],
              "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!