הוספת אימות משתמש לנושאים

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

הערה

סוכנים‎ ‎שנוצרו‎ ‎ב‎-Copilot Studio ‎וב‎-Microsoft Teams ‎מוגדרים‎ ‎אוטומטית‎ ‎לאימות‎ Microsoft Entra ID.

ניתן גם להגדיר כניסה יחידה (SSO), כך שהמשתמשים לא יצטרכו להתחבר ידנית. למידע‎ ‎נוסף‎, ‎ראה‎ ‎הגדרת‎ ‎כניסה‎ ‎יחידה‎ ‎עם‎ Microsoft Entra ID‎.

‏‫דרישות מוקדמות‬

• סקירת משתנים
• הגדר‎ ‎אימות‎ ‎משתמש‎ ‎ב‎-Copilot Studio

יישום אינטרנט

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

הגדר‎ ‎אימות‎ ‎ידני‎ ‎עם‎ Microsoft Entra ID

עליך‎ ‎להגדיר‎ ‎אימות‎ ‎משתמש‎ ‎עם‎ Microsoft Entra ID ‎לפני‎ ‎שתוכל‎ ‎להשתמש‎ ‎באימות‎ ‎בנושאים‎ ‎שלך‎.

עקוב‎ ‎אחר‎ ‎ההוראות‎ ‎בהגדרת‎ ‎אימות‎ ‎משתמש‎ ‎עם‎ Microsoft Entra ID‎.

הוסף‎ ‎אימות‎ ‎משתמש‎ ‎עם‎ ‎נושא‎ ‎מערכת‎ ‎הכניסה

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

חשוב

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

1. פתח‎ ‎את‎ ‎הסוכן‎ ‎שלך‎ ‎ב‎-Copilot Studio, ‎בחר‎ ‎הגדרות‎ ‎בחלק‎ ‎העליון‎ ‎של‎ ‎הדף‎, ‎ואז‎ ‎בחר‎ ‎אבטחה‎.
2. בחר באפשרות אימות.
3. בחר‎ ‎אמת‎ ‎ידנית‎, ‎ואז‎ ‎בחר‎ ‎דרוש‎ ‎מהמשתמשים‎ ‎להתחבר‎.
4. הגדר‎ ‎את‎ ‎כל‎ ‎שדות‎ ‎האימות‎ ‎הידני‎, ‎כפי‎ ‎שנדרש‎.
5. בחר Save.

הוסף‎ ‎אימות‎ ‎משתמש‎ ‎עם‎ ‎נושא‎ ‎מותאם‎ ‎אישית

נושא‎ ‎התחברות‎ ‎מאמת‎ ‎את‎ ‎המשתמש‎ ‎בתחילת‎ ‎השיחה‎. כדי‎ ‎לאפשר‎ ‎למשתמש‎ ‎להתחבר‎ ‎מאוחר‎ ‎יותר‎, ‎אתה‎ ‎יכול‎ ‎להוסיף‎ ‎צומת‎ ‏Authenticate‎ ‎לכל‎ ‎נושא‎ ‎מותאם‎ ‎אישית‎.

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

1. בחרו‎ ‎הגדרות‎ ‎בחלק‎ ‎העליון‎ ‎של‎ ‎הדף‎, ‎ולאחר‎ ‎מכן‎ ‎בחרו‎ ‎אבטחה‎.

2. בחר‎ ‎את‎ ‎אימות‎ ‎לוח‎.

   הערה

   עליך‎ ‎לבחור‎ ‎אמת‎ ‎ידנית‎ ‎כדי‎ ‎להוסיף‎ ‎אימות‎ ‎משתמש‎ ‎לנושא‎ ‎מותאם‎ ‎אישית‎.

3. בחר‎ ‎אמת‎ ‎ידנית‎ ‎ונקה‎ ‎את‎ ‎תיבת‎ ‎הסימון‎ ‎דרוש‎ ‎מהמשתמשים‎ ‎להתחבר‎.

