Amazon Bedrock

Amazon Bedrock es un servicio de AWS totalmente administrado que proporciona acceso a modelos fundacionales de empresas líderes en IA a través de una API unificada, para que las marcas puedan crear y escalar aplicaciones de IA generativa en AWS.

Acerca de la integración

La integración de Braze y Amazon Bedrock te permite conectar tus credenciales de Amazon Bedrock a Braze para que puedas usar modelos alojados en Bedrock al crear agentes de IA personalizados. Con esta integración, tus agentes pueden generar textos personalizados, tomar decisiones en tiempo real o actualizar campos de catálogo con los modelos disponibles a través de Amazon Bedrock.

Cuando conectas Amazon Bedrock, Braze muestra un conjunto seleccionado de modelos de Bedrock para agentes personalizados. Los modelos disponibles en Braze pueden ser distintos del catálogo completo de tu cuenta de AWS.

Braze usa el endpoint bedrock-mantle de Amazon Bedrock para esta integración. Amazon Bedrock también documenta un endpoint bedrock-runtime independiente, con una compatibilidad diferente de modelos y características. Por eso, cuando consultes la documentación de AWS sobre disponibilidad o comportamiento, sigue las indicaciones para bedrock-mantle.

Importante

Este partner aparece en tu página de Partners tecnológicos solo si tienes habilitados los agentes de Braze. Para obtener ayuda para empezar, ponte en contacto con tu administrador de éxito de cliente.

Requisitos previos

Integración

Para conectar Amazon Bedrock con Braze:

1. Ve a Integraciones de socios > Socios tecnológicos en el panel de Braze y, a continuación, busca y selecciona Amazon Bedrock.
2. En Método de autenticación, elige Clave de API o Rol de AWS IAM (cuando esté disponible).
3. Completa la configuración del método que hayas elegido:
   • Clave de API: Introduce tu clave de API de Amazon Bedrock a largo plazo. Selecciona la región de AWS donde se alojan tus modelos de Bedrock. Selecciona Guardar.
   • Rol de AWS IAM: Usa los valores que muestra Braze para configurar la política de confianza de tu rol de IAM y, a continuación, introduce los datos del rol en Braze:
     1. Copia el ID de cuenta de AWS de Braze y confía en esa cuenta en la política de confianza de tu rol de IAM.
     2. Copia el ID externo de Braze y exígelo en la política de confianza de tu rol con una condición sts:ExternalId. Selecciona Generar nuevo ID externo si necesitas un valor nuevo.
     3. Adjunta al rol de IAM una política de permisos que permita las acciones que Braze necesita para acceder a Amazon Bedrock. La política debe incluir bedrock:CallWithBearerToken y bedrock-mantle:CallWithBearerToken. Braze genera tokens de portador a corto plazo cuando asume el rol, y AWS rechaza las llamadas con tokens de portador a menos que estos permisos estén permitidos. Tu política también debe incluir bedrock:ListInferenceProfiles, bedrock:InvokeModel y bedrock:InvokeModelWithResponseStream para que Braze pueda enumerar e invocar modelos, además de bedrock-mantle:CreateInference para el endpoint de bedrock-mantle. Ejemplo de política:

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

        Para políticas más restrictivas, sustituye "Resource": "*" por ARN específicos de modelos o perfiles de inferencia según sea necesario. Consulta Acciones y recursos de Amazon Bedrock para obtener más información.

     4. Introduce el ARN del rol de AWS del rol de IAM que tiene permisos de Amazon Bedrock. El ARN debe coincidir con arn:aws:iam::<account-id>:role/<role-name>.
     5. Selecciona la región de AWS donde se alojan tus modelos de Bedrock.
     6. Selecciona Guardar.

Nota

Rol de AWS IAM solo aparece en los espacios de trabajo que tienen habilitada esta opción de autenticación. Con la autenticación mediante rol de IAM, Braze asume tu rol para generar credenciales de Amazon Bedrock de corta duración y no almacena una clave de API a largo plazo.

Después de guardar, Braze muestra el estado de conexión con la fecha y la hora en que se estableció. Puedes seleccionar modelos de Amazon Bedrock al crear un agente personalizado en la Consola de agentes.

Importante

No todos los modelos de Amazon Bedrock están disponibles en todas las regiones de AWS. Antes de seleccionar una región de AWS en Braze, abre los detalles del modelo en Amazon Bedrock y confirma que el modelo incluye esa región. Los modelos que no están disponibles en tu región conectada devuelven errores durante la invocación del agente (por ejemplo, que el modelo no existe o ya no está disponible). Consulta Modelos de un vistazo para obtener más información.

Para confirmar que la integración funciona, ve a la Consola de agentes y crea un agente de prueba con uno de tus modelos de Bedrock. Introduce una instrucción como «Cuéntame un chiste» y ejecuta una invocación de prueba para verificar que el modelo responde como esperas.

Para eliminar la integración, selecciona Desconectar en la página Integración de Amazon Bedrock.

Si tienes problemas con tu cuenta o tus credenciales de Amazon Bedrock, ponte en contacto con el soporte de AWS.