프로젝트 소개

이 저장소는 사용자가 SQL을 작성하지 않고도 Aurora PostgreSQL의 정형 데이터에 대해 평이한 영어 질문에 답변하는, 데이터 상주 규정을 준수하는 챗봇을 위한 참조 아키텍처를 제공한다. 모든 데이터와 AI 추론은 단일 AWS 리전(ap-south-1, 뭄바이) 내에 유지된다. 이 패턴은 완전히 합성된 샘플 데이터를 사용하는 옥상 태양광 보조금 프로그램으로 시연되지만, 상주 제어와 거버넌스가 적용된 text-to-SQL 보안 설계는 다른 분야와 지역에도 적용할 수 있다. 이 솔루션은 모든 계층(모델 호출, 네트워크, 호스팅)에서 단일 리전 상주를 강제하는 동시에 Amazon Bedrock AgentCore에서 화이트리스트 검증을 거친 거버넌스형 text-to-SQL을 결합한다. 핵심 구성 요소로는 방화벽 보호를 위한 AWS WAF, Amplify 호스팅 브라우저 UI, API Gateway(REST 또는 WebSocket), Strands 에이전트를 실행하는 Agent Lambda, 리전 내 ON_DEMAND 추론을 위한 Amazon Bedrock, 네 가지 읽기 전용 쿼리 도구를 노출하는 AgentCore Gateway, 매개변수화된 SELECT 전용 문을 생성하는 Tool Lambda, 프라이빗 서브넷의 Aurora PostgreSQL Serverless v2가 있다. AgentCore Memory는 후속 질문에 대한 대화 맥락을 제공한다. 이 시스템은 답변의 모든 숫자가 모델 환각이 아닌 실시간 데이터베이스 쿼리에서 나오도록 보장하며, 원시 데이터가 리전을 벗어나지 않도록 한다. 저장소에는 원클릭 CloudFormation 또는 Python 배포 스크립트를 통한 배포 옵션이 포함되어 있으며, 사전 점검을 통해 교차 리전 추론 프로파일을 거부한다. 프로덕션 고려 사항으로는 기존 데이터베이스의 VPC를 재사용하고 도구를 읽기 전용 복제본에 연결하는 방법을 다룬다. 문서에는 아키텍처 세부 정보, 배포 지침, 사전 점검 체크리스트가 포함된다. 이 프로젝트는 MIT-0 라이선스로 제공된다.