Switch to English

תיעוד

כל מה שצריך לדעת על ה-Q-Ace Agentic Framework.

 Q-Ace Database Agent - סוכן מסד נתונים

סוכן בינה מלאכותית רזה ועוצמתי המתרגם שפה טבעית לשאילתות SQL, מבצע אותן מול מסדי נתונים מסוג SQLite, ומספק אימות אינטליגנטי של התוצאות.

תכונות מרכזיות

  • שפה טבעית ל-SQL: שאלו שאלות בעברית או באנגלית וקבלו תרגום מיידי ל-SQL ותצוגת תוצאות בטבלה.
  • אימות חכם (Verify): השתמשו במילות מפתח כמו "תוודא" או "Verify" כדי שה-AI יבדוק אם התוצאות תואמות לציפיות שלכם (למשל: "תוודא שיש 4 עובדים מבריטניה").
  • הצעות לפרומפטים פופולריים: הצעות מותאמות אישית לכל מסד נתונים (Chinook, Northwind וכו') כדי לעזור לכם להתחיל לעבוד במהירות.
  • ניהול SQLite: התחברו לכל קובץ SQLite בתיקיית data/ או העלו קובץ משלכם.
  • היסטוריית שאילתות: צפו, שחזרו ונהלו את השאילתות הקודמות שלכם. ההיסטוריה נשמרת במסד נתונים מקומי.
  • הגדרות מבוססות מסד נתונים: כל ההגדרות (מפתח API, מודל, שפה, עיצוב) נשמרות בקובץ q-ace-database.db, מה שמבטיח עקביות בין דפדפנים ומכשירים.
  • ממשק משתמש מודרני: עיצוב מקצועי עם תמיכה מלאה במצב בהיר/כהה ויישור לימין (RTL) עבור עברית.

טכנולוגיות

  • Frontend: Vanilla HTML5, JavaScript, CSS (Tailwind via CDN).
  • Backend: Vanilla PHP 8.x.
  • Database: SQLite3.
  • LLM: Google Gemini API (Pro/Flash).

התקנה והגדרה

  1. העתיקו את קבצי הפרויקט לשרת התומך ב-PHP (כמו Hostinger או XAMPP).
  2. וודאו שלתיקיית data/ ולשורש הפרויקט יש הרשאות כתיבה עבור קבצי ה-SQLite.
  3. פתחו את האפליקציה בדפדפן.
  4. כנסו ל-הגדרות (אייקון גלגל השיניים) והזינו את ה-Gemini API Key שלכם.
  5. בחרו מסד נתונים מהרשימה והתחילו לשאול!

מבנה הפרויקט

  • index.php: ממשק המשתמש הראשי (Single Page Application).
  • api.php: מטפל בכל בקשות ה-AJAX ומנתב אותן למנהלים המתאימים.
  • db_manager.php: לוגיקה מרכזית לניהול היסטוריה, הגדרות, סכימה ואינטראקציה עם מסדי הנתונים.
  • llm_manager.php: חיבור ל-Gemini API לצורך יצירת SQL ואימות תוצאות.
  • assets/main.js: לוגיקת צד לקוח, תרגומים וניהול מצב הממשק.
  • q-ace-database.db: מסד הנתונים של המערכת המכיל את ההיסטוריה וההגדרות.

הערת אבטחה

הסוכן מוגבל לביצוע שאילתות SELECT בלבד לצורכי הגנה. הוא לא יבצע פקודות מסוג INSERT, UPDATE, DELETE או DROP.


נבנה ב-❤️ על ידי עתיד האוטומציה

האם דף זה היה מועיל?