عن المشروع

يوفر هذا المستودع بنية مرجعية لروبوت محادثة متوافق مع إقامة البيانات يجيب عن أسئلة باللغة الإنجليزية البسيطة من بيانات منظمة في Aurora PostgreSQL دون مطالبة المستخدمين بكتابة SQL. تبقى جميع البيانات واستدلال الذكاء الاصطناعي داخل منطقة AWS واحدة (ap-south-1، مومباي). يُوضح النمط عبر برنامج دعم الطاقة الشمسية على الأسطح باستخدام بيانات عينة اصطناعية بالكامل، لكن ضوابط الإقامة وتصميم أمان تحويل النص إلى SQL المحكوم قابلان للتطبيق في قطاعات ومناطق جغرافية أخرى. يجمع الحل بين فرض الإقامة في منطقة واحدة على كل طبقة (استدعاء النموذج، الشبكة، الاستضافة) وتحويل النص إلى SQL محكوم ومُتحقق منه عبر قائمة بيضاء على Amazon Bedrock AgentCore. تشمل المكونات الرئيسية AWS WAF للحماية بجدار الحماية، وواجهة مستخدم متصفح مستضافة عبر Amplify، وAPI Gateway (REST أو WebSocket)، وLambda للوكيل يشغل وكيل Strands، وAmazon Bedrock للاستدلال داخل المنطقة بنمط ON_DEMAND، وبوابة AgentCore التي تعرض أربع أدوات استعلام للقراءة فقط، وLambda للأداة يبني عبارات SELECT ذات معاملات فقط، وAurora PostgreSQL Serverless v2 في شبكات فرعية خاصة. توفر ذاكرة AgentCore سياقًا محادثيًا للأسئلة المتابعة. يضمن النظام أن كل رقم في الإجابة يأتي من استعلام قاعدة بيانات مباشر وليس من هلوسة النموذج، وأن لا بيانات خام تغادر المنطقة. يتضمن المستودع خيارات نشر عبر CloudFormation بنقرة واحدة أو سكربت نشر بلغة Python، مع فحوصات مسبقة ترفض ملفات تعريف الاستدلال عبر المناطق. تغطي اعتبارات الإنتاج الاتصال بقاعدة بيانات موجودة عبر إعادة استخدام VPC الخاص بها وتوجيه الأداة إلى نسخة متماثلة للقراءة. تشمل الوثائق تفاصيل البنية وإرشادات النشر وقائمة تحقق مسبقة. المشروع مرخص بموجب MIT-0.