Skip to content

Latest commit

 

History

History

cdk_bedrock_rag_chatbot

Amazon Bedrock으로 멀티모달 RAG 챗봇 손쉽게 구축하기 실전 가이드

목차


생성형 AI의 중요성이 대두되면서, 기존에 모델 학습부터 시작하는 MLOps보다 더 저렴한 비용으로도 원하는 문서의 내용을 기반으로 AI 결과를 생성하는 RAG (Retrieval-Augmented Generation, 검색 증강 생성) 기법이 함께 주목받고 있습니다. RAG는 맞춤형 데이터를 활용하여, 대규모 언어 모델이 응답을 생성하기 전에 학습 데이터 소스 외부의 맞춤형 지식 베이스를 참조하도록 하는 프로세스를 말합니다. RAG를 활용한 생성형 AI는 대규모 데이터베이스에서 관련 정보를 검색하고 이를 바탕으로 응답을 생성하기 때문에, 모델을 다시 학습 시킬 필요 없이 특정 도메인이나 조직의 내부 지식을 기반으로 LLM 기능을 확장할 수 있는 비용 효율적인 접근 방식입니다.

image

Amazon Bedrock 역시 RAG 구축을 위한 손쉬운 방법으로 Knowledge base 기능을 지원하고 있습니다. Amazon Bedrock Knowledge base를 이용하면 클릭 몇 번으로 FM을 OpenSearch와 같은 RAG용 데이터 소스에 연결해 테스트할 수 있습니다. 본 포스팅에서는 Amazon Bedrock Knowledge base를 활용해 고성능 RAG를 손쉽게 구축하는 방법에 대해 알아보고, 이렇게 구축한 RAG를 아래와 같은 챗봇 애플리케이션 형태로 EC2에 배포하는 방법을 코드와 함께 단계별로 소개합니다.

Architecture & Demo

image

image

Step 1. Knowledge base와 연동할 S3 소스 버킷 생성

먼저 Bedrock Knowledge base와 연동할 S3 버킷을 생성해야 합니다. 해당 링크를 클릭해 us-west-2 (오레곤) 리전에서 AWS S3 Console에 접속해 새로운 버킷을 생성할 수 있습니다. 이후 단계에서 Bedrock Knowledge base를 생성할 때 해당 버킷 이름을 활용해야 하므로 고유하면서 기억하기 쉬운 이름을 입력하고, 그 외 설정은 기본값으로 두고 버킷을 생성합니다.

image

버킷 생성이 완료되면, RAG를 통해 검색하고자 하는 문서를 해당 버킷에 미리 업로드해두겠습니다. (본 실습에서는 50장 분량의 EC2 사용자 가이드 PDF를 업로드했습니다: ec2_userguide_1-50.pdf )

Step 2. Bedrock knowledge base 생성하기

Bedrock model access 요청하기

Bedrock Console에 접근해, 가장 먼저 Bedrock 서비스를 통해 사용하고자 하는 파운데이션 모델 (FM)에 대해 액세스를 요청해야 합니다. 아래 스크린샷과 같이 왼쪽 사이드바에서 Model access를 클릭해 액세스 요청 페이지에 접속합니다.

image

아래와 같이 Model access 페이지에서 ‘Enable specific models’를 클릭합니다.

image

본 실습에서 사용할 모델은 아래와 같습니다. 해당 모델을 선택한 후 Next (다음)을 클릭합니다.

  • Claude 3 Sonnet
  • Titan Embeddings G1 - Text
  • Titan Text Embeddings V2

image

Access 신청을 원하는 모델이 잘 선택되었는지 확인 후 Submit (제출)을 클릭해 신청을 완료합니다. 일부 모델은 Access를 부여받기까지 시간이 소요될 수 있습니다. Access 신청이 완료되면 아래와 같이 Access Status 가 Access granted 로 변경됩니다.

image

Bedrock knowledge base 생성 및 S3 데이터 소스 연결하기

이제 Bedrock Knowledge base를 생성할 준비가 되었습니다. Bedrock Console의 좌측 사이드바에서 Knowledge bases (지식 기반)을 클릭해 생성 화면에 접속하고, ‘Create knowledge base’ 버튼을 클릭합니다.

image

아래와 같이 설정하고, ‘Next (다음)’ 버튼을 눌러 다음 설정으로 이동합니다.

image

다음은 Knowledge base의 Data source를 설정하는 단계입니다. ‘Browse S3’ 버튼을 클릭하고, 앞서 [Step 1]에서 생성했던 버킷을 선택해줍니다.

