קביעת תצורה וניהול של חיבורים

הערה

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

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

ב Microsoft Copilot Studio, אתה משתמש בחיבורים כדי לגשת באופן מאובטח לשירותים מאומתים לקבלת כלים וידע. באפשרותך ליצור חיבורים למקורות נתונים שונים, כגון Microsoft Dataverse, Microsoft SharePoint API חיצוניים.

הצגה וניהול של חיבורי סוכן

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

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

הצגת חיבורים בדף 'הגדרות חיבור'

1. גש לעמוד הסוכן שלך ב-Copilot Studio על ידי בחירת סוכנים ואז בחירת הסוכן שאתה רוצה לראות.

   הדף מבט כולל על סוכן נפתח.

2. בחר הגדרות כדי לפתוח את הדף הגדרות סוכן.

3. בחר הגדרות חיבור.

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

• שם חיבור
• כלים ומקורות ידע המשתמשים בחיבור
• מצב חיבור

הגדרות מצב חיבור

מצב החיבור מציין את המצב הנוכחי של החיבור. קיימים כמה מצבים אפשריים:

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

סינון חיבורים

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

בחירה או יצירה של חיבור בודד

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

2. בחר ... כדי לפתוח את תצורת החיבור.

3. בחר חיבור קיים מהרשימה או בחר ליצור חיבור חדש כדי ליצור חיבור חדש.

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

4. לאחר שתסיים, בחר שלח כדי לשמור את השינויים.

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

הצגת פרטים וקביעת תצורה של פרמטרים של חיבור

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

מידע מופיע בשתי כרטיסיות:

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

שיתוף פרמטרים של חיבור עבור אימות מסוג on-Behalf-Of (OBO)

עבור חיבורים מסוימים התומכים בהתחברות יחידה (SSO), באפשרותך להגדיר את החיבור לשימוש באימות On-Behalf-Of (OBO). בזרימת OBO, המשתמש מפקיד את הסוכן להשתמש בפרמטרי החיבור של המשתמש עם השירות בשמו. שיטת אימות זו שימושית כאשר הסוכן צריך לגשת למשאבים הדורשים הרשאות ספציפיות למשתמש או כאשר יש לבצע פעולות בהקשר של זהות משתמש.

הפעל שיתוף פרמטרים עבור On-Behalf-Of (OBO)

תחת פרמטרים של חיבור עבור ערך החיבור ברשימה, באפשרותך לאפשר למשתמש לאשר שיתוף פרמטרים ספציפיים של חיבור.

1. תחת פרמטרים של חיבור, הפעל את אפשר הרשאה לשיתוף פרמטרים.

   

2. בחר תיבות סימון עבור הפרמטרים שברצונך לאפשר למשתמש לשתף.

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

חוויית המשתמש עבור אימות בשם משתמש אחר (OBO)

כאשר הסוכן משתמש באימות On-Behalf-Of (OBO), המשתמש מתבקש להעניק הרשאה לסוכן להשתמש בפרמטרי החיבור שלו. המשתמש יכול לבחור לאפשר או לדחות הרשאה זו. אם המשתמש מאפשר זאת, הסוכן יכול לגשת למשאבים ולבצע פעולות בשם המשתמש. הסוכן מתחבר לשירות באופן שקוף באמצעות הפרמטרים של החיבור המשותף.

בקשות חיבור חוזרות בעת שימוש ב- OAuth 2.0 עם כלי Graph API Microsoft

הערה

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

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

כדי להימנע מהנחיות חזרתיות, נסה אחת מהאפשרויות הבאות לאימות הזו:

• לאפשר כניסה יחידה (SSO) של Teams באמצעות תהליך OBO: משתמשים מתחברים פעם אחת ב-Teams. לא נדרשת הסכמה נוספת בצ'אט.

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

• השתמש ב- OAuth SSO כללי עבור סוכנים המתארחים באינטרנט: היישום שלך מטפל בכניסה ומעביר את האסימון לסוכן.

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

הערה

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

תוכן קשור

• קביעת תצורה של אימות OBO עבור מחברים מותאמים אישית