עבודה עם משתנים כלליים

הערה

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

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

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

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

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

יצירת משתנה כללי

ניתן ליצור משתנה כללי על-ידי שינוי הטווח של משתנה נושא.

הערה

השם של משתנה כללי חייב להיות ייחודי בכל הנושאים.

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

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

2. בלוח מאפייני משתנה , בחר כללי (כל נושא יכול לגשת). שם המשתנה מקבל את הקידומת Global. כדי להבחין בינו לבין משתנים ברמת הנושא. לדוגמה, המשתנה הופך UserName ל Global.UserName- .

3. שמור את הנושא.

תוכנית הקבוצות

1. בחר את המשתנה הרצוי.

2. בלוח מאפייני משתנה , תחת שימוש, בחרבוט (כל נושא יכול לגשת).

3. שם המשתנה מקבל את הקידומת bot. כדי להבחין בינו לבין המשתנים ברמת הנושא. לדוגמה, המשתנה הופך UserEmail ל bot.UserEmail- .

שימוש במשתנים כלליים

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

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

תוכנית הקבוצות

בעת חיבור הודעה בצומת הודעה או בצומת שאלה, בחר את הסמל {x} כדי להציג את המשתנים שהנושא יכול לגשת אליהם. המשתנים מפורטים בסדר אלפביתי, וכל המשתנים הכלליים מופיעים יחד מכיוון שכל המשתנים מתחילים ב- bot..

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

איתור כל הנושאים המשתמשים במשתנה כללי

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

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

1. בחר את המשתנה הכללי הרצוי בבד הציור של העריכה או בלוח משתנים .

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

3. עבור לכרטיסיה אחר ובחר נושא כלשהו שבו המשתנה משמש כדי לעבור ישירות לנושא ולצומת אלה.

תוכנית הקבוצות

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

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

• כדי לעבור לנושא המשתמש במשתנה זה, בחר את הנושא הרצוי במקטע בשימוש על-ידי .

מחיקת משתנים כלליים

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

צמתים המכילים הפניות למשתנה כללי שנמחק מציינים שהם מכילים משתנה לא ידוע.

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

מחזור החיים של משתנים גלובליים

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

כברירת מחדל, ערך משתנה כללי נמשך עד מסתיים ההפעלה . הצומת Clear variable values מאפס את הערכים של משתנים כלליים. נושא המערכת איפוס שיחה משתמש בצומת זה. כאשר ניתוב מחדש מפעיל נושא זה (או כאשר המשתמש מזין צירוף מילים כגון "התחל מחדש"), כל המשתנים הכלליים מתאפסים.

תוכנית הקבוצות

באפשרותך לגשת למשתנים כלליים מכל נושא, והערך שלהם נשאר לאורך כל ההפעלה.

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

אתחול משתנה כללי

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

לדוגמה, הלקוח מתחיל את השיחה בנושא "הזמנת פעילות", שבו נעשה שימוש במשתנה bot.UserName כללי. עם זאת, bot.UserName המשתנה מוגדר תחילה בנושא "ברוך הבא".

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

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

התנהגות משתנה גלובלית בעת יישום פעולות באמצעות Power Automate או מיומנויות

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

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

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

הגדרת משתנים כלליים ממקורות חיצוניים

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

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

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

הערה

סוכנים שפורסמו בערוץ ה- Dynamics 365 Contact Center עבור מקרי שימוש של IVR אינם תומכים בערךי זמן קצוב שהוגדרו עבור משתנים כלליים שהוגדרו על-ידי מקורות חיצוניים.

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

2. הוסף צומת הגדרת ערך משתנה לנושא ייעודי.

3. תחת הגדר משתנה, פתח את בורר המשתנים ובחר צור משתנה חדש.

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

5. החלף את שם ברירת המחדל בשם התואם בדיוק לשם המשתנה המועבר מהמערכת החיצונית.

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

7. תחת הפניה, בחר את שלוש הנקודות (⋮) בפינה השמאלית העליונה ובחר קבל ערך מצומת זה אם הוא ריק.

