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 que você possa 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 modelos disponíveis pelo 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 diferir do catálogo completo na sua conta da AWS.
A Braze usa o endpoint bedrock-mantle do Amazon Bedrock para essa integração. O Amazon Bedrock também documenta um endpoint bedrock-runtime separado, com suporte a modelos e recursos diferentes. Portanto, ao consultar a documentação da AWS sobre disponibilidade ou comportamento, siga as orientações para bedrock-mantle.
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
| Requisitos | Descrição |
|---|---|
| Uma conta AWS com acesso ao Amazon Bedrock | Uma conta AWS com acesso ao Amazon Bedrock na região da AWS onde seus modelos estão hospedados. Para obter ajuda, entre em contato com seu administrador ou com o Suporte da AWS. |
| Acesso aos modelos do Amazon Bedrock | Acesso na sua conta AWS aos modelos do Bedrock que você planeja usar. Alguns modelos, como os da Anthropic, exigem que o acesso seja concedido na sua conta AWS. Nem todos os modelos estão disponíveis em todas as regiões da AWS — verifique a disponibilidade regional de cada modelo no console do Amazon Bedrock ou em Disponibilidade regional por modelos antes de conectar. |
| Credenciais de autenticação | Uma chave de API do Amazon Bedrock de longo prazo ou, quando a autenticação por função IAM estiver ativada para o seu espaço de trabalho, uma função IAM que a Braze possa assumir. |
| Instância da Braze | Você pode encontrar sua instância da Braze na página de visão geral da API ou com seu gestor de integração da Braze. |
Integração
Para conectar o Amazon Bedrock à Braze:
- Acesse Partner Integrations > Technology Partners no dashboard da Braze, depois pesquise e selecione Amazon Bedrock.
- Em Authentication method, escolha API key ou AWS IAM role (quando disponível).
- Conclua a configuração do método escolhido:
- API key: Insira sua Amazon Bedrock API key de longo prazo. Selecione a AWS region onde seus modelos do Bedrock estão hospedados. Selecione Save.
- AWS IAM role: Use os valores que a Braze exibe para configurar a política de confiança da sua função IAM e, em seguida, insira os detalhes da função na Braze:
- Copie o Braze AWS account ID e adicione essa conta como confiável na política de confiança da sua função IAM.
- Copie o Braze external ID e exija-o na política de confiança da sua função com uma condição
sts:ExternalId. Selecione Generate new external ID se precisar de um novo valor. - Insira o AWS role ARN da função IAM que possui permissões do Amazon Bedrock. O ARN deve corresponder a
arn:aws:iam::<account-id>:role/<role-name>. - Selecione a AWS region onde seus modelos do Bedrock estão hospedados.
- Selecione Save.
AWS IAM role aparece apenas para espaços de trabalho em que essa opção de autenticação está ativada. Com a autenticação por função IAM, a Braze assume sua função para gerar credenciais temporárias do Amazon Bedrock e não armazena uma chave de API de longo prazo.
Após salvar, a Braze exibe um status de conexão com a data e o horário da conexão. Você pode selecionar modelos do Amazon Bedrock ao criar um agente personalizado no Console de Agentes.
Nem todos os modelos do Amazon Bedrock estão disponíveis em todas as regiões da AWS. Antes de selecionar uma AWS region na Braze, abra os detalhes do modelo no Amazon Bedrock e confirme que o modelo lista essa região. Modelos que não estão disponíveis na sua região conectada retornam erros durante a invocação do agente (por exemplo, que o modelo não existe ou não está mais disponível). Consulte Models at a glance para mais detalhes.
Para confirmar que a integração está funcionando, acesse o Console de Agentes e crie um agente de teste usando um dos seus modelos do Bedrock. Insira uma instrução como “Me conte uma piada” e execute uma invocação de teste para verificar se o modelo responde conforme esperado.
Para remover a integração, selecione Disconnect na página de Amazon Bedrock integration.
Para problemas com sua conta ou credenciais do Amazon Bedrock, entre em contato com o AWS Support.