Sobre o projeto

Este repositório fornece uma arquitetura de referência para um chatbot compatível com residência de dados que responde perguntas em linguagem simples a partir de dados estruturados no Aurora PostgreSQL sem exigir que os usuários escrevam SQL. Todos os dados e a inferência de IA permanecem em uma única região da AWS (ap-south-1, Mumbai). O padrão é demonstrado com um programa de subsídio para energia solar em telhados usando dados de amostra totalmente sintéticos, mas os controles de residência e o design de segurança governado de texto para SQL são aplicáveis a outros setores e geografias. A solução combina aplicação de residência em uma única região em todas as camadas (invocação de modelo, rede, hospedagem) com texto para SQL governado e validado por lista de permissões no Amazon Bedrock AgentCore. Os componentes principais incluem AWS WAF para proteção por firewall, uma interface de navegador hospedada no Amplify, API Gateway (REST ou WebSocket), um Agent Lambda executando um agente Strands, Amazon Bedrock para inferência ON_DEMAND na região, o AgentCore Gateway expondo quatro ferramentas de consulta somente leitura, um Tool Lambda que cria instruções SELECT parametrizadas somente leitura e Aurora PostgreSQL Serverless v2 em sub-redes privadas. O AgentCore Memory fornece contexto conversacional para perguntas de acompanhamento. O sistema garante que cada número em uma resposta venha de uma consulta ao banco de dados ao vivo, e não de alucinação do modelo, e que nenhum dado bruto saia da região. O repositório inclui opções de implantação via CloudFormation com um clique ou um script de implantação em Python, com verificações preliminares que rejeitam perfis de inferência entre regiões. As considerações de produção abrangem a conexão com um banco de dados existente reutilizando sua VPC e apontando a ferramenta para uma réplica de leitura. A documentação inclui detalhes de arquitetura, orientações de implantação e uma lista de verificação preliminar. O projeto está licenciado sob MIT-0.