Amazon Bedrock

O Amazon Bedrock é um serviço totalmente gerenciado da AWS que fornece acesso a modelos de base de empresas líderes em IA por meio de uma API unificada, para que as marcas possam criar e escalar aplicações de IA generativa na AWS.

Sobre a integração

A integração entre a Braze e o Amazon Bedrock permite conectar suas credenciais do Amazon Bedrock à Braze para usar modelos hospedados no Bedrock ao criar agentes de IA personalizados. Com essa integração, seus agentes podem gerar textos personalizados, tomar decisões em tempo real ou atualizar campos de catálogo usando os modelos disponíveis no Amazon Bedrock.

Quando você conecta o Amazon Bedrock, a Braze exibe um conjunto curado de modelos do Bedrock para agentes personalizados. Os modelos disponíveis na Braze podem ser diferentes do catálogo completo da sua conta da AWS.

A Braze usa o endpoint bedrock-mantle do Amazon Bedrock nessa integração. O Amazon Bedrock também documenta um endpoint bedrock-runtime separado, que oferece suporte a modelos e recursos diferentes. Portanto, ao consultar a documentação da AWS sobre disponibilidade ou comportamento, siga as orientações para o bedrock-mantle.

Importante

Este parceiro aparece na sua página Parceiros de tecnologia apenas se você tiver os Braze Agents ativados. Para ajuda para começar, entre em contato com seu gerente de sucesso do cliente.

Pré-requisitos

Integração

Para conectar o Amazon Bedrock à Braze:

1. Acesse Integrações de parceiros > Parceiros de tecnologia no dashboard da Braze e, em seguida, pesquise e selecione Amazon Bedrock.
2. Em Método de autenticação, escolha Chave de API ou Função do AWS IAM (quando disponível).
3. Conclua a configuração do método escolhido:
   • Chave de API: Insira sua chave de API do Amazon Bedrock de longo prazo. Selecione a região da AWS onde seus modelos do Bedrock estão hospedados. Selecione Salvar.
   • Função do AWS IAM: Use os valores exibidos pela Braze para configurar a política de confiança da sua função do IAM e, em seguida, insira os detalhes da função na Braze:
     1. Copie o ID da conta AWS da Braze e confie nessa conta na política de confiança da sua função do IAM.
     2. Copie o ID externo da Braze e exija-o na política de confiança da sua função com uma condição sts:ExternalId. Selecione Gerar novo ID externo se precisar de um novo valor.
     3. Anexe à função do IAM uma política de permissões que permita as ações de que a Braze precisa para acessar o Amazon Bedrock. A política deve incluir bedrock:CallWithBearerToken e bedrock-mantle:CallWithBearerToken. A Braze gera tokens bearer de curto prazo quando assume a função, e a AWS rejeita chamadas com token bearer se essas permissões não estiverem liberadas. Sua política também deve incluir bedrock:ListInferenceProfiles, bedrock:InvokeModel e bedrock:InvokeModelWithResponseStream para que a Braze possa listar e invocar modelos, além de bedrock-mantle:CreateInference para o endpoint bedrock-mantle. Exemplo 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 mais restritivas, substitua "Resource": "*" por ARNs específicos de modelos ou perfis de inferência, conforme necessário. Consulte Ações e recursos do Amazon Bedrock para mais detalhes.

     4. Insira o ARN da função da AWS da função do IAM que tem permissões do Amazon Bedrock. O ARN deve corresponder a arn:aws:iam::<account-id>:role/<role-name>.
     5. Selecione a região da AWS onde seus modelos do Bedrock estão hospedados.
     6. Selecione Salvar.

Nota

A opção Função do AWS IAM aparece apenas em espaços de trabalho onde esse método de autenticação está ativado. Com a autenticação por função do IAM, a Braze assume sua função para gerar credenciais de curta duração do Amazon Bedrock e não armazena uma chave de API de longo prazo.

Depois de salvar, a Braze exibe o status de conexão com a data e a hora em que ela foi feita. Você pode selecionar modelos do Amazon Bedrock ao criar um agente personalizado no Agent Console.

Importante

Nem todos os modelos do Amazon Bedrock estão disponíveis em todas as regiões da AWS. Antes de selecionar uma região da AWS na Braze, abra os detalhes do modelo no Amazon Bedrock e confirme se essa região aparece na lista do modelo. Modelos indisponíveis na região conectada retornam erros durante a invocação do agente (por exemplo, informando que o modelo não existe ou não está mais disponível). Consulte Visão geral dos modelos para mais detalhes.

Para confirmar se a integração está funcionando, acesse o Agent Console e crie um agente de teste usando um dos seus modelos do Bedrock. Insira uma instrução como “Conte uma piada” e execute uma invocação de teste para verificar se o modelo responde como esperado.

Para remover a integração, selecione Desconectar na página Integração com o Amazon Bedrock.

Em caso de problemas com sua conta ou suas credenciais do Amazon Bedrock, entre em contato com o Suporte da AWS.