4. הגדר‎ ‎את‎ ‎כל‎ ‎שדות‎ ‎האימות‎ ‎הידני‎, ‎כפי‎ ‎שנדרש‎.

5. בחר Save.

6. בחר‎ ‎נושאים‎ ‎בחלק‎ ‎העליון‎ ‎של‎ ‎הדף‎.

7. בחר‎ ‎הוסף‎ ‎צומת‎ ( ‎‎ ) ‎>מתקדם>אמת‎.

8. בדוק‎ ‎את‎ ‎הנושא‎ ‎שלך‎ ‎עם‎ ‎משתמש‎ ‎שהוגדר‎ ‎עם‎ ‎ספק‎ ‎הזהות‎ ‎שלך‎.

עצה

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

משתני אימות

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

לפרטים‎ ‎נוספים‎ ‎על‎ ‎משתנים‎, ‎ראה‎ ‎סקירה‎ ‎על‎ ‎משתנים‎.

משתנה אימות	אין אימות	אימות עם Microsoft	אימות ידני
User.DisplayName	לא זמין	זמין/ה	זמין/ה
User.FirstName	לא זמין	זמין/ה	זמין/ה
User.LastName	לא זמין	זמין/ה	זמין/ה
User.PrincipalName	לא זמין	זמין/ה	זמין/ה
User.Email	לא זמין	זמין/ה	זמין/ה
User.Id	לא זמין	זמין/ה	זמין/ה
User.IsLoggedIn	לא זמין	זמין/ה	זמין/ה
User.AccessToken	לא זמין	לא זמין	זמין/ה
SignInReason	לא זמין	זמין/ה	זמין/ה

User.DisplayName

אזהרה

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

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

Copilot Studio מגדיר אוטומטית את הערך של User.DisplayName מהצהרת name שסופקה על ידי ספק הזהות, כל עוד הטווח profile הוגדר בעת הגדרת האימות הידנית. למידע נוסף על טווח, ראה הגדרת אימות משתמש עם Microsoft Entra ID.

User.Id

אזהרה

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

המשתנה‎ ‎User.Id‎ ‎מכיל‎ ‎את‎ ‎מזהה‎ ‎המשתמש‎ ‎המאוחסן‎ ‎בספק‎ ‎הזהות‎. השתמש במשתנה בזרימות Power Automate כדי לקרוא ל-API שלוקח את UserID בתור ערך.

Copilot Studio מגדיר אוטומטית את הערך של User.DisplayName מההצהרה של sub שסופקה על ידי ספק הזהות.

User.IsLoggedIn

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

User.AccessToken

אזהרה

ודא‎ ‎שאתה‎ ‎מעביר‎ ‎את‎ ‎המשתנה‎ ‎User.AccessToken‎ ‎רק‎ ‎למקורות‎ ‎מהימנים‎. הוא מכיל פרטי אימות של המשתמש, ואם ייפגעו או ייחשפו, הדבר עלול להזיק למשתמש.

המשתנה User.AccessToken מכיל את אסימון הגישה של המשתמש, שמתקבל לאחר שהמשתמש נכנס למערכת. ניתן להעביר משתנה זה אל זרימות ב-Power Automate כדי שיוכלו להתחבר לממשקי API בקצה העורפי ולקבל מידע על המשתמש, או לנקוט פעולות בשם המשתמש.

אל תשתמש ב-User.AccessToken בצמתים של הודעה או בזרימות שאינך סומך עליהם.

SignInReason

SignInReason‎ ‎הוא‎ ‎משתנה‎ ‎מסוג‎ ‎בחירה‎ ‎שמציין‎ ‎מתי‎ ‎המשתמש‎ ‎חייב‎ ‎להתחבר‎. יש‎ ‎לו‎ ‎שני‎ ‎ערכים‎ ‎אפשריים‎:

• SignInRequired‎ ‎מציין‎ ‎שהמשתמש‎ ‎חייב‎ ‎להתחבר‎ ‎בתחילת‎ ‎השיחה‎ ‎באמצעות‎ ‎נושא‎ ‎המערכת‎ ‎כניסה‎. דרוש‎ ‎מהמשתמשים‎ ‎להתחבר‎ ‎חייב‎ ‎להיות‎ ‎מופעל‎.

• Initializer‎ ‎מציין‎ ‎שכאשר‎ ‎משתמש‎ ‎אינו‎ ‎מחובר‎, ‎והוא‎ ‎מגיע‎ ‎לנקודה‎ ‎בשיחה‎ ‎שמשתמשת‎ ‎במשתני‎ ‎אימות‎, ‎הוא‎ ‎מתבקש‎ ‎להתחבר‎.

קלאסי

משתני אימות

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

הטבלה‎ ‎הבאה‎ ‎משווה‎ ‎בין‎ ‎זמינות‎ ‎משתני‎ ‎האימות‎ ‎לפי‎ ‎אפשרות‎ ‎קונפיגורציית‎ ‎האימות‎:

משתנה אימות	אין אימות	אימות עם Microsoft	ידני
User.DisplayName	❌	✔️	✔️
User.Id	❌	✔️	✔️
User.IsLoggedIn	❌	❌	✔️
User.AccessToken	❌	❌	✔️

משתנה UserDisplayName

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

ערך שדה זה מתקבל מההצהרה name של Microsoft Entra ID. עבור ספקי OAuth, ערך זה מאוחסן בהצהרה name. Copilot Studio מחלץ אוטומטית את השדה הזה למשתנה, אז ודא שיש לך profile כחלק מהגדרת היקף האימות.

משתנה UserID

המשתנה‎ ‎User.Id‎ ‎מכיל‎ ‎את‎ ‎מזהה‎ ‎המשתמש‎ ‎המאוחסן‎ ‎בספק‎ ‎הזהות‎. זרימות Power Automate יכולות להשתמש בערך הזה כדי לקרוא ל-API שלוקח את UserID בתור ערך. ערך שדה זה מתקבל מההצהרה sub של Microsoft Entra ID. עבור ספקי OAuth, ערך זה מאוחסן בהצהרה sub. Copilot Studio מחלץ אוטומטית את השדה הזה למשתנה.

אזהרה

המשתנים‎ ‎User.DisplayName‎ ‎ו‎-‎User.Id‎ ‎עשויים‎ ‎שלא‎ ‎להיות‎ ‎מלאים‎, ‎ובמקום‎ ‎זאת‎ ‎המשתנים‎ ‎הללו‎ ‎עשויים‎ ‎להיות‎ ‎מחרוזות‎ ‎ריקות‎ ‎בהתאם‎ ‎להגדרות‎ ‎המשתמש‎ ‎בספק‎ ‎הזהות‎. בדוק‎ ‎עם‎ ‎משתמש‎ ‎מספק‎ ‎הזיהוי‎ ‎שלך‎ ‎כדי‎ ‎לוודא‎ ‎שהנושאים‎ ‎שלך‎ ‎פועלים‎ ‎כראוי‎, ‎גם‎ ‎אם‎ ‎המשתנים‎ ‎הללו‎ ‎ריקים‎.

משתנה IsLoggedIn

המשתנה User.IsLoggedIn מציין אם המשתמש מחובר (כתוצאה מהתחברות או מהיותו כבר מחובר, כלומר נתיב הצלחה בהתחברות) או לא מחובר (מה שיביא לנתיב כישלון בהתחברות).

User.IsLoggedIn‎ ‎הוא‎ ‎משתנה‎ ‎בוליאני‎ ‎המכיל‎ ‎את‎ ‎מצב‎ ‎ההתחברות‎ ‎של‎ ‎המשתמש‎. אפשר להשתמש במשתנה הזה כדי ליצור לוגיקה מתפצלת בנושאים שלך שבודקת אם התחברות מוצלחת (למשל, בתבנית שכבר סופקה כחלק מהוספת הצומת אימות), או כדי להביא מידע של משתמשים באופן מזדמן רק אם המשתמש מחובר.

