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

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

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

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

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

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

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

הערה

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

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

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

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

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

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

קלאסי / Teams

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

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

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

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

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

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

קלאסי / Teams

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

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

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

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

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

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

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

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

קלאסי / Teams

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

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

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

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

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

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

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

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

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

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

קלאסי / Teams

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

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

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

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

לדוגמה, הלקוח מתחיל את השיחה בנושא "הזמנת פעילות", שבו נעשה שימוש במשתנה 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. עבור כל שאר הערכים שאתה מצפה לקבל ממערכת חיצונית, הוסף עוד צמתים של ערכי משתנים לנושא היי ייעודי וקבע את התצורה של המשתנים הכלליים הנדרשים באותו אופן.

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

חשוב

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

קלאסי / Teams

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

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

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 יפעלו גם בדוגמה זו.

קלאסי / Teams

באפשרותך לצרף את המשתנים ואת ההגדרות שלהם אם אתה פשוט מטביע את הסוכן שלך בדף אינטרנט פשוט,<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));
   

קלאסי / Teams

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));
   

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

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

---

תוכן קשור

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