---
title: "חיבורי API"
description: "הפכו כל API מסוג HTTP לפונקציה שהסוכן שלכם יכול לקרוא לה במהלך שיחה: הדביקו פקודת cURL והאשף יבנה את הגדרת הכלי, הפרמטרים והאימות."
---
חיבורי API הם פונקציות HTTP מותאמות אישית שהסוכנים שלכם יכולים לקרוא להן במהלך שיחה — לחפש הזמנה, ליצור קריאה, או לאחזר את סטטוס החשבון מהמערכת העורפית שלכם. אתם מגדירים את נקודת הקצה פעם אחת תחת **חיבורים → APIs** (`/dashboard/api-connections`); סוכנים שמחובר אליהם החיבור יכולים להפעיל אותו בכל פעם שהשיחה דורשת זאת.
יש שתי דרכים לבנות חיבור: להדביק משהו שהאשף יכול לנתח, או להגדיר את החיבור ידנית.
## המסלול המהיר: הדבקה וניתוח
תיבת הדו-שיח נפתחת באשף. הדביקו בתיבה דוגמה של **פקודת cURL**,
**מפרט OpenAPI/Swagger**, **ייצוא Postman**, **ממשק TypeScript**
או **סכמת Zod**.
ThunderPhone מסיק את החיבור המלא מהתוכן שהדבקתם — כתובת URL,
שיטה, כותרות וסכמת פרמטרים הנגזרת מפרמטרי השאילתה ומגוף הבקשה
שנמצאו. כותרות שהדבקתם, כולל כותרות אימות, מועברות להגדרת נקודת
הקצה.
ההגדרה שהוסקה נפתחת כאשר השדות שנאמדו מודגשים לבדיקה. התאימו שמות,
תיאורים וסוגי פרמטרים כדי שהסוכן יבין מתי וכיצד לקרוא לפונקציה —
התיאור הוא מה שהמודל קורא.
השמירה מפעילה תחילה בקשת בדיקה חיה מול נקודת הקצה שלכם. אם הבקשה
נכשלת, החיבור לא נשמר — תקנו את כתובת ה-URL, כותרות האימות או הגוף
ונסו שוב. במקרה של הצלחה, החיבור נשמר עם תגית **מאומת**.
אם האשף לא מצליח למצוא כתובת URL של בקשה בתוכן שהדבקתם, הוא יציין זאת —
כללו נקודת קצה מלאה מסוג `http(s)` ונסו שוב.
## הגדרה ידנית
לחצו על **הגדרה ידנית →** באשף (או על **רוצים שה-AI יסיק זאת?
נסו את האשף →** כדי לחזור). הבונה הידני כולל שני עורכים:
- **חזותי** — שדות טופס עבור שם התצוגה, שם הפונקציה, **כתובת URL**
של הבקשה, **שיטה** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`),
**כותרות** מותאמות אישית וסכמת הפרמטרים (**הוספת מאפיין** עבור כל
ארגומנט שהסוכן יכול לספק).
- **JSON** — אותה הגדרה כ-JSON גולמי, להדבקה או לכוונון עדין של מפרט
כלי ישירות.
חלונית **בקשת בדיקה** (אופציונלית) מאפשרת לכם להפעיל את הבקשה שהוגדרה
לפני השמירה ומציגה את הסטטוס, זמן ההשהיה ותצוגה מקדימה של התגובה.
**אמתו ושמרו** תמיד מפעיל בדיקה זו ושומר רק במקרה של הצלחה.
ערכי כותרות הם לכתיבה בלבד. לאחר השמירה הם מוצפנים ולעולם אינם מוצגים
שוב, בלוח הבקרה או ב-API. כשאתם עורכים חיבור, כותרת שמורה מציגה את שמה
עם נקודות במקום הערך והערה **נשמר**:
השאירו אותה כפי שהיא כדי לשמור את הערך השמור, או הקלידו ערך חדש כדי להחליף אותו. בקשות בדיקה ושיחות חיות משתמשות בערך השמור. **שכפול** מעתיק ערכים שמורים
לחיבור החדש.
תנו לפרמטרים תיאורים בשפה פשוטה ("כתובת דוא"ל של לקוח,
למשל jane@example.com"). הסוכן בוחר ארגומנטים מתוך תיאורים אלה בזמן
אמת, במהלך השיחה.
## ניהול החיבורים שלכם
כל שורת חיבור מציגה את סטטוס האימות שלה — **מאומת**,
**לא נבדק** או **שגיאה** — את שם הפונקציה ואת הסוכנים שמשתמשים בה.
מתפריט הפעולות של השורה תוכלו:
- **לערוך** — לפתוח מחדש את ההגדרה.
- **לשכפל** — ליצור עותק כנקודת התחלה (העותק מתחיל כלא נבדק).
- **היסטוריית גרסאות** — להציג גרסאות קודמות ולשחזר אחת מהן לעורך.
- **להעביר** — להעתיק או להעביר את החיבור לארגון אחר שאתם חברים בו.
העברה מסירה אותו מכאן; ייתכן שסוכנים שהשתמשו בו יצטרכו הגדרה מחדש.
- **למחוק** — פעולה קבועה; סוכנים שמשתמשים בחיבור יצטרכו הגדרה מחדש.
## חיבור לסוכן
הוסיפו את החיבור לסוכן בקטע חיבורי ה-API של הבונה
([בניית סוכן](/he/guides/build-an-agent)). הרשימה מציגה אילו סוכנים
משתמשים בכל חיבור, כך שתוכלו לראות במבט אחד על מה משפיע שינוי.
## השלבים הבאים
צרו ונהלו את אותם חיבורים באופן תכנותי.
חיבורים מוכנים מראש ל-Google, Slack, HubSpot, Salesforce ו-Cal.com.
חשפו שרת כלים שלם לסוכנים שלכם.
כל שדה במשאב השילוב.