חיבורי API
הפכו כל API מסוג HTTP לפונקציה שהסוכן שלכם יכול לקרוא לה במהלך שיחה: הדביקו פקודת cURL והאשף יבנה את הגדרת הכלי, הפרמטרים והאימות.
חיבורי API הם פונקציות HTTP מותאמות אישית שהסוכנים שלכם יכולים לקרוא להן במהלך שיחה — לחפש הזמנה, ליצור קריאה, או לאחזר את סטטוס החשבון מהמערכת העורפית שלכם. אתם מגדירים את נקודת הקצה פעם אחת תחת חיבורים → APIs (/dashboard/api-connections); סוכנים שמחובר אליהם החיבור יכולים להפעיל אותו בכל פעם שהשיחה דורשת זאת.
יש שתי דרכים לבנות חיבור: להדביק משהו שהאשף יכול לנתח, או להגדיר את החיבור ידנית.
המסלול המהיר: הדבקה וניתוח
- לחצו על חיבור API חדש
תיבת הדו-שיח נפתחת באשף. הדביקו בתיבה דוגמה של פקודת cURL, מפרט OpenAPI/Swagger, ייצוא Postman, ממשק TypeScript או סכמת Zod.
- לחצו על ניתוח
ThunderPhone מסיק את החיבור המלא מהתוכן שהדבקתם — כתובת URL, שיטה, כותרות וסכמת פרמטרים הנגזרת מפרמטרי השאילתה ומגוף הבקשה שנמצאו. כותרות שהדבקתם, כולל כותרות אימות, מועברות להגדרת נקודת הקצה.
- אשרו את השדות המודגשים
ההגדרה שהוסקה נפתחת כאשר השדות שנאמדו מודגשים לבדיקה. התאימו שמות, תיאורים וסוגי פרמטרים כדי שהסוכן יבין מתי וכיצד לקרוא לפונקציה — התיאור הוא מה שהמודל קורא.
- אמתו ושמרו
השמירה מפעילה תחילה בקשת בדיקה חיה מול נקודת הקצה שלכם. אם הבקשה נכשלת, החיבור לא נשמר — תקנו את כתובת ה-URL, כותרות האימות או הגוף ונסו שוב. במקרה של הצלחה, החיבור נשמר עם תגית מאומת.
אם האשף לא מצליח למצוא כתובת URL של בקשה בתוכן שהדבקתם, הוא יציין זאת —
כללו נקודת קצה מלאה מסוג http(s) ונסו שוב.
הגדרה ידנית
לחצו על הגדרה ידנית → באשף (או על רוצים שה-AI יסיק זאת? נסו את האשף → כדי לחזור). הבונה הידני כולל שני עורכים:
- חזותי — שדות טופס עבור שם התצוגה, שם הפונקציה, כתובת URL
של הבקשה, שיטה (
POST,GET,PUT,PATCH,DELETE), כותרות מותאמות אישית וסכמת הפרמטרים (הוספת מאפיין עבור כל ארגומנט שהסוכן יכול לספק). - JSON — אותה הגדרה כ-JSON גולמי, להדבקה או לכוונון עדין של מפרט כלי ישירות.
חלונית בקשת בדיקה (אופציונלית) מאפשרת לכם להפעיל את הבקשה שהוגדרה לפני השמירה ומציגה את הסטטוס, זמן ההשהיה ותצוגה מקדימה של התגובה. אמתו ושמרו תמיד מפעיל בדיקה זו ושומר רק במקרה של הצלחה.
ניהול החיבורים שלכם
כל שורת חיבור מציגה את סטטוס האימות שלה — מאומת, לא נבדק או שגיאה — את שם הפונקציה ואת הסוכנים שמשתמשים בה. מתפריט הפעולות של השורה תוכלו:
- לערוך — לפתוח מחדש את ההגדרה.
- לשכפל — ליצור עותק כנקודת התחלה (העותק מתחיל כלא נבדק).
- היסטוריית גרסאות — להציג גרסאות קודמות ולשחזר אחת מהן לעורך.
- להעביר — להעתיק או להעביר את החיבור לארגון אחר שאתם חברים בו. העברה מסירה אותו מכאן; ייתכן שסוכנים שהשתמשו בו יצטרכו הגדרה מחדש.
- למחוק — פעולה קבועה; סוכנים שמשתמשים בחיבור יצטרכו הגדרה מחדש.
חיבור לסוכן
הוסיפו את החיבור לסוכן בקטע חיבורי ה-API של הבונה (בניית סוכן). הרשימה מציגה אילו סוכנים משתמשים בכל חיבור, כך שתוכלו לראות במבט אחד על מה משפיע שינוי.