כלים של Integration Connector

סוכנים יכולים להשתמש בכלי מחבר כדי לבצע פעולות באמצעות החיבורים שהוגדרו ב-Integration Connectors. כל כלי מחבר מוגדר עם חיבור יחיד ועם פעולה אחת או יותר. אם צריך, אפשר ליצור כמה כלים לחיבור אחד כדי לקבץ פעולות שונות שהסוכן יכול להשתמש בהן.

כלי החיבור תומך בסוגי החיבורים הבאים:

יצירת חיבור

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

  • עוברים מכלי בניית הסוכנים אל כלים > יצירה.
  • בוחרים את סוג הכלי מחבר שילוב
  • בוחרים את סוג המחבר הרצוי
  • משתמשים בלחצן Create Connection (יצירת קישור).

פעולה זו תנווט אתכם ליצירת Integration Connectors עם מספר שדות שמולאו מראש.

לחלופין, אפשר לעבור אל Integration Connectors (מחברים לשילובים) ולפעול לפי ההוראות ליצירת חיבור.

פעולות של מחברים

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

  1. פעולות CRUD של ישויות

    לכל אחד מהחיבורים יש 'ישויות' שמתאימות לאובייקטים של מקור הנתונים (ב-BigQuery אלה טבלאות, ב-Salesforce אלה אובייקטים כמו Order או Case).

    אפשר לבצע פעולות CRUD בכל ישות:

    • יצירה: יצירת ישות עם ערכי שדות שצוינו
    • רשימה: חיפוש מבוסס-מסננים של מופעי ישויות
    • עדכון: שיטה לשינוי ערכים של שדות של ישויות שמבוססת על סינון
    • מחיקה: מחיקת ישות
    • ‫Get מאחזר ישות יחידה באמצעות entityId

    מידע נוסף על פעולות CRUD של ישויות זמין במסמכי התיעוד של Connectors.

  2. פעולות ספציפיות למחבר

    מחברים רבים תומכים בפעולה ExecuteCustomQuery, שמאפשרת להריץ שאילתת SQL על מקור הנתונים, כאשר כל אחד מהישויות של מקור הנתונים יכול לשמש כטבלה. כאן אפשר לעיין ברשימת המחברים הנתמכים.

    פעולות נוספות משתנות בהתאם לסוג המחבר – לדוגמה, אפשר לעיין בפעולות של מחבר BigQuery או בפעולות של מחבר Salesforce.

הגדרת שדות קלט / פלט לפעולות CRUD

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

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

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

אימות

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

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