סוכן REST API

סוכן ה-REST API מאפשר אינטראקציה חלקה עם שירותי אינטרנט באמצעות שפה טבעית. הוא מפשט את המורכבות של כתובות URL, שיטות HTTP וכותרות (headers), ומאפשר לך להתמקד בנתונים שעליך לשלוף, ליצור או לאמת.

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

• מיפוי שפה טבעית: תרגום הנחיות פשוטות כמו "הבא לי את המשתמש עם אימייל X" לקריאות REST API מדויקות.
• תמיכה מלאה ב-CRUD:
  • שליפה (GET): קבלת משאבים או אוספים.
  • יצירה (POST): שליחת נתונים חדשים למערכת.
  • עריכה (PUT/PATCH): שינוי רשומות קיימות.
  • מחיקה (DELETE): הסרת משאבים.
• אימות חכם: אימות תגובות ה-API מול דרישות אנושיות. הסוכן יכול לחפש בתוך מבני JSON מקוננים כדי למצוא ולאשר ערכים ספציפיים.
• ניתוח מודע להקשר: מספק סיכום של פלט ה-API בשפה שלך (עברית או אנגלית).
• טיפול בנתונים מקוננים: משטח (flattens) מבני JSON מורכבים באופן אוטומטי כדי לסייע למודלי LLM קטנים יותר בחילוץ נתונים מדויק.

🛠 ️ איך זה עובד

1. תרגום כוונה: הסוכן מנתח את ההנחיה בשפה הטבעית שלך וממפה אותה לפעולת REST סטנדרטית (שיטה, נקודת קצה וגוף ההודעה).
2. ביצוע: ה-APITool מבצע את בקשת ה-HTTP בפועל באמצעות httpx.
3. הערכה: לאחר קבלת התגובה, מודל LLM מנתח את הנתונים אל מול ההנחיה המקורית שלך.
4. תוצאה: אתה מקבל את התגובה הגולמית, את הפרשנות של הסוכן וסטטוס אימות (במידה ורלוונטי).

🚦 דוגמאות לשימוש

• "שלוף את כל המשתמשים מנקודת הקצה /users"
• "צור פוסט חדש עם הכותרת 'בדיקת שפיות' והתוכן 'שלום עולם'"
• "ערוך את משתמש 5 ושנה את העיר שלו ל-'תל אביב'"
• "אמת שהאימייל של שרה ברשימת המשתמשים הוא 'sarah@test.com'"
• "מחק את הפוסט שמספרו 10"

⚙ ️ לוגיקה מרכזית

• מיפוי סמנטי: הסוכן עוקב אחר מוסכמות REST סטנדרטיות (למשל, שימוש בשמות רבים עבור אוספים).
• בטיחות: חוקים מובנים מונעים מהסוכן "לנחש" מזהים (IDs) או נתיבי משנה; הוא מעדיף לשלוף אוספים ולסנן כאשר המזהים אינם ידועים.
• ניתוח חזק (Parsing): חילוץ JSON מתקדם מבטיח שגם אם פלט ה-LLM כולל טקסט נוסף, ההנחיה המרכזית תילכד ותבוצע.

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