8. (אופציונלי) הגדר השהיה של זמן קצוב, באלפיות שניה. ערך זה קובע את משך הזמן שהסוכן שלך יכול להמתין להגדרה של המשתנה על-ידי מקור חיצוני לפני תם הזמן שהוקצה והמשך עם ערך ברירת המחדל שאתה מגדיר בצומת Set variable value . הגדרה זו רלוונטית בתרחישים שבהם המשתנה תלוי בתהליך ארוך-ריצה או אסינכרוני, אך הסוכן שלך חייב לכבד השהיה מרבית כדי להבטיח חוויית משתמש טובה.

   עבור משתנים שמגיעים מ- Omnichannel עבור שירות לקוחות, השתמש בערך של 10 שניות (10,000 אלפיות שניה) כשם המתנה מרבי.

9. בצומת Set variable value , הזן את ערך ברירת המחדל שבו יש להשתמש אם הזמן הקצוב תם. בזמן ריצה, הסוכן שלך מצפה לערכים בעלי סוג נתונים זהה. אם ברצונך שערך ברירת מחדל זה יהיה מחרוזת ריקה, השתמש Text("") כנוסחה.

   

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

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

Important

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

תוכנית הקבוצות

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

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

1. בחר את המשתנה הכללי הרצוי.

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

הגדרת משתנים כלליים בסוכן מוטבע

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

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

שם המשתנה במחרוזת השאילתה של כתובת ה- URL חייב להתאים לשם המשתנה הכללי ללא Global. הקידומת. לדוגמה, עבור משתנה כללי Global.UserName השתמש רק UserName בשאילתה.

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

צרף את המשתנים וההגדרות שלהם אל כתובת ה- URL של הסוכן כפרמטרים של מחרוזת שאילתה בתבנית botURL?variableName1=variableDefinition1&variableName2=variableDefinition2.

לדוגמה:

• יש לך משתנה כללי בשם Global.UserName.
• כתובת ה- URL של הסוכן שלך היא https://web.powerva.microsoft.com/webchat/bots/12345.
• כדי להעביר את שם המשתמש בעת התחלת שיחת סוכן באתר האינטרנט שלך, צרף את מחרוזת UserName= השאילתה בתור: https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Ana.

שם הפרמטר אינו תלוי רישיות: פועל username=Ana גם בדוגמה זו.

תוכנית הקבוצות

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

הערה

שם המשתנה במחרוזת השאילתה חייב להתאים לשם המשתנה הכללי, ללא bot. הקידומת. לדוגמה, המשתנה הכללי חייב bot.UserEmail להופיע בתור UserEmail=.

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

1. צרף את המשתנים ואת ההגדרות שלהם אל כתובת ה- URL של הסוכן כפרמטרים של מחרוזת שאילתה (בתבנית של botURL?variableName1=variableDefinition1&variableName2=variableDefinition2), לדוגמה:

   • יש לך משתנה כללי בשם bot.UserEmail.
   • כתובת ה- URL של הסוכן שלך היא https://web.powerva.microsoft.com/webchat/bots/12345.
   • כדי להעביר את שם המשתמש בעת הפעלת שיחת סוכן באתר אינטרנט, צרף את מחרוזת UserEmail= השאילתה בתור: https://web.powerva.microsoft.com/webchat/bots/12345?UserEmail=Ana@contoso.com.

2. שם הפרמטר אינו תלוי רישיות: פועל useremail=Ana@contoso.com גם בדוגמה זו.

הוספת משתנים כלליים לבד ציור מותאם אישית

באפשרותך גם להוסיף את המשתנה לבד ציור מותאם אישית.

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

1. במקטע בעמוד <script> שבו נמצא הסוכן שלך, הגדר את המשתנים באופן הבא, variableName1Global.variableDefinition1 תוך החלפה עבור שם המשתנה ללא הקידומת ולהגדרה. הפרד משתנים מרובים באמצעות פסיקים (,).

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. במקטע שלך <script>, קרא ל-store בעת הטמעת הסוכן שלך, כמו בדוגמה הבאה שבה store נקרא ממש לפני ש-styleOptions נקרא. עליך להחליף את BOT_ID בזיהוי של הסוכן שלך.

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));
   

תוכנית הקבוצות

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

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. בתוך המקטע <script> שלך, עליך לקרוא ל-store בעת הטבעת הסוכן שלך, כפי שמודגם בדוגמה הבאה שבה נעשית קריאה ל-store רגע לפני ביצוע הקריאה ל-styleOptions (יש להחליף את BOT_ID במזהה שלך):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));
   

משתנים כלליים הקשורים לאימות

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

---

תוכן קשור

• עבודה עם משתנים
• התאמה אישית של המראה והתחושה של סוכן