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

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

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

באפשרותך להעביר משתנים אל ולהחזיר אותם מנושאים אחרים ו- Power Automate זרימות.

יצירת משתנה

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

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

עצה

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

לא ניתן לשנות את השמות של צמתי טריגר ושל צמתי עבור אל שלב.

שמות צמתים יכולים להכיל עד 500 תווים.

קלאסי

1. עבור אל דף הנושאים של הצ'אטבוט הקלאסי ופתח את הנושא הרצוי.

2. בחר את סמל הוסף צומת תחת הצומת שאחריו ברצונך להוסיף צומת שאלה. לאחר מכן בחר שאל שאלה. Copilot Studio יוצר באופן אוטומטי משתנה לאחסון תגובת המשתמש.

   

בחר ישות לשימוש

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

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

קלאסי

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

שינוי שם של משתנה

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

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

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

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

קלאסי

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

הגדרת משתנה

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

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

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

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

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

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

     

4. עבור הערך, הקצה ערך באמצעות אחת מהאפשרויות הבאות:

   • הקלד ערך ליטרלי.

   • בחר משתנה קיים מאותו סוג.

   • השתמש בנוסחת Power Fx. נוסחאות Power Fx שימושיות עבור סוגים מורכבים יותר שבהם לא ניתן להשתמש בערכים מילוליים, כגון סוגי טבלה והרשומות.

שימוש במשתנים בצמתים של פעולה

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

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

שימוש בערךים ליטרליים עבור קלט משתנה

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

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

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

שימוש במשתני סביבה עבור סודות Azure Key Vault

משתנה סביבה יכול להפנות לסוד ב-Key Vault. משתני סביבה סודיים הם מקרה מיוחד של משתני סביבה בעלי שיקולים ייחודיים.

כדי ליצור משתנה סביבה סודי ב- Power Apps, עליך configure a Key Vault vault.

כדי לאשר ל-Copilot Studio לקרוא את ה-Key Vault, בצע את הפעולות הבאות:

1. הקצה את התפקיד Key Vault Secrets User ליישום Microsoft Copilot Studio Service.

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

3. כדי לאשר לסוכנים ספציפיים בלבד מהסביבה להשתמש בכספת זו, AllowedAgents צור תגית והכנס את מזהה הסוכן לתבנית {envId}/{schemaName}. עבור ערכים מרובים, הפרד את הערכים באמצעות פסיקים.

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

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

אזהרה

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

החלונית 'משתנים'

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

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

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

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

קלאסי

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

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

   

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

   

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

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

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

העברת משתנים בין נושאים

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

קבלת ערכים מנושאים אחרים

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

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

דוגמה זו משתמשת בשני נושאים, Greeting ו - Talk to Customer. שני הנושאים מבקשים את שם הלקוח. עם זאת, אם נושא הברכה פועל תחילה, הנושא 'דבר ללקוח ' מדלג על השאלה שלו. במקום זאת, הוא משתמש בערך של המשתנה שהועבר מנושא הברכה .

להלן הזרימה של נושא 'דבר ללקוח ':

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

להלן הזרימה של נושא הברכה :

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

לבסוף, הנה שוב השיחה השנייה, הפעם מנקודת המבט של נושא 'דבר ללקוח ':

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

הגדרת נושא היעד

נושא היעד מקבל ערכים מנושאים אחרים. בדוגמה זו, זהו Talk to Customer.

1. צור נושא חדש ותן לו את השם "דבר ללקוח".

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

3. הוסף צומת Question והזן "איך אני צריך לפנות אליך?" עבור ההודעה.

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

5. בחר את שם המשתנה. לוח המאפיינים משתנה נפתח.

6. החלף את שם customerNameברירת המחדל ב- ולאחר מכן בחר קבל ערכים מנושאים אחרים.

   

7. הוסף צומת הודעה.

8. בתיבת ההודעה, הזן "אני מקווה שיהיה לך יום נפלא, ".

