Об этом проекте

Этот репозиторий представляет эталонную архитектуру чат-бота, отвечающего на вопросы на естественном языке по структурированным данным в Aurora PostgreSQL без необходимости писать SQL. Все данные и AI-инференс остаются в пределах одного региона AWS (ap-south-1, Мумбаи). Паттерн демонстрируется на примере программы субсидий на солнечные панели с полностью синтетическими тестовыми данными, однако средства контроля резидентности и управляемая архитектура безопасности text-to-SQL применимы и в других отраслях и регионах. Решение сочетает принудительное соблюдение резидентности в одном регионе на каждом уровне (вызов модели, сеть, хостинг) с управляемым text-to-SQL с валидацией по белому списку на Amazon Bedrock AgentCore. Ключевые компоненты включают AWS WAF для защиты межсетевым экраном, браузерный UI на Amplify, API Gateway (REST или WebSocket), Agent Lambda с агентом Strands, Amazon Bedrock для внутрирегионального инференса ON_DEMAND, AgentCore Gateway с четырьмя read-only инструментами запросов, Tool Lambda, формирующую параметризованные SELECT-only запросы, и Aurora PostgreSQL Serverless v2 в приватных подсетях. AgentCore Memory обеспечивает контекст диалога для уточняющих вопросов. Система гарантирует, что каждое число в ответе получено из живого запроса к базе данных, а не является галлюцинацией модели, и что никакие исходные данные не покидают регион. Репозиторий включает варианты развертывания через CloudFormation в один клик или Python-скрипт развертывания с предполетными проверками, отклоняющими кросс-региональные профили инференса. В производственных рекомендациях рассматривается подключение к существующей базе данных путем повторного использования её VPC и направления инструмента на read-реплику. Документация включает детали архитектуры, руководство по развертыванию и предполетный чек-лист. Проект распространяется под лицензией MIT-0.