Amazon Bedrock

Amazon Bedrock ist ein vollständig verwalteter AWS-Dienst, der über eine einheitliche API Zugang zu Foundation-Modellen führender KI-Unternehmen bietet, sodass Marken generative KI-Anwendungen auf AWS erstellen und skalieren können.

Wichtig

The Amazon Bedrock integration befindet sich derzeit im Early Access. Kontaktieren Sie Ihre:n Braze Account Manager:in, wenn Sie an der Teilnahme am Early Access interessiert sind.

Über die Integration

Mit der Integration von Braze und Amazon Bedrock verbinden Sie Ihre Amazon Bedrock-Zugangsdaten mit Braze. So können Sie bei der Erstellung angepasster KI-Agenten auf Bedrock gehostete Modelle verwenden. Dank dieser Integration können Ihre Agenten mit den über Amazon Bedrock verfügbaren Modellen personalisierte Texte generieren, Entscheidungen in Realtime treffen oder Katalogfelder aktualisieren.

Wenn Sie Amazon Bedrock verbinden, zeigt Braze eine kuratierte Auswahl an Bedrock-Modellen für angepasste Agenten an. Die in Braze verfügbaren Modelle können vom vollständigen Katalog in Ihrem AWS-Konto abweichen.

Braze verwendet für diese Integration den Endpunkt bedrock-mantle von Amazon Bedrock. Amazon Bedrock dokumentiert außerdem einen separaten Endpunkt bedrock-runtime, der andere Modelle und Features unterstützt. Wenn Sie die AWS-Dokumentation zu Verfügbarkeit oder Verhalten lesen, folgen Sie daher den Hinweisen für bedrock-mantle.

Wichtig

Dieser Partner wird auf Ihrer Seite Technologie-Partner nur angezeigt, wenn Sie Braze Agents aktiviert haben. Für Unterstützung beim Einstieg wenden Sie sich an Ihren Customer-Success-Manager.

Voraussetzungen

Integration

So verbinden Sie Amazon Bedrock mit Braze:

1. Gehen Sie im Braze-Dashboard zu Partnerintegrationen > Technologie-Partner, suchen Sie dann nach Amazon Bedrock und wählen Sie es aus.
2. Wählen Sie unter Authentifizierungsmethode entweder API-Schlüssel oder AWS IAM-Rolle (sofern verfügbar).
3. Schließen Sie die Einrichtung für die gewählte Methode ab:
   • API-Schlüssel: Geben Sie Ihren langfristigen Amazon Bedrock API-Schlüssel ein. Wählen Sie die AWS-Region aus, in der Ihre Bedrock-Modelle gehostet werden. Wählen Sie Speichern.
   • AWS IAM-Rolle: Verwenden Sie die von Braze angezeigten Werte, um die Vertrauensrichtlinie Ihrer IAM-Rolle zu konfigurieren, und geben Sie dann die Rollendetails in Braze ein:
     1. Kopieren Sie die Braze AWS-Konto-ID und vertrauen Sie diesem Konto in der Vertrauensrichtlinie Ihrer IAM-Rolle.
     2. Kopieren Sie die Braze externe ID und fordern Sie diese in der Vertrauensrichtlinie Ihrer Rolle mit einer sts:ExternalId-Bedingung an. Wählen Sie Neue externe ID generieren, wenn Sie einen neuen Wert benötigen.
     3. Hängen Sie der IAM-Rolle eine Berechtigungsrichtlinie an, die die Aktionen zulässt, die Braze für den Zugriff auf Amazon Bedrock benötigt. Die Richtlinie muss bedrock:CallWithBearerToken und bedrock-mantle:CallWithBearerToken enthalten – Braze generiert kurzlebige Bearer-Token, wenn es die Rolle übernimmt, und AWS lehnt Bearer-Token-Aufrufe ab, sofern diese Berechtigungen nicht zulässig sind. Ihre Richtlinie sollte außerdem bedrock:ListInferenceProfiles, bedrock:InvokeModel und bedrock:InvokeModelWithResponseStream enthalten, damit Braze Modelle auflisten und aufrufen kann, sowie bedrock-mantle:CreateInference für den bedrock-mantle-Endpunkt. Beispielrichtlinie:

        
        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": "*"
            }
          ]
        }
        
        

        Für restriktivere Richtlinien ersetzen Sie "Resource": "*" nach Bedarf durch bestimmte Modell- oder Inferenzprofil-ARNs. Weitere Informationen finden Sie unter Amazon Bedrock actions and resources.

     4. Geben Sie den AWS-Rollen-ARN für die IAM-Rolle ein, die über Amazon-Bedrock-Berechtigungen verfügt. Der ARN muss dem Muster arn:aws:iam::<account-id>:role/<role-name> entsprechen.
     5. Wählen Sie die AWS-Region aus, in der Ihre Bedrock-Modelle gehostet werden.
     6. Wählen Sie Speichern.

Hinweis

AWS IAM-Rolle wird nur für Workspaces angezeigt, bei denen diese Authentifizierungsoption aktiviert ist. Bei der IAM-Rollenauthentifizierung übernimmt Braze Ihre Rolle, um kurzlebige Amazon-Bedrock-Zugangsdaten zu generieren, und speichert keinen langfristigen API-Schlüssel.

Nach dem Speichern zeigt Braze einen Verbindungsstatus mit Datum und Uhrzeit der Verbindung an. Sie können Amazon-Bedrock-Modelle auswählen, wenn Sie in der Agent Console einen angepassten Agenten erstellen.

Wichtig

Nicht alle Amazon-Bedrock-Modelle sind in jeder AWS-Region verfügbar. Bevor Sie eine AWS-Region in Braze auswählen, öffnen Sie die Modelldetails in Amazon Bedrock und vergewissern Sie sich, dass das Modell diese Region auflistet. Modelle, die in Ihrer verbundenen Region nicht verfügbar sind, geben bei der Agentenausführung Fehler zurück (z. B. dass das Modell nicht existiert oder nicht mehr verfügbar ist). Weitere Informationen finden Sie unter Models at a glance.

Um zu bestätigen, dass die Integration funktioniert, gehen Sie zur Agent Console und erstellen Sie einen Testagenten mit einem Ihrer Bedrock-Modelle. Geben Sie eine Anweisung wie „Erzähl mir einen Witz“ ein und führen Sie einen Testaufruf durch, um zu überprüfen, ob das Modell wie erwartet antwortet.

Um die Integration zu entfernen, wählen Sie Trennen auf der Seite Amazon Bedrock-Integration.

Bei Problemen mit Ihrem Amazon-Bedrock-Konto oder Ihren Zugangsdaten wenden Sie sich an den AWS-Support.