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

באיזו חוויה אתם משתמשים?

מסמכים אלה מכסים את שתי החוויות. אם Settings → Personal → My Okou זמין, פעלו לפי השלבים של My Okou. אם אתם משתמשים בדף Agents עם New agent, פעלו לפי השלבים של Legacy Agents. הזמינות עשויה להשתנות בין חברים; מסמכים אלה אינם משנים את החוויה שלכם.

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

הבדלי ההגדרה: My Okou משתמש ב-Instructions אישיות ב-Settings → Personal → My Okou וב-תהליכי עבודה של סביבת עבודה. כל שלב בהמשך שמבקש מכם לבחור, ליצור או לאשר Agent בשם מסוים חל רק על Legacy Agents. ב-My Okou, השתמשו בצ'אט שלכם ופעלו לפי בקשת החשבון וההרשאה בשם שמופיעה. תהליכי עבודה משותפים אינם משתפים אישורים; אוטומציות משתמשים בהקשר ובגישה של הבעלים שלהם.

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

מי מגדיר מה

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

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

מחבר HTTP API

1. פתחו את Connectors → Custom ובחרו New connector.
2. בחרו HTTP API והזינו שם תצוגה.
3. הוסיפו Prefixes אחד או יותר ב-HTTPS, אחד בכל שורה. בקשה חייבת להתאים ל-Prefix מוגדר לפני שהמחבר יוכל לאשר אותה.
4. הוסיפו אימות אם ה-API דורש זאת:
   • API authentication: הזינו את שם הכותרת ותבנית כותרת המכילה {{secret}}, לדוגמה Authorization ו-Bearer {{secret}}.
   • OAuth 2.0: הזינו את כתובת ה-URL של ההרשאה, כתובת ה-URL של הטוקן, מזהה הלקוח, סוד הלקוח, ה-scopes, ואת שיטת אימות נקודת הקצה של הטוקן. רשמו אצל הספק את כתובת ה-redirect המדויקת שמוצגת בטופס.
5. צרו את המחבר. לאחר מכן כל חבר שזקוק לו בוחר Connect ומספק את הסוד שלו או משלים OAuth.
6. סקרו ואשרו את ההרשאות הנקובות הנדרשות. ב-Legacy Agents, בחרו גם את ה-Agent המיועד.

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

מחבר MCP

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

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

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

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

גבולות אבטחה

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

פתרון בעיות

מה הלאה

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