צמתי AI
צמתי AI מכניסים אינטליגנציה ל-workflows שלכם. צומת AI Agent הוא אבן הבניין המרכזית — הוא מנהל שיחות באופן אוטונומי עם תמיכה בכלים, מאגרי ידע, זיכרון מרובה פניות והעברות בין סוכנים.
ai.agent
סוכן AI שמנהל את השיחה עם איש הקשר.
צומת AI Agent הוא סוכן שיחה מלא. הוא יכול לקרוא לכלים, לחפש במאגרי ידע, להעביר לסוכנים מומחים ולשמור זיכרון שיחה לאורך זמן — הכל בתוך צומת אחד ב-workflow.
קונפיגורציה
| Option | Type | Required | Description |
|---|
agentId | string | No | קישור לסוכן מוגדר מראש מדף הסוכנים. דורס הגדרות inline עם ההוראות, המודל, הכלים והידע של הסוכן |
systemPrompt | string | Yes (ללא agentId) | הוראות שמגדירות את האישיות, הידע וההתנהגות של הסוכן |
model | string | No | מודל AI לשימוש. בחרו מבין המודלים הזמינים בהגדרות AI של סביבת העבודה |
temperature | number | No | רמת האקראיות בתגובה, 0.0 עד 2.0. ברירת המחדל: 0.7. ערך נמוך = דטרמיניסטי יותר |
maxTokens | number | No | מספר הטוקנים המרבי לתגובה |
toolIds | array | No | מזהי כלים שהסוכן יכול לקרוא להם בזמן ריצה (כלי HTTP, אינטגרציות) |
enableWebSearch | boolean | No | הפעלת חיפוש רשת מובנה של OpenAI למידע עדכני |
knowledgeLinks | array | No | קישורים למסמכים או כתובות URL שהסוכן יכול להתייחס אל��הם |
tone | string | No | טון התגובה, למשל “professional”, “friendly”, “concise” |
answerLength | string | No | אורך תגובה מועדף, למשל “short”, “medium”, “detailed” |
exitConditions | array | No | תנאי יציאה שמסיימים את תור הסוכן, כל אחד עם label ו-instruction אופציונלי |
handoffAgentIds | array | No | מזהי סוכנים אחרים שהסוכן יכול להעביר אליהם שיחות בנושאים מומחים |
סוכנים מקושרים
במקום להגדיר הכל inline, אפשר לקשר לסוכן מוגדר מראש מדף הסוכנים. כאשר agentId מוגדר, הצומת יורש מהסוכן:
- הוראות (system prompt)
- בחירת מודל
- כלים (כלי HTTP, אינטגרציות)
- ידע (מסמכים, קישורים)
הגדרות inline דורסות הגדרות סוכן מקושר כשהן מופיעות בשניהם.
כלים
צמתי AI Agent יכולים להשתמש בכלים במהלך שיחה כדי לאסוף מידע ולבצע פעולות:
| Tool Type | Description |
|---|
| Web Search | חיפוש רשת מובנה של OpenAI למידע עדכני (מופעל דרך enableWebSearch) |
| HTTP Tools | קריאה ל-API חיצוניים בזמן ריצה |
| Integration Tools | שימוש באינטגרציות צד שלישי מחוברות (מוגדרות בהגדרות > כלים) |
ידע ו-RAG
לסוכנים יש גישה לידע דרך שני מנגנונים:
- Knowledge Links: קישורים ומסמכים שמצורפים לסוכן. התוכן נסרק ומוזרק ל-system prompt כהקשר.
- חיפוש מסמכים (RAG): כשמסמכים מועלים לסוכן, הפלטפורמה מבצעת חיפוש וקטורי מול ההודעה הנכנסת כדי למצוא קטעים רלוונטיים. אלה מוזרקים ל-system prompt באופן אוטומטי.
העברות בין סוכנים
סוכנים יכולים להעביר שיחות לסוכנים מומחים. כאשר handoffAgentIds מוגדר:
- הסוכן הראשי מקבל את ההודעה ומתחיל לעבד
- אם השיחה דורשת התמחות אחרת, הסוכן מעביר לסוכן ההעברה המתאים
- סוכן ההעברה משתלט עם ההוראות, הכלים והידע שלו
- שרשרת ההעברות נרשמת בפלט שלב הריצה
כל סוכן העברה הוא סוכן מוגדר במלואו עם system prompt, כלים ומאגר ידע משלו.
תנאי יציאה
הגדירו תנאים שמסיימים את תור הסוכן ומעבירים לצומת הבא ב-workflow:
| Field | Type | Description |
|---|
label | string | שם תנאי היציאה, למשל “needs_human”, “purchase_complete” |
instruction | string | הנחיה אופציונלית ל-AI מתי להפעיל את התנאי |
Outputs
| Output | Type | Description |
|---|
response.text | string | טקסט התגובה שנוצר |
response.exitCondition | string | איזה תנאי יציאה הופעל (אם בכ��ל) |
response.tokensUsed | object | פירוט צריכת טוקנים (prompt, completion, total) |
response.toolCalls | array | רישום כלים שנקראו במהלך הריצה |
response.lastAgent | string | שם הסוכן שייצר את התגובה הסופית (רלוונטי להעברות) |
response.handoffChain | array | רצף העברות הסוכנים שהתרחשו |
Connections
- Inputs: ידית כניסה אחת שמקבלת את הקשר השיחה
- Outputs: ידית יציאה ברירת מחדל, בתוספת ידית אחת לכל תנאי יציאה
שיחות מרובות פניות
צמתי AI Agent שומרים אוטומטית על זיכרון מתמשך לאורך שיחה. לכל contact ב-WhatsApp מוקצה thread ייעודי, כך שהסוכן זוכר הודעות קודמות בלי שתצטרכו לנהל הקשר ידנית.
דוגמאות שימוש
סוכן תמיכת לקוחות: הגדירו עם מאגר ידע של המוצר, חברו כלי HTTP לחיפוש הזמנות, והגדירו תנאי יציאה ל-”needs_human” (מעביר ל-wa.handoff) ו-”issue_resolved” (מעביר לסקר שביעות רצון).
סוכן סינון מכירות: קשרו סוכן ממוקד מכירות עם חיפוש רשת מופעל, הגדירו טון “professional”, וקבעו סוכני העברה ל-”technical_questions” (מעביר לסוכן טכני) ו-”pricing_inquiries” (מעביר לסוכן תמחור).
עלויות טוקנים: הרצת סוכן AI צורכת טוקנים שמחויבים דרך OpenAI. מומלץ תמיד להגדיר maxTokens כדי לשלוט בעלויות. הפלטפורמה אוכפת תקרת בטיחות של 150,000 טוקנים לכל run כדי למנוע לולאות סוכן לא מבוקרות. הסוכן מבצע מקסימום 6 סיבובים לכל הרצה.
