כלים

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

יצירת כלי

כדי ליצור כלי:

1. לוחצים על סמל מפתח הברגים בצד שמאל של הכלי ליצירת סוכנים.
2. בוחרים סוג כלי (תיאורים של סוגי כלים מופיעים במסמך הזה).
3. מספקים את המידע הנדרש לכלי.
4. שם הכלי צריך להיות בפורמט snake case.
5. תיאורי הכלים מסופקים למודלים של סוכנים.

שימוש בכלי בסוכן

אחרי שיוצרים כלי, צריך להנחות סוכן מסוים להשתמש בו.

1. מציבים את הסמן מעל סוכן.
2. לוחצים על הוספת כלי.
3. בוחרים כלי.
4. מתארים בהנחיות לסוכן איך צריך להשתמש בכלי.

בדיקת כלי

לפני שמשתמשים בכלי בסוכן, אפשר לבדוק את הכלי במסוף:

1. פותחים את חלונית הכלים.
2. לוחצים על הלחצן כלי הבדיקה בחלק העליון של החלונית.

3. מספקים קלט לכלי בהתאם לסכימת הכלי. לדוגמה, אם הסכימה היא JSON עם מאפיינים place ו-city, אפשר להשתמש בקלט הבא:

   {
     "place": "automobile repair center",
     "city": "austin texas"
   }
   

4. לוחצים על שליחה. הכלי מופעל עם הקלט, והפלט מאוכלס.

אחרי שבודקים את הכלי ישירות, אפשר לבדוק אותו גם באמצעות תצוגה מקדימה של הנציג.

כלים זמינים

הכלים הבאים זמינים:

כלי	תיאור
פרוטוקול A2A	חיבור הסוכן לסוכנים חיצוניים באמצעות תקן ההודעות A2A. (גרסת טרום-השקה)
סוכן ככלי	אפשר להשתמש שוב ביכולות של סוכנים בלי להעביר את השיחה לסוכן אחר.
כלים לפונקציות של לקוחות	כלי קוד שמופעלים בצד הלקוח, ולא על ידי הנציג.
כלים של Confluence	מקשרים את הסוכן למכונה של Confluence.
כלים למאגר נתונים	לספק תשובות של נציגים שנוצרו על ידי AI על סמך תוכן האתר ונתונים שהועלו.
כלים לחיפוש קבצים	העלאת קובץ או מתן מאגר ידע של RAG לסוכן.
כלים של מפות Google	חיבור הנציג למפות Google. (גרסת טרום-השקה)
כלים של חיפוש Google	אפשר לקשר את הסוכן שלכם לעיגון באמצעות חיפוש Google.
כלים של Integration Connectors	ליצור כלים שמנצלים את החיבורים שהגדרתם.
כלים של Jira	מחברים את הסוכן למופע של Jira.
כלי MCP	מתחברים לשרת MCP.
כלים של OpenAPI	מתחברים ל-API חיצוני באמצעות סכימת OpenAPI.
כלי קוד Python	מספקים קוד Python ככלי לסוכן.
כלים של Salesforce	מקשרים את הסוכן למכונה ב-Salesforce.
כלים של Service Now	מחברים את הסוכן למכונה של Service Now.
כלים של SharePoint	מקשרים את הסוכן למופע של SharePoint.
כלי מערכת	כלים מובנים שהסוכן יכול להשתמש בהם כדי לבצע משימות נפוצות.
כלים לווידג'טים	כלים גמישים לווידג'טים ליצירת אינטראקציות עשירות עם המשתמשים.

סוג ביצוע

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

סוג ביצוע סינכרוני

צריך להשתמש בסוג הזה כשרוצים שתהליך יצירת תשובות של הסוכן יהיה חסום עד שהתשובה של הכלי תהיה זמינה. הסוכן לא ייצור תשובה עד שתהיה תשובה מהכלי. כדי לשמור על זמן אחזור נמוך בתגובות של הסוכן, מומלץ שזמן האחזור של הכלים האלה יהיה נמוך (פחות מ-5 שניות).

סוג ביצוע אסינכרוני

צריך להשתמש בסוג הזה להרצה לא חוסמת של כלים. כשמופעלת קריאה לכלי, הסוכן ימשיך עם תגובה מסוג 'בהמתנה'. הנציג יכול להמשיך לדבר עם המשתמש בזמן שליפת התשובה מהכלי. אחרי שהתשובה זמינה, היא מתווספת להקשר בפעם הבאה שסוכן יוצר תשובה. מומלץ להשתמש בהן בכלים עם זמן אחזור של 5 עד 60 שניות.

רצף שיחה לסוג ביצוע אסינכרוני:

1. הסוכן מפעיל קריאה לפונקציה: הסוכן מפעיל קריאה לפונקציה וממתין לתשובה. לדוגמה, הפעלת הכלי לבדיקת סטטוס ההזמנה.
2. הכלי בהמתנה לתשובה: הכלי מחזיר באופן מיידי function_response עם סטטוס בהמתנה, כמו "status": "pending".
3. הסוכן מטפל בכלי בהמתנה: צריך להנחות את הסוכן לטפל בתשובות בהמתנה לפי הצורך. הוראה לדוגמה: "תשאל את המשתמש אם יש לו שאלות נוספות בזמן שאתה מאחזר את סטטוס ההזמנה". דוגמה לתשובה של נציג: "יש עוד משהו שאוכל לעשות בשבילך בזמן שאני בודק את סטטוס ההזמנה שלך?".

4. הסוכן מטפל בתשובה הסופית: התשובה בפועל של הכלי זמינה לסוכן. היא תיכלל כתג הקשר. לדוגמה:

   <context>function [<tool_name>] completed with response <response JSON></context>
   

שיטות מומלצות

כדאי לפעול לפי השיטות המומלצות הבאות לשימוש בכלים:

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