Amazon Bedrock

Amazon Bedrock est un service AWS entièrement géré qui fournit un accès à des modèles de fondation proposés par les principales entreprises d’IA via une API unifiée, permettant aux marques de créer et de faire évoluer des applications d’IA générative sur AWS.

À propos de l’intégration

L’intégration entre Braze et Amazon Bedrock vous permet de connecter vos identifiants Amazon Bedrock à Braze afin d’utiliser des modèles hébergés sur Bedrock lorsque vous créez des agents d’IA personnalisés. Grâce à cette intégration, vos agents peuvent générer des textes personnalisés, prendre des décisions en temps réel ou mettre à jour des champs de catalogue à l’aide des modèles disponibles via Amazon Bedrock.

Lorsque vous connectez Amazon Bedrock, Braze affiche une sélection de modèles Bedrock pour les agents personnalisés. Les modèles disponibles dans Braze peuvent différer du catalogue complet de votre compte AWS.

Braze utilise l’endpoint bedrock-mantle d’Amazon Bedrock pour cette intégration. Amazon Bedrock documente également un endpoint bedrock-runtime distinct, qui prend en charge des modèles et des fonctionnalités différents. Lorsque vous consultez la documentation AWS au sujet de la disponibilité ou du comportement des modèles, suivez donc les indications relatives à bedrock-mantle.

Important

Ce partenaire n’apparaît sur votre page Partenaires technologiques que si vous avez activé Braze Agents. Pour obtenir de l’aide pour démarrer, contactez votre gestionnaire de la satisfaction client.

Conditions préalables

Intégration

Pour connecter Amazon Bedrock à Braze :

1. Accédez à Intégrations partenaires > Partenaires technologiques dans le tableau de bord de Braze, puis recherchez et sélectionnez Amazon Bedrock.
2. Pour Méthode d’authentification, choisissez Clé API ou Rôle AWS IAM (lorsque cette option est disponible).
3. Effectuez la configuration pour la méthode choisie :
   • Clé API : Saisissez votre clé API Amazon Bedrock à long terme. Sélectionnez la région AWS où vos modèles Bedrock sont hébergés. Sélectionnez Enregistrer.
   • Rôle AWS IAM : Utilisez les valeurs affichées par Braze pour configurer la politique d’approbation de votre rôle IAM, puis saisissez les détails du rôle dans Braze :
     1. Copiez l’ID de compte AWS de Braze et approuvez ce compte dans la politique d’approbation de votre rôle IAM.
     2. Copiez l’ID externe de Braze et exigez-le dans la politique d’approbation de votre rôle avec une condition sts:ExternalId. Sélectionnez Générer un nouvel ID externe si vous avez besoin d’une nouvelle valeur.
     3. Associez au rôle IAM une politique d’autorisations qui permet les actions dont Braze a besoin pour accéder à Amazon Bedrock. La politique doit inclure bedrock:CallWithBearerToken et bedrock-mantle:CallWithBearerToken : Braze génère des jetons bearer à court terme lorsqu’il assume le rôle, et AWS rejette les appels par jeton bearer si ces autorisations ne sont pas accordées. Votre politique doit également inclure bedrock:ListInferenceProfiles, bedrock:InvokeModel et bedrock:InvokeModelWithResponseStream pour que Braze puisse répertorier et invoquer les modèles, ainsi que bedrock-mantle:CreateInference pour l’endpoint bedrock-mantle. Exemple de politique :

        
        1
        2
        3
        4
        5
        6
        7
        8
        9
        10
        11
        12
        13
        14
        15
        16
        17
        18
        19
        20
        21
        22
        23
        
        {
          "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": "*"
            }
          ]
        }
        
        

        Pour des politiques plus restrictives, remplacez "Resource": "*" par des ARN de modèles ou de profils d’inférence spécifiques, selon vos besoins. Pour plus de détails, consultez Actions et ressources Amazon Bedrock.

     4. Saisissez l’ARN du rôle AWS pour le rôle IAM disposant des autorisations Amazon Bedrock. L’ARN doit correspondre à arn:aws:iam::<account-id>:role/<role-name>.
     5. Sélectionnez la région AWS où vos modèles Bedrock sont hébergés.
     6. Sélectionnez Enregistrer.

Remarque

L’option Rôle AWS IAM n’apparaît que pour les espaces de travail où cette méthode d’authentification est activée. Avec l’authentification par rôle IAM, Braze assume votre rôle pour générer des identifiants Amazon Bedrock de courte durée et ne stocke aucune clé API à long terme.

Après l’enregistrement, Braze affiche un statut connecté avec la date et l’heure de la connexion. Vous pouvez sélectionner des modèles Amazon Bedrock lors de la création d’un agent personnalisé dans la console des agents.

Important

Tous les modèles Amazon Bedrock ne sont pas disponibles dans toutes les régions AWS. Avant de sélectionner une région AWS dans Braze, ouvrez les détails du modèle dans Amazon Bedrock et vérifiez que cette région figure dans la liste. Les modèles qui ne sont pas disponibles dans votre région connectée renvoient des erreurs lors de l’invocation de l’agent (par exemple, indiquant que le modèle n’existe pas ou n’est plus disponible). Pour plus de détails, consultez Aperçu des modèles.

Pour vérifier que l’intégration fonctionne, accédez à la console des agents et créez un agent de test à l’aide de l’un de vos modèles Bedrock. Saisissez une instruction telle que « Raconte-moi une blague », puis lancez une invocation de test pour vérifier que le modèle répond comme prévu.

Pour supprimer l’intégration, sélectionnez Déconnecter sur la page Intégration Amazon Bedrock.

Pour tout problème lié à votre compte ou à vos identifiants Amazon Bedrock, contactez le support AWS.