このプロジェクトについて

このリポジトリは、ユーザーが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、4つの読み取り専用クエリツールを公開するAgentCore Gateway、パラメータ化されたSELECTのみの文を構築するTool Lambda、プライベートサブネット内のAurora PostgreSQL Serverless v2が含まれる。AgentCore Memoryはフォローアップ質問のための会話コンテキストを提供する。 このシステムは、回答内のすべての数値がモデルの幻覚ではなくライブデータベースクエリから得られること、および生データがリージョン外に出ないことを保証する。リポジトリには、ワンクリックのCloudFormationまたはPythonデプロイスクリプトによるデプロイオプションが含まれ、クロスリージョン推論プロファイルを拒否するプリフライトチェックを備える。本番環境の考慮事項では、既存のVPCを再利用して既存データベースに接続し、ツールをリードレプリカに向ける方法を扱う。ドキュメントにはアーキテクチャの詳細、デプロイガイダンス、プリフライトチェックリストが含まれる。このプロジェクトはMIT-0でライセンスされている。