מחברים מותאמים אישית

מחבר מותאם אישית מאפשר למנהל הארגון לרשום API ב-HTTPS או, כאשר זמין, שרת Streamable HTTP MCP שאינו נמצא בקטלוג המובנה. הוא מגדיר את גבול הרשת ושיטת האימות. הוא אינו יוצר אוטומטית תיעוד API מלא עבור הסוכן.

מי מגדיר מה

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

ההגדרה משותפת בארגון. אישורי החברים נשארים מוגבלים לחבר ולארגון.

מחבר API ב-HTTP

1. פתח מחברים → מותאם אישית ובחר מחבר חדש.
2. בחר HTTP API והזן שם תצוגה.
3. הוסף אחד או יותר קידומות HTTPS, כל אחת בשורה נפרדת. הבקשה חייבת להתאים לקידומת שהוגדרה כדי שהמחבר יוכל לאשר אותה.
4. הוסף אימות אם ה-API דורש זאת:
   • אימות API: הזן את שם הכותרת ותבנית כותרת המכילה {{secret}}, לדוגמה Authorization ו-Bearer {{secret}}.
   • OAuth 2.0: הזן את כתובת ה-URL לאימות, כתובת ה-URL לאסימון, מזהה לקוח, סוד לקוח, תחומים ושיטת אימות נקודת קצה לאסימון. רשום אצל הספק את כתובת ההפניה המדויקת שמוצגת בטופס.
5. צור את המחבר. כל חבר שזקוק לו בוחר לאחר מכן חיבור ומספק את הסוד שלו או משלים את תהליך ה-OAuth.
6. אשר את הסוכן וההרשאות הנדרשות.

שינוי הגדרת OAuth קיימת או אישורי הלקוח שלה מנתק את כל חיבורי ה-OAuth הנוכחיים. החברים צריכים להתחבר מחדש לאחר השינוי.

מחבר MCP

אם MCP מופיע כסוג מחבר בסביבת העבודה שלך, הזן נקודת קצה HTTPS Streamable HTTP MCP והגדר אימות API או OAuth באותו טופס. אם MCP אינו מוצע בבחירה, הוא אינו מופעל עבור סביבת עבודה זו.

ללמד את הסוכן את תהליך ה-API

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

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

גבולות אבטחה

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

פתרון בעיות

מה הלאה

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