نظرة عامة على سير العمل

هذا سير عمل لمساعد ذكي قائم على الذكاء الاصطناعي للدردشة مع قواعد بيانات PostgreSQL، ويتيح للمستخدمين التفاعل مع قاعدة البيانات عبر لغة طبيعية لإجراء الاستعلامات. يستخدم هذا السير نموذج لغة من OpenAI لفهم نوايا المستخدم، ويولّد ويُنفّذ استعلامات SQL تلقائيًا، ثم يُعيد نتائج الاستعلام بطريقة سهلة الفهم.

الميزات الأساسية

توليد استعلامات ذكية
يفهم الوكيل الذكي (AI Agent) طلبات المستخدم المكتوبة بلغة طبيعية، ويولّد تلقائيًا جمل استعلام SQL المتوافقة مع هيكل قاعدة البيانات. ويحرص الذكاء الاصطناعي على أن تتضمّن أسماء الجداول بادئة schema الصحيحة لتجنب أخطاء الاستعلام.

إدراك هيكل قاعدة البيانات
يستطيع النظام الحصول تلقائيًا على معلومات schema قاعدة البيانات، وقائمة الجداول، والتعريفات التفصيلية لكل جدول (بما في ذلك أسماء الأعمدة، أنواع البيانات، والعلاقات الخارجية)، مما يمكّن الذكاء الاصطناعي من إنشاء استعلامات دقيقة.

وظيفة الذاكرة الحوارية
تم دمج وظيفة تسجيل سجل الدردشة، مع الاحتفاظ افتراضيًا بأحدث 5 رسائل دردشة، مما يسمح للذكاء الاصطناعي بفهم السياق وتقديم تجربة حوار أكثر اتساقًا.

مكوّنات سير العمل

عقدة المشغّل (Trigger Node)

• When chat message received: مشغّل رسالة الدردشة، يستقبل طلبات الاستعلام من المستخدم.

عقد المعالجة الأساسية

• AI Agent: عقدة وكيل ذكي، تنسيق كامل عملية الاستعلام باستخدام وضع OpenAI Functions Agent.
• OpenAI Chat Model: يستخدم نموذج GPT-4o-mini لتوفير القدرات الذكية.
• Chat History: وحدة ذاكرة بنافذة مخزّنة، لإدارة سجل الدردشة.

عقد الأدوات (الأدوات التي يمكن للوكيل الذكي استدعاؤها)

1. Execute SQL Query: تنفيذ جملة استعلام SQL التي يولّدها الذكاء الاصطناعي.
2. Get DB Schema and Tables List: الحصول على قائمة جميع الجداول وأسماء schema المرتبطة بها في قاعدة البيانات.
3. Get Table Definition: الحصول على تعريف تفصيلي لجدول معيّن، بما في ذلك الأعمدة، أنواع البيانات، القيود، والعلاقات الخارجية.

التعليمات البرمجية للنظام (System Prompt)

تم تهيئة مساعد الذكاء الاصطناعي ليؤدي دور مساعد قاعدة البيانات، وتتضمن مسؤولياته الرئيسية ما يلي:

• تشغيل استعلامات قاعدة البيانات بناءً على طلبات المستخدم.
• توليد استعلامات SQL مخصصة لتجميع البيانات.
• ضمان تضمين كل اسم جدول ببادئة schema الصحيحة.
• جمع جميع البيانات الضرورية للتحليل قبل الرد على المستخدم.

الخصائص التقنية

إدارة تلقائية لـ Schema
يستطيع سير العمل التعرّف وإدارة schema قاعدة البيانات تلقائيًا، لضمان صحة بنية استعلامات SQL المولّدة.

تحليل ذكي للبيانات
لا يقتصر الذكاء الاصطناعي على تنفيذ الاستعلامات فحسب، بل يمكنه أيضًا تحليل البيانات المسترجعة، وتقديم تفسيرات ورؤى ذات معنى للمستخدم.

اختيار نموذج مرن
يدعم استبدال النموذج الحالي بنماذج دردشة أخرى، مما يمنحه قابلية توسع جيدة.

نافذة سياق قابلة للتخصيص
يمكن ضبط عدد رسائل الدردشة المحفوظة في السجل، لتحقيق توازن بين الأداء وفهم السياق.

حالات الاستخدام

• استعلام محلّلي الأعمال عن البيانات التشغيلية بسرعة.
• تمكين غير المختصين تقنيًا من الوصول إلى قاعدة البيانات عبر لغة طبيعية.
• استكشاف البيانات والاستعلامات المؤقتة.
• إنشاء تقارير آلية.
• تعلّم وفهم هيكل قاعدة البيانات.

متطلبات التهيئة

1. بيانات اعتماد قاعدة بيانات PostgreSQL.
2. بيانات اعتماد واجهة برمجة تطبيقات OpenAI (API).
3. اختياري: ضبط طول نافذة سجل الدردشة (الافتراضي 5 رسائل).
4. اختياري: تفعيل سير العمل لجعل الدردشة متاحة للعامة.