משתנה user.AccessToken

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

אזהרה

ודא‎ ‎שאתה‎ ‎מעביר‎ ‎את‎ ‎המשתנה‎ ‎User.AccessToken‎ ‎רק‎ ‎למקורות‎ ‎מהימנים‎. הוא מכיל פרטי אימות של המשתמש, ואם ייפגעו או ייחשפו, הדבר עלול להזיק למשתמש.

אל תשתמש ב-User.AccessToken בצומת של הודעה, או בזרימות שאינך סומך עליהם.

בדיקת‎ ‎משתני‎ ‎אימות

כברירת מחדל, הלוח תוכנית Bot של בדיקה משתמש בחשבון של המשתמש שנכנס כרגע כדי למלא את המשתנים User.DisplayName ו-User.Id. עם זאת, כאשר בודקים נושאים שמפעילים אימות, ייתכן שתרצה להקצות ערכים אחרים עבור המשתנים האלה (או אפילו להשאיר אותם ריקים).

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

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

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

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

משתנה	פקודת‎ ‎ערך‎ ‎מותאם	פקודת ערך ריק (ריק)
User.DisplayName	/debug set bot.UserDisplayName "Value"	/debug set bot.UserDisplayName ""
User.Id	לא זמין	/debug set bot.UserID ""

חשוב

מטעמי אבטחה, לא ניתן למלא את המשתנה‎ ‎User.Id‎ ‎בערך מותאם אישית (מלבד ערך ריק).

אימות בעת שימוש באפשרות "אימות באמצעות Microsoft"

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

הערה

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

הוסף‎ ‎אימות‎ ‎משתמש‎ ‎לנושא

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

לאחר שהמשתמש מזין את שם המשתמש והסיסמה שלו בהנחיה (המתארחת על ידי ספק הזהות), ייתכן שיתבקש להזין קוד אימות, בהתאם לערוץ. חלק מהערוצים, כמו Microsoft Teams, אינם דורשים קוד אימות מהמשתמש.

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

כדי‎ ‎להוסיף‎ ‎צומת‎ ‏אימות‎ ‎לנושא‎ ‎שלך‎:

1. עבור‎ ‎לדף‎ ‎נושאים‎ ‎של‎ ‎הסוכן‎ ‎שברצונך‎ ‎לערוך‎.

2. פתח‎ ‎את‎ ‎הנושא‎ ‎שאליו‎ ‎אתה‎ ‎רוצה‎ ‎להוסיף‎ ‎את‎ ‎תבנית‎ ‎האימות‎.

   הערה

   אם הסוכן שלך מחובר אל Dynamics 365 Customer Service, צומת האימות לא יכול להיות חלק מנתיב השיחה שהסוכן עוקב בו כשהוא פוגש את המשתמשים לראשונה; אחרת, כרטיס הכניסה מוצג פעמיים. במקום‎ ‎זאת‎, ‎עליך‎ ‎להוסיף‎ ‎את‎ צומת ‏אימות‎ ‎לצומת‎ ‎אחר‎ ‎שמעורר‎ ‎תגובה‎ ‎של‎ ‎משתמש‎.

3. בחר‎ ‎‎ ‎הוסף‎ ‎צומת‎ ‎‎ (‎+‎) ‎כדי‎ ‎להוסיף‎ ‎צומת‎ ‎הודעה‎. הזן את מה שהסוכן צריך לומר כדי להודיע שחוויית כניסה עומדת להתרחש.