9. בחר את סמל הוסף משתנה ({x}) ולאחר מכן בחר customerName.

10. בחר את הרווח אחרי המשתנה והזן סימן קריאה (!).

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

הגדרת נושא המקור

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

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

2. הוסף נוד שאלה והזן "מה שמך?" עבור ההודעה.

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

4. החלף את שם ברירת המחדל ב- customerNameFromGreeting.

5. הוסף צומת הודעה.

6. בתיבת ההודעה, הזן "שמח לפגוש אותך, ".

7. בחר את סמל הוספת משתנה ({x}) ולאחר מכן בחר customerNameFromGreeting.

8. בחר את הרווח אחרי המשתנה והזן סימן קריאה (!).

9. הוסף צומת ניתוב מחדש ובחר את נושא היעד דבר ללקוח.

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

    

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

    צומת הניתוב מחדש אמור להיראות כך:

    

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

קלאסי

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

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

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

   

   הערה

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

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

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

5. בחר הוסף קלט עבור נושא היעד.

   

6. בחר משתנה בנושא שנותב מחדש שאליו ברצונך להעביר את המשתנה.

   

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

   

   המשתנה מוצג בצומת שנותב מחדש.

   

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

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

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

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

הגדרת נושא המקור עבור משתנה מוחזר

בעת החזרת משתנה לנושא, נושא המקור הוא הנושא שמספק את הערך שיש להעביר בחזרה לנושא המקורי. בדוגמה זו, נושא המקור הוא Talk to Customer.

1. עבור לנושא המקור.

2. הוסף צומת שאלה והזן "באיזה עיר אתה מתגורר?" עבור ההודעה.

3. תחת זהה, בחר את עיר הישות שנבנתה מראש.

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

   

5. הוסף צומת הודעה.

6. בחר את סמל הוסף משתנה ({x}) ולאחר מכן בחר customerCity.

7. לאחר המשתנה בתיבת ההודעה, הזן " חייב להיות יפה בזמן זה של השנה!".

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

הגדרת נושא היעד עבור משתנה מוחזר

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

1. עבור אל נושא היעד.

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

   

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

קלאסי

כדי להחזיר משתנה לנושא המקורי, הגדר את המאפיין של המשתנה:

1. בצומת שאלה , בחר את המשתנה שברצונך לחזור לנושאים אחרים.

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

   

   הערה

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

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

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

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

   

ניתוח ערכים

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

{
    "Name": "Parker",
    "Position": "Product manager",
    "Company": "Contoso",
    "FormerPositions": [{
            "Position": "Customer service representative"
        }
    ]
}

צומת הערך Parse ממיר את משתנה המחרוזת למשתנה מסוג רשומה. עורך Power Fx מספק השלמת קוד IntelliSense והצעות עבור סוג זה.

מלבד ניתוח מחרוזות JSON, השימוש במפתח עבור צומת הערך Parse מנתח אובייקטים שאינם מוקלידים בזמן ריצה. מקרה השימוש הנפוץ ביותר הוא כאשר אתה מקבל אירוע ועלך לנתח את ערך האירוע. לחלופין, ייתכן שתרצה לנתח את מבנה הטקסט System.Activity.ChannelData של המאפיין, אשר משתנה בזמן ריצה לפי ערוץ.

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

כדי להוסיף צומת של ערך ניתוח לנושא:

1. בחר את סמל הוסף צומת שמתחת לצומת שלאחריו ברצונך לנתח ערך. הצבע על ניהול משתנים ובחר ניתוח ערך.

2. הוסף צומת ניתוח ערך, ובחר את המשתנה שברצונך לנתח.

   

3. עבור סוג הנתונים, בחר מתוך נתונים לדוגמה.

   

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

   

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

   

   משתנה הפלט כולל כעת את הסוג הצפוי: רשומה.

   

תוכן קשור

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