אינטגרציות וחיבורים

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

מסנג’רים

טלגרם ו-MAX — לסוכן יכול להיות בוט ייעודי משלו (עונה רק בשבילו, באופן מיידי), או בוט משותף דרך חיבור שמנתב הודעות לסוכן הנכון.

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

השירותים שלכם

אם אין כרטיס מוכן לשירות שאתם צריכים, הקטגוריה “כללי” מכסה כל דבר אחר, בשלוש דרכים:

• השירות שלכם (REST API) — כתובת בסיס, שיטת התחברות, סוד, ואופציונלית כתובת תיאור OpenAPI. הסוכן קורא לשירות בעצמו; הסוד לעולם לא עוזב את השרת שלכם.
• אירועים נכנסים (webhook) — החיבור מקבל כתובת משלו, כמו /api/hooks/<token>, אופציונלית חתומה ב-HMAC-SHA256. כל אירוע נכנס הופך להודעה שהסוכן קורא ויכול לפעול לפיה, באותו אופן שבו הוא פועל לפי הודעה במסנג’ר. עד 120 אירועים בדקה לחיבור; שום דבר בגוף אירוע לעולם לא מורץ כפקודה.
• שרת MCP — Neo מוסיף את השרת לסט הכלים של הסוכן, בלי לחשוף סודות בגלוי. הסוכן רואה כלים חדשים לאחר הפעלה מחדש.

כשרשומת קטלוג משתנה שם או מתמזגת

לפעמים כרטיס קטלוג אחד מחליף כמה כרטיסים ישנים (Bitrix24, לדוגמה, מציע בחירה בין שיטת חיבור — webhook או שם-משתמש-וסיסמה). חיבורים שנעשו תחת הכרטיס הישן עוברים לכרטיס החדש באופן אוטומטי, עם הערכים שלהם; השדות של השיטה שלא נבחרה פשוט מוסתרים, ולא נדרשים.