Amazon Bedrock

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

중요

The Amazon Bedrock integration은(는) 현재 조기 액세스 단계입니다. 조기 액세스 참여에 관심이 있으시면 Braze account 매니저에게 문의하세요.

통합 정보

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에 대한 가이드를 따르세요.

중요

이 파트너는 Braze Agents가 활성화된 경우에만 기술 파트너 페이지에 표시됩니다. 시작하는 데 도움이 필요하면 고객 성공 매니저에게 문의하세요.

필수 조건

통합

Amazon Bedrock을 Braze에 연결하려면 다음 단계를 따르세요.

1. Braze 대시보드에서 파트너 통합 > 기술 파트너로 이동한 다음 Amazon Bedrock을 검색하여 선택합니다.
2. 인증 방법에서 API 키 또는 AWS IAM 역할(사용 가능한 경우)을 선택합니다.
3. 선택한 방법에 맞게 설정을 완료합니다.
   • API 키: 장기 Amazon Bedrock API 키를 입력합니다. Bedrock 모델이 호스팅되는 AWS 리전을 선택합니다. 저장을 선택합니다.
   • AWS IAM 역할: Braze에 표시되는 값을 사용하여 IAM 역할 신뢰 정책을 구성한 다음, Braze에 역할 세부 정보를 입력합니다.
     1. Braze AWS 계정 ID를 복사하고 IAM 역할의 신뢰 정책에서 해당 계정을 신뢰하도록 설정합니다.
     2. Braze 외부 ID를 복사하고 역할의 신뢰 정책에서 sts:ExternalId 조건으로 이 값을 요구하도록 설정합니다. 새 값이 필요하면 새 외부 ID 생성을 선택합니다.
     3. Braze가 Amazon Bedrock에 액세스하는 데 필요한 작업을 허용하는 권한 정책을 IAM 역할에 연결합니다. 정책에는 bedrock:CallWithBearerToken 및 bedrock-mantle:CallWithBearerToken이 반드시 포함되어야 합니다. Braze는 역할을 수임할 때 단기 bearer 토큰을 생성하며, 이 권한이 허용되지 않으면 AWS는 bearer 토큰 호출을 거부합니다. 또한 Braze가 모델을 나열하고 호출할 수 있도록 bedrock:ListInferenceProfiles, bedrock:InvokeModel, bedrock:InvokeModelWithResponseStream을 포함하고, bedrock-mantle 엔드포인트를 위해 bedrock-mantle:CreateInference도 포함해야 합니다. 정책 예시:

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

        더 제한적인 정책을 사용하려면 필요에 따라 "Resource": "*"를 특정 모델 또는 추론 프로필 ARN으로 바꾸세요. 자세한 내용은 Amazon Bedrock 작업 및 리소스를 참조하세요.

     4. Amazon Bedrock 권한이 있는 IAM 역할의 AWS 역할 ARN을 입력합니다. ARN은 arn:aws:iam::<account-id>:role/<role-name> 형식과 일치해야 합니다.
     5. Bedrock 모델이 호스팅되는 AWS 리전을 선택합니다.
     6. 저장을 선택합니다.

참고

AWS IAM 역할은 이 인증 옵션이 활성화된 워크스페이스에서만 표시됩니다. IAM 역할 인증을 사용하면 Braze는 역할을 수임하여 단기 Amazon Bedrock 자격 증명을 생성하며, 장기 API 키를 저장하지 않습니다.

저장하면 Braze에 연결 날짜 및 시간과 함께 연결됨 상태가 표시됩니다. 에이전트 콘솔에서 커스텀 에이전트를 생성할 때 Amazon Bedrock 모델을 선택할 수 있습니다.

중요

모든 Amazon Bedrock 모델을 모든 AWS 리전에서 사용할 수 있는 것은 아닙니다. Braze에서 AWS 리전을 선택하기 전에 Amazon Bedrock에서 모델 세부 정보를 열고 해당 모델이 그 리전을 지원하는지 확인하세요. 연결된 리전에서 사용할 수 없는 모델은 에이전트 호출 중에 오류를 반환합니다(예: 모델이 존재하지 않거나 더 이상 사용할 수 없다는 오류). 자세한 내용은 모델 한눈에 보기를 참조하세요.

통합이 제대로 작동하는지 확인하려면 에이전트 콘솔로 이동하여 Bedrock 모델 중 하나를 사용해 테스트 에이전트를 생성합니다. “농담 하나 해줘”와 같은 지침을 입력하고 테스트 호출을 실행하여 모델이 예상대로 응답하는지 확인하세요.

통합을 제거하려면 Amazon Bedrock 통합 페이지에서 연결 해제를 선택합니다.

Amazon Bedrock 계정 또는 자격 증명 관련 문제는 AWS Support에 문의하세요.