Amazon Bedrock
Amazon Bedrock은 통합 API를 통해 주요 AI 기업의 파운데이션 모델에 대한 액세스를 제공하는 완전 관리형 AWS 서비스로, 브랜드가 AWS에서 생성형 AI 애플리케이션을 구축하고 확장할 수 있도록 합니다.

The Amazon Bedrock integration은(는) 현재 조기 액세스 단계입니다. 조기 액세스 참여에 관심이 있으시면 Braze account manager에게 문의하세요.
통합 정보
Braze와 Amazon Bedrock 통합을 사용하면 Amazon Bedrock 자격 증명을 Braze에 연결하여 커스텀 인공지능 에이전트를 구축할 때 Bedrock에서 호스팅하는 모델을 사용할 수 있습니다. 이 통합을 통해 에이전트는 개인화된 문구를 생성하고, 실시간 의사 결정을 내리거나, Amazon Bedrock에서 제공하는 모델을 사용하여 카탈로그 필드를 업데이트할 수 있습니다.
Amazon Bedrock을 연결하면 Braze는 커스텀 에이전트를 위해 큐레이트된 Bedrock 모델 세트를 표시합니다. Braze에서 사용할 수 있는 모델은 AWS 계정의 전체 카탈로그와 다를 수 있습니다.
Braze는 이 통합에 Amazon Bedrock의 bedrock-mantle 엔드포인트를 사용합니다. Amazon Bedrock은 모델 및 기능 지원이 다른 별도의 bedrock-runtime 엔드포인트도 문서화하고 있으므로, 가용성이나 동작에 대한 AWS 설명서를 검토할 때는 bedrock-mantle 관련 안내를 따르세요.

전제 조건
| 요구 사항 | 설명 |
|---|---|
| Amazon Bedrock 액세스 권한이 있는 AWS 계정 | 모델이 호스팅되는 AWS 리전에서 Amazon Bedrock에 액세스할 수 있는 AWS 계정이 필요합니다. 도움이 필요하면 관리자 또는 AWS Support에 문의하세요. |
| Amazon Bedrock 모델 액세스 | 사용하려는 Bedrock 모델에 대한 AWS 계정 내 액세스 권한이 필요합니다. Anthropic 모델과 같은 일부 모델은 AWS 계정에서 액세스 권한을 부여받아야 합니다. 모든 모델이 모든 AWS 리전에서 사용 가능한 것은 아닙니다. 연결하기 전에 Amazon Bedrock 콘솔 또는 모델별 리전 가용성에서 각 모델의 리전별 가용성을 확인하세요. |
| 인증 자격 증명 | 장기 Amazon Bedrock API 키 또는 워크스페이스에서 IAM 역할 인증이 활성화된 경우 Braze가 맡을 수 있는 IAM 역할이 필요합니다. |
| Braze 인스턴스 | Braze 인스턴스는 API 개요 페이지에서 확인하거나 Braze 온보딩 매니저에게 문의하여 확인할 수 있습니다. |
통합
Amazon Bedrock을 Braze에 연결하려면 다음을 수행합니다.
- Braze 대시보드에서 파트너 통합 > 기술 파트너로 이동한 다음 Amazon Bedrock을 검색하여 선택합니다.
- 인증 방법에서 API 키 또는 AWS IAM 역할(사용 가능한 경우)을 선택합니다.
- 선택한 방법에 따라 설정을 완료합니다.
- API 키: 장기 Amazon Bedrock API 키를 입력합니다. Bedrock 모델이 호스팅되는 AWS 리전을 선택합니다. 저장을 선택합니다.
- AWS IAM 역할: Braze에 표시되는 값을 사용하여 IAM 역할 신뢰 정책을 구성한 다음, Braze에 역할 세부 정보를 입력합니다.
- Braze AWS 계정 ID를 복사하고 IAM 역할의 신뢰 정책에서 해당 계정을 신뢰합니다.
- Braze 외부 ID를 복사하고
sts:ExternalId조건을 사용하여 역할의 신뢰 정책에서 이를 요구합니다. 새 값이 필요한 경우 새 외부 ID 생성을 선택합니다. - Amazon Bedrock 권한이 있는 IAM 역할의 AWS 역할 ARN을 입력합니다. ARN은
arn:aws:iam::<account-id>:role/<role-name>형식과 일치해야 합니다. - Bedrock 모델이 호스팅되는 AWS 리전을 선택합니다.
- 저장을 선택합니다.

AWS IAM 역할은 이 인증 옵션이 활성화된 워크스페이스에서만 표시됩니다. IAM 역할 인증을 사용하면 Braze가 사용자의 역할을 맡아 단기 Amazon Bedrock 자격 증명을 생성하며, 장기 API 키를 저장하지 않습니다.
저장하면 Braze에 연결 날짜 및 시간과 함께 연결 상태가 표시됩니다. Agent Console에서 커스텀 에이전트를 생성할 때 Amazon Bedrock 모델을 선택할 수 있습니다.

모든 Amazon Bedrock 모델이 모든 AWS 리전에서 사용 가능한 것은 아닙니다. Braze에서 AWS 리전을 선택하기 전에 Amazon Bedrock에서 모델 세부 정보를 열고 해당 모델이 해당 리전을 지원하는지 확인하세요. 연결된 리전에서 사용할 수 없는 모델은 에이전트 호출 시 오류를 반환합니다(예: 모델이 존재하지 않거나 더 이상 사용할 수 없다는 오류). 자세한 내용은 Models at a glance를 참조하세요.
통합이 정상적으로 작동하는지 확인하려면 Agent Console로 이동하여 Bedrock 모델 중 하나를 사용해 테스트 에이전트를 생성합니다. “Tell me a joke”와 같은 지시를 입력하고 테스트 호출을 실행하여 모델이 예상대로 응답하는지 확인합니다.
통합을 제거하려면 Amazon Bedrock 통합 페이지에서 연결 해제를 선택합니다.
Amazon Bedrock 계정 또는 자격 증명에 문제가 있는 경우 AWS Support에 문의하세요.