image image

(선택사항) 검색 성능을 높이기 위해 Chunking and parsing configurations 설정하기

RAG의 검색 성능을 높이고 싶다면 (특히 이미지나 표가 포함되어 있는 복잡한 문서에서 정보를 검색하고자 하는 경우), 해당 섹션을 고려해야 합니다. RAG 시스템이 복잡한 실제 애플리케이션에 적용되기 위해서는 이미지나 표에 있는 데이터도 잘 검색할 수 있는 멀티모달 처리 능력이 필요합니다. 지난 2024.07.10에 Bedrock에 새로 추가된 ‘Chunking and parsing configurations’ 설정을 통해 이러한 성능을 개선하고 멀티모달 RAG를 구현할 수 있습니다.

LLM을 활용한 파싱 기능은 PDF와 같이 구조화되지 않은 문서에서 정보를 구조화하고, 이미지 및 테이블이 포함하고 있는 정보도 검색 가능한 형태로 인덱싱하는 데 도움이 됩니다. 아래와 같이 ‘Chunking and parsing configurations’를 ‘Custom’으로 선택하고, Parsing strategy에서 ‘Use foundation model for parsing’ 체크박스를 선택한 뒤, 파싱에 사용할 모델을 ‘Claude 3 Sonnet v1’과 ‘Claude 3 Haiku v1’ 중 하나로 선택합니다. (해당 실습에서는 Sonnet v1 모델을 사용합니다)

image

위 스크린샷에서 빨간 사각형으로 표시한 부분이 파싱을 위해 LLM에 전달하는 프롬프트입니다. 해당 프롬프트는 원하는 대로 수정할 수 있지만, 해당 실습에서는 기본으로 주어지는 프롬프트를 그대로 사용했습니다. 기본 프롬프트의 내용을 요약하면 아래와 같습니다.

1. 각 페이지를 주의 깊게 살피고, 헤더, 본문 텍스트, 각주, 표, 이미지 및 페이지 번호 등 페이지에 있는 모든 요소를 식별해 마크다운 형식으로 변환합니다. 
    * 메인 제목에는 #, 섹션에는 ##, 하위 섹션에는 ### 등을 사용 (기타 가이드 생략)
2. Visualization (이미지 등) 요소를 발견한 경우, 이에 대한 자세한 설명을 작성합니다.
3. Table (표) 요소를 발견할 경우, 마크다운 테이블로 변환합니다. 

이와 같이 LLM 파싱 기능은 문서를 검색 가능한 형태로 임베딩하기에 앞서 위와 같은 프롬프트를 활용해 LLM이 구조를 재정의하게 함으로써 텍스트는 물론 이미지 및 표에 대한 검색 성능을 높일 수 있습니다. LLM을 사용하는 것이므로 대용량 문서에 활용할 때에는 비용을 고려하는 것이 좋습니다.

이후 Chunking strategy 역시 설정할 수 있습니다. 기본으로 주어지는 Default chunking 외에 다른 옵션을 선택할 수 있으며, 앞서 LLM 파싱을 통해 문서를 마크다운 형태로 파싱했으므로 해당 가이드에서는 Hierachical chunking을 선택했습니다. Token size도 사용 사례에 적합한 크기로 맞춰 설정한 후, ‘Next (다음)’를 눌러 다음 단계로 넘어갑니다.

image

해당 LLM parsing 기능을 활용한 결과로, 아래와 같이 복잡한 표/이미지에 있는 그림도 높은 성능으로 retrieve 해올 수 있는 것을 확인하실 수 있습니다.

image

다양한 Chunking 전략 및 메타데이터 프로세싱 설정과 관련해서는 다음 블로그 게시물을 참고하시면 좋습니다. 대상 문서의 크기, 종류 및 기타 특성을 고려해 상황에 맞는 Chunking 옵션을 선택하는 것이 RAG의 성능을 높이는 데 도움이 됩니다: https://aws.amazon.com/ko/blogs/machine-learning/amazon-bedrock-knowledge-bases-now-supports-advanced-parsing-chunking-and-query-reformulation-giving-greater-control-of-accuracy-in-rag-based-applications/

임베딩 모델 선택 및 벡터 DB로서의 OpenSearch serverless 생성하기

사용할 Embedding 모델을 선택할 수 있으며, 해당 실습에서는 Titan text Embeddings v2 모델을 선택합니다. Vector dimensions 역시 RAG의 정확도 및 속도를 결정하는 요인이므로, 기본 제공되는 값 외에 원하는 값으로 설정이 가능합니다. Vector database로는 ‘Quick create a new vector store’ 옵션을 선택해 OpenSearch Serverless를 새로 생성해줍니다. 이후 ‘Next (다음)’ 버튼을 눌러 검토 단계로 이동하고, 검토 후 ‘Create knowledge base’ 버튼을 클릭해 Knowledge base를 생성합니다. 설정한 내용대로 Knowledge base를 구성하고 OpenSearch Serverless를 생성하는 데에 수 분이 소요됩니다.

image image

생성한 Knowledge Base 콘솔에서 테스트해보기

Knowledge base가 성공적으로 생성되었습니다. Data source에 앞서 [Step 1]에서 만들었던 S3 bucket이 연결되어 있는 것을 확인할 수 있습니다. 해당 Data source를 선택한 뒤, ‘Sync’ 버튼을 클릭해 버킷 내의 데이터를 Knowledge base로 연동해주겠습니다. 데이터의 크기에 따라 수 분에서 수 시간이 소요될 수 있습니다.

image image image

현재까지 구성한 아키텍처는 아래와 같습니다. 아래 보라색 화살표(1)와 같이, RAG에 활용하고자 하는 문서를 데이터 소스로 사용할 S3 버킷에 업로드하고 Knowledge base에 Sync하는 과정을 거치면 OpenSearch Serverless 벡터 스토어에 데이터가 검색 가능한 형태로 인덱싱됩니다. 이후 하늘색 화살표(2)와 같이, 콘솔에서 Bedrock Knowledge base에 질의하는 과정을 테스트해보았습니다.

image

Step 3. EC2에 챗봇 애플리케이션 배포하기

마지막으로, 위에서 생성한 RAG를 챗봇 애플리케이션 형태로 사용할 수 있도록 EC2에 배포해봅시다. AWS CDK를 이용해 간단한 Streamlit 애플리케이션을 EC2에 배포할 것입니다. 위에서 생성한 Bedrock Knowledge base의 ID를 CDK 배포 시 파라미터로 입력하면, 해당 값이 Systems Manager Parameter Store에 저장되어 챗봇을 배포한 EC2 인스턴스에서 이 값에 접근해 RAG에 질의할 수 있도록 하는 간단한 애플리케이션입니다. 따라서 CDK로 스택을 배포하고 나면 아래와 같은 아키텍처가 완성됩니다.

image

전제 조건

Important

만약 CDK 설정이 어려운 상황일 경우, 해당 링크의 가이드를 통해 CDK 대신 수동으로 EC2 애플리케이션을 배포하는 방법을 따라하실 수 있습니다. 아래의 환경이 세팅되어 있지 않다면, 위 링크의 가이드를 통해 아래 설정을 별도로 하지 않고도 애플리케이션을 구성할 수 있으니 편하신 방법으로 구성해주세요.

CDK 스택을 배포하려면 아래의 과정이 로컬 환경에 준비되어 있어야 합니다.

  • Linux 기반 OS (*이 글이 게시되는 현재 Windows 배포 스크립트가 없습니다).
  • NodeJS(버전 18 이상) 및 NPM이 설치되어 있어야 합니다. 설치되어 있는지 확인하려면 다음 명령을 실행하세요.
    $ npm -v && node -v
    7.24.2
    v18.16.1
  • AWS Cloud Development Kit(AWS CDK)가 설치되어 있어야 합니다. 설치되어 있는지 확인하려면 다음 명령을 실행하세요. 설치되어 있지 않다면, npm install -g aws-cdk로 설치할 수 있으며, 자세한 내용은 자습서를 참고해 설치를 완료해주세요.
    $ cdk --version
    2.124.0 (build 4b6724c)
  • 백엔드 리소스를 실행할 AWS 계정과 AWS Command Line Interface(AWS CLI)(v2)가 설치 및 구성되어 있어야 합니다. AWS CLI가 컴퓨터에 설치 및 구성되었는지 확인하려면 다음 명령을 실행하세요. 기본 사용자로 설정되어 있어야 합니다. 이 사용자가 백엔드 리소스를 배포할 수 있는 권한이 있는지 확인합니다.
    $ aws sts get-caller-identity
      {
          "UserId": "AIDxxxxxxxxxxxxxxxT34",
          "Account": "12345678XXXX",
          "Arn": "arn:aws:iam::12345678XXXX:user/admin"
      }

AWS CDK 스택 배포 방법

아래 명령어를 입력해 준비된 CDK 코드를 Github에서 clone 받고, 필요한 패키지를 설치한 뒤, CDK 스택을 배포하기 전에 부트스트랩을 실행합니다. cdk bootstrap 실행 후 아래 스크린샷과 같이 Environment bootstrapped. 라는 메시지가 출력되면 배포를 위한 준비가 완료된 것입니다.

$ git clone https://github.com/aws-samples/kr-tech-blog-sample-code.git
$ cd kr-tech-blog-sample-code/cdk_bedrock_rag_chatbot

$ npm install

$ cdk bootstrap aws://<Account ID>/us-west-2

이후 Bedrock 콘솔에서 생성한 Knowledge base의 ID를 복사한 뒤,

image

아래 명령어의 ENTER_YOUR_KNOWLEDGE_BASE_ID 자리에 붙여넣어 실행합니다. 이후 스크린샷과 같이 ‘Do you wish to deploy these changes (y/n)?’가 나오면 y를 입력해 스택을 배포합니다.

$ cdk deploy --parameters knowledgeBaseId=ENTER_YOUR_KNOWLEDGE_BASE_ID

image

약 5분 뒤, 모든 스택이 배포되고나면 아래와 같이 배포된 EC2의 public ip가 터미널에 출력됩니다. 해당 IP를 클릭해 Streamlit 애플리케이션에 접속할 수 있습니다. 위에서 cdk deploy 명령어를 실행할 때 Knowledge base ID를 함께 넣어주었기 때문에 이 챗봇 애플리케이션은 생성했던 Knowledge base와 연동됩니다.

Warning

만약 배포가 안 됐다면 아래 내용을 확인해보시길 바랍니다.

  1. EC2에 애플리케이션을 완전히 배포하는 데에 약 5분 정도가 추가로 소요될 수 있습니다. 출력된 IP를 클릭했을 때 오류가 발생한다면 약 5분 뒤 다시 접속해보세요.
  2. 접속이 안 된다면 https:// 가 아니라 http:// 로 올바르게 접속했는지 확인해보세요.

image


Step 4. 배포한 애플리케이션 테스트해보기

배포가 무사히 되었다면 아래와 같은 챗봇 애플리케이션에 접속할 수 있습니다. 아래 샘플 질문을 테스트해보시거나, 코드를 자유롭게 커스텀해 자신만의 RAG 챗봇을 만들어보세요.

image

샘플 질문:

  • EC2란 무엇인가요?
    • 예상 답변: Amazon Elastic Compute Cloud (Amazon EC2)는 Amazon Web Services (AWS) 클라우드에서 제공하는 온디맨드 확장 가능한 컴퓨팅 용량 서비스입니다. Amazon EC2를 사용하면 하드웨어 비용을 절감하고 애플리케이션을 더 빠르게 개발 및 배포할 수 있습니다. 필요한 만큼의 가상 서버를 시작하고, 보안 및 네트워킹을 구성하고, 스토리지를 관리할 수 있습니다. EC2 인스턴스는 AWS 클라우드에서 실행되는 가상 서버입니다. EC2 인스턴스를 시작할 때 지정한 인스턴스 유형에 따라 인스턴스에 할당되는 하드웨어 리소스가 결정됩니다. 각 인스턴스 유형은 CPU, 메모리, 네트워크, 스토리지 및 그래픽 하드웨어 리소스의 다양한 조합을 제공합니다.
  • Amazon Bedrock 이란 무엇인가요?
    • 예상 답변: 제공된 검색 결과에는 "Amazon Bedrock"에 대한 정보가 없기 때문에 이에 대해 정확한 답변을 드릴 수 없습니다.
  • Powershell을 위한 AWS tool에 대해 설명해주세요.
    • 예상 답변: AWS는 PowerShell을 위한 AWS Tools for Windows PowerShell 모듈을 제공합니다. 이 모듈은 AWS SDK for .NET의 기능을 기반으로 하며, PowerShell 명령줄에서 AWS 리소스에 대한 작업을 스크립팅할 수 있게 해줍니다. AWS Tools for Windows PowerShell을 사용하면 Amazon EC2와 같은 AWS 서비스에 대한 cmdlet을 사용할 수 있습니다. AWS Tools for Windows PowerShell 사용을 시작하려면 AWS Tools for Windows PowerShell 사용 설명서를 참조하세요. Amazon EC2에 대한 cmdlet은 AWS Tools for PowerShell Cmdlet Reference에서 확인할 수 있습니다.