data insights with amazon q business

Amazon Q 비즈니스와의 데이터 통찰력

소개

Amazon Q Business를 사용하여 자연어 이해로 구조화 된 데이터를 쿼리하십시오. 이 예에서는 Amazon Q 비즈니스를 사용하여 구조화 된 데이터를 쿼리하기위한 아키텍처를 살펴보고 Amazon Q 비즈니스를 통해 Amazon Athena의 쿼리 비용 및 사용 데이터에 대한 응용 프로그램을 구축합니다. Q 비즈니스를 사용할 수 있습니다. 데이터베이스 스키마가 제공 될 때 데이터 소스에 SQL 쿼리 생성, 열 및 테이블을 설명하는 추가 메타 데이터 및 지침을 제시 할 수 있습니다. 이 아키텍처는 추가 데이터 소스, 쿼리 검증 및 더 넓은 범위의 사용 사례를 다루기 위해 프롬프트 기술을 사용하도록 확장 될 수 있습니다.

건축학

워크 플로에는 다음 단계가 포함됩니다.

1. 먼저 사용자는 응용 프로그램로드 밸런서 뒤에 호스팅되는 챗봇 응용 프로그램에 액세스합니다.

2. 사용자는 Cognito로 로그를 올라야합니다

3. 응용 프로그램은 Amazon Q 비즈니스의 범위와 함께 IAM Identity Center 토큰과 Cognito의 토큰을 교환합니다.

4. 응용 프로그램은 IAM 역할을 맡고 IAM Identity Center 토큰과 함께 Amazon Q Business와 상호 작용하기 위해 보안 토큰 서비스 (STS)에서 AWS 세션을 검색합니다.

5. 응용 프로그램은 Amazon Q 비즈니스의 Chat_Sync API를 자연어 쿼리를 기반으로 한 관련 프롬프트 및 메타 데이터를 호출합니다. Amazon Q Business는 관련 Athena 쿼리로 다시 응답합니다.

6. 쿼리는 Athena에 대해 실행되며 결과는 WebApp에 표시됩니다.

전제 조건

• AWS Identity Center를 설정하고 Q 비즈니스 응용 프로그램에서 액세스 할 사용자를 추가해야합니다.
• 기존의 Working Amazon Q 비즈니스 애플리케이션 및 이전 단계에서 응용 프로그램에 대한 사용자에게 액세스 할 수 있습니다.
• CUR 데이터는 Athena에서 사용할 수 있습니다. CUR 데이터가 있으면 CUR 데이터 설정을 위해 아래 단계를 건너 뛸 수 있습니다. 그렇지 않은 경우 CUR 데이터를 설정하는 몇 가지 옵션이 있습니다.
  • 샘플 큐어 데이터를 설정하려면이 실험실로 이동하여 지침을 따르십시오.
  • 또한 Athena에서 데이터를 사용할 수 있도록 접착제 크롤러를 설정해야합니다.
• 이미 SSL 인증서가있는 경우이 단계를 건너 뛸 수 있습니다. 그렇지 않으면 개인 인증서를 생성하십시오.
• ACM (Alciation)을 AWS 인증서 관리자로 가져옵니다. 자세한 내용은 인증서 가져 오기를 참조하십시오.

이 솔루션을 배포하십시오.

1 단계 : git repo를 복제하십시오

 git clone https://github.com/aws-samples/data-insights-with-amazon-q-business.git

• app/schemas/cur_schema.txt 에서 테이블 이름을 검토하십시오. CUR 데이터 설정 단계에서 만든 테이블 이름과 일치해야합니다. 기본적으로 테이블 이름은 customer_all 입니다. 데이터마다 스키마/테이블 이름을 수정할 수도 있습니다.
• 또한 app/qb_config.py 에서 프롬프트를 검토하십시오. 데모의 경우 코드 리포지토리를 우편화하여 S3 버킷에 업로드하십시오. 나중에 테스트 결과를 기반으로 프롬프트를 수정할 수도 있습니다.

2 단계 : AWS CloudFormation 템플릿을 시작하여 EC2 인스턴스를 포함하여 ELB 인 Cognito 사용자 풀을 배치하여 WebApp을 호스팅합니다.

스택에 대한 다음 매개 변수를 제공하십시오

• 스택 이름 -CloudFormation 스택의 이름 (예 : AmazonQ-Data-Insights-Demo)

• athenadbname -CUR 테이블이있는 Athena 데이터베이스 이름

• Athenas3loc -Athena 출력을위한 S3 위치

• Authname - Amazon Cognito 사용자 풀에 할당하는 전 세계적으로 고유 한 이름

• 증명서 - 이전 단계에서 생성 된 인증서

• IdCapplicationArn - IdcapplicationAn - Identity Center 고객 애플리케이션 ARN, 신뢰할 수있는 토큰 발행자와 함께 iAM Identity Center 애플리케이션을 만들기 위해이 스택의 일부로 Cognito 사용자 풀을 작성해야하므로 첫 번째 실행에 비워 두십시오.

• 대중 서부티드 - 적어도 2를 사용하십시오 . EC2 인스턴스 및 응용 프로그램로드 밸런서를 배포하는 데 사용할 수있는 공개 서브넷의 ID

• QapplicationId - Amazon Q의 기존 응용 프로그램 ID

• S3Codeloc- 코드 ZIP 파일의 전체 S3 위치

• VPCID - 데모를 배포하는 데 사용할 수있는 기존 VPC의 ID

스택이 완료되면 출력 탭에서 다음 키를 복사하십시오.

잠재 고객 : Identity Center에서 고객 애플리케이션을 설정하는 잠재 고객

Rolearn : Identity Center에서 토큰 교환을 설정하는 데 필요한 IAM 역할의 ARN

TRUSTEDISSUERURL : 신뢰할 수있는 발행자의 엔드 포인트는 Identity Center를 설정합니다.

URL : LOAD BALANCER URL을 통해 Streamlit 앱에 액세스하십시오.

다음 단계 : 더 계속 진행하려면이 솔루션에 나열된 2-6 단계를 따라 WebApp을 배포해야합니다.

로그인

이제 자격 증명을 사용하여 앱에 로그인 할 수 있습니다.

예

엔드 투 엔드 워크 플로에는 5 가지 주요 단계가 있습니다.

1. 사용자 의도 - 자연어 쿼리
2. 프롬프트 빌더 - 테이블 스키마 및 메타 데이터 정보와 함께 Q 비즈니스를위한 도메인 프롬프트 열기
3. Amazon Q Business는 쿼리를 생성합니다
4. 쿼리는 Athena에 대해 실행됩니다
5. 결과는 webApp에 표시됩니다.

샘플 데이터 세트는 2023 년의 것입니다. 현재 연도 를 참조하는 자연어 쿼리는 결과를 반환하지 않습니다.

다음은 이제 실행할 수있는 더 많은 샘플 자연 언어 쿼리입니다.

 - what were the top 3 services by spend last year
- Total spend for ES for each month of 1st quarter of last year
- Give me a list of the top 3 products by total spend last year. For each of these products, what percentage of the overall spend is from this product?
- what all sagemaker instance types i used last year and what was their cost

대청소

클라우드 형성 스택, Q 비즈니스 응용 프로그램 및 Athena 테이블을 삭제하십시오.

보안

자세한 내용은 기여를 참조하십시오.

특허

이 라이브러리는 MIT-0 라이센스에 따라 라이센스가 부여됩니다. 라이센스 파일을 참조하십시오.