🤖 AI Task Agent

מנהל משימות שיחתי מבוסס סוכן בינה מלאכותית עם Tool Calling

נהלו את רשימת המשימות שלכם פשוט על ידי שיחה איתה — הסוכן מבין שפה טבעית, מוודא שהנתונים מלאים, ומפעיל את הפונקציה הנכונה בשבילכם

---

📖 על הפרויקט

AI Task Agent הוא מנהל משימות חכם שנשלט באמצעות שיחה חופשית במקום טפסים וכפתורים. שרת FastAPI חושף נקודת קצה (endpoint) לצ'אט שמעבירה את ההודעה שלכם למודל Llama 3.3 70B (דרך Groq Cloud) באמצעות מנגנון Tool Calling בסגנון OpenAI — המודל מחליט לאיזו פעולת משימות התכוונתם (הוספה, הצגה, עדכון או מחיקה), והשרת מבצע אותה בפועל מול מאגר המשימות.

הסוכן נבנה עם דגש על דיוק ואמינות: הוא לא ייצור משימה בלי כותרת, לא יעדכן או ימחק משימה בלי מזהה (ID), ותמיד יסביר למשתמש בדיוק מה לכתוב כדי לתקן בקשה שגויה — כך שהופך מודל שפה גולמי לעוזר בטוח ואמין, ולא לקופסה שחורה שנכשלת בשקט.

בנוסף, הפרויקט כולל דשבורד עמוד יחיד קליל (index.html): פאנל צ'אט לשיחה עם הסוכן בצד אחד, ורשימת משימות חיה בצד השני.

---

✨ תכונות עיקריות

• 💬 שליטה בשפה טבעית — הוספה, עדכון ומחיקה של משימות על ידי הקלדת משפטים רגילים, ללא פקודות נוקשות
• 🧠 Tool Calling מבוסס LLM — הסוכן בוחר את הפונקציה הנכונה בשרת (add_task, get_tasks, update_task, delete_task) וממלא את הפרמטרים שלה מתוך ההודעה שלכם
• 🛡️ בקרות איכות, לא ניחושים — הסוכן מסרב לפעול על סמך קלט חלקי (חסרה כותרת או מזהה משימה) ומציע מיוזמתו את הניסוח הנכון
• 🗂️ מטא-דאטה למשימות — קיבוץ משימות לפי סוג (עבודה, אישי וכו') והוספת תיאור
• ⚡ מודעות למגבלות שימוש (Rate Limit) — דיווח ברור כשמכסת Groq היומית מוצתה, במקום קריסה
• 🌐 REST API פשוט — GET /tasks ו-POST /chat, פתוח לכל צד לקוח דרך CORS
• 🖥️ ממשק דשבורד מובנה — עיצוב כהה בסגנון "זכוכית" עם צ'אט ורשימת משימות, ללא צורך בפריימוורק

---

🧱 טכנולוגיות

שכבה	טכנולוגיות
Backend	Python, FastAPI
מנוע בינה מלאכותית	Groq Cloud עם מודל Llama-3.3-70B, דרך ממשק ה-Tool Calling של OpenAI SDK
קונפיגורציה	python-dotenv לניהול מפתחות API
Frontend	דשבורד עמוד יחיד ב-HTML/CSS/JS פשוט

---

🗂️ מבנה הפרויקט

my-ai-task-agent/
├── main.py             # אפליקציית FastAPI — נתיבי /tasks ו-/chat
├── agent_service.py     # הסוכן: הגדרת הכלים, ה-system prompt, וטיפול בקריאות הכלים
├── todo_service.py       # מאגר משימות בזיכרון (CRUD)
├── index.html              # דשבורד צ'אט עצמאי
└── .gitignore

---

🚀 התקנה והרצה מקומית

דרישות מקדימות

• Python 3.10 ומעלה
• מפתח API חינמי מ-Groq Cloud

1. שכפול הריפוזיטורי

git clone https://github.com/Ester-Developer/my-ai-task-agent.git
cd my-ai-task-agent

2. התקנת תלויות

pip install fastapi uvicorn openai python-dotenv

3. הגדרת מפתח ה-API

צרו קובץ .env בתיקיית הפרויקט הראשית:

GROQ_API_KEY=your_groq_api_key

4. הרצת השרת

uvicorn main:app --reload

ה-API יהיה זמין בכתובת http://127.0.0.1:8000.

5. פתיחת הדשבורד

פתחו את index.html בדפדפן — הוא כבר מוגדר לדבר עם ה-API בכתובת http://127.0.0.1:8000.

---

🔌 סקירת ה-API

Method	Endpoint	תיאור
GET	/tasks	קבלת כל המשימות הקיימות
POST	/chat	שליחת הודעה בשפה טבעית; הסוכן מפרש אותה ומחזיר תשובה

דוגמה:

curl -X POST http://127.0.0.1:8000/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "add a task to buy groceries"}'

---

🗺️ למי מיועד הפרויקט

הפרויקט מדגים דפוס מעשי לבניית סוכני בינה מלאכותית בטוחים מבוססי Tool Calling מעל שרת אמיתי: אימות קלט קפדני, הכוונה ברורה למשתמש במקרה של שגיאה, והפרדה נקייה בין שכבת הסוכן, הלוגיקה העסקית וה-API. זוהי נקודת פתיחה טובה להרחבה למסד נתונים קבוע, אימות משתמשים מרובים, או תהליכי משימות עשירים יותר (תאריכי יעד, עדיפויות, תזכורות).

---

Built with ❤️ and 🤖 by Ester-Developer