4. מתחת‎ ‎לצומת‎ ‎ההודעה‎, ‎בחר‎ ‎הוסף‎ ‎צומת‎ (‎+‎), ‎בחר‎ ‎קרא‎ ‎לפעולה‎, ‎ואז‎ ‎בחר‎ ‎אמת‎.

   

   הערה

   הצומת‎ ‏אימות‎ ‎זמין‎ ‎רק‎ ‎בבחירת‎ ‎פעולה‎ ‎בסוף‎ ‎עץ הדו-שיח (כצומת עלה). לא‎ ‎ניתן‎ ‎להוסיף‎ ‎זאת‎ ‎באמצע‎ ‎דו-שיח. ברגע‎ ‎שנוסף‎, ‎ניתן‎ ‎להוסיף‎ ‎צמתים‎ ‎אחרים‎ ‎מתחתיו‎.

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

שימוש‎ ‎ב‎-User.AccessToken ‎ללא‎ ‎צומת‎ ‎אימות

המשתנים‎ ‎User.IsLoggedIn‎ ‎ו‎-‎User.AccessToken‎ ‎זמינים‎ ‎גם‎ ‎אם‎ ‎אינך‎ ‎משתמש‎ ‎בתבנית‎ ‎שסופקה‎ ‎על‎ ‎ידי‎ ‎פריט‎ ‎התפריט‎ ‎קרא‎ ‎לפעולה‎. אם‎ ‎תעביר‎ ‎את‎ ‎המשתנה‎ ‎User.AccessToken‎ ‎מבלי‎ ‎שהמשתמש‎ ‎יעבור‎ ‎קודם‎ ‎דרך‎ ‎הצומת‎ ‏אימות‎, ‎המשתמש‎ ‎יתבקש‎ ‎להתחבר‎ ‎בשלב‎ ‎זה‎.

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

הערה

אם‎ ‎המשתמש‎ ‎מתנתק‎ ‎באמצע‎ ‎שיחה‎, ‎הוא‎ ‎מתבקש‎ ‎להתחבר‎ ‎שוב‎ ‎אם‎ ‎הנושא‎ ‎מגיע‎ ‎לצומת‎ ‎שמשתמש‎ ‎במשתנה‎ ‎User.AccessToken‎.

נתיב הצלחה

נתיב‎ ‎ההצלחה‎ ‎שווה‎ ‎לאיפה‎ ‎User.IsLoggedIn = True‎ ‎ומחשב‎ ‎מתי‎ ‎המשתמש‎ ‎מחובר‎ ‎בהצלחה‎.

אם‎ ‎יש‎ ‎לך‎ ‎לוגיקה‎ ‎שמשתמשת‎ ‎במשתנה‎ ‎User.AccessToken‎ (‎למשל‎, ‎כדי‎ ‎להתחבר‎ ‎למערכת‎ ‎אחורית‎ ‎באמצעות‎ ‎זרימה‎ ‎כדי‎ ‎לשחזר‎ ‎מידע‎ ‎על‎ ‎משתמש‎), ‎היא‎ ‎צריכה‎ ‎להיות‎ ‎תחת‎ ‎נתיב‎ ‎זה‎.

נתיב כשל

נתיב‎ ‎הכישלון‎ ‎שווה‎ ‎לכל‎ ‎מצב‎ ‎אחר‎ ‎מלבד‎ ‎IsLoggedIn = True‎. במרבית‎ ‎המקרים‎, ‎מסלול‎ ‎הכישלון‎ ‎מתרחש‎ ‎מכיוון‎ ‎שהמשתמש‎ ‎לא‎ ‎הצליח‎ ‎להתחבר‎, ‎השתמש‎ ‎בסיסמה‎ ‎שגויה‎, ‎או‎ ‎ביטל‎ ‎את‎ ‎חוויית‎ ‎ההתחברות‎.

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

בדיקת‎ ‎הנושא‎ ‎שלך

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

תוכן קשור

ניתן גם להגדיר כניסה יחידה (SSO), כך שהמשתמשים לא יצטרכו להתחבר ידנית. למידע‎ ‎נוסף‎, ‎ראה‎ ‎הגדרת‎ ‎כניסה‎ ‎יחידה‎ ‎עם‎ Microsoft Entra ID‎.