הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
משתנים קיימים בארבע רמות, או טווחים:
- משתני נושא שבהם ניתן להשתמש רק בנושאים שבהם אתה יוצר אותם. טווח זה הוא ברירת המחדל עבור משתנים שאתה יוצר.
- משתנים כלליים שבהם ניתן להשתמש בכל הנושאים. באפשרותך לשנות את הטווח של משתנה נושא כדי להפוך אותו למשתנה כללי.
- משתני מערכת ש-Copilot Studio יוצר באופן אוטומטי עבור סוכן. הם מספקים מידע הקשרי יותר אודות השיחה או המשתמש. הם זמינים בכל הנושאים.
- משתני סביבה שאתה יוצר ב- Power Platform. ב-Copilot Studio הם לקריאה בלבד. הם מאחסנים את מפתחות הפרמטרים והערכים, אשר משמשים לאחר מכן כקלט לאובייקטים שונים של יישומים אחרים, כולל Copilot Studio. הפרדת הפרמטרים מהאובייקטים הצורכים מאפשרת לשנות את הערכים בתוך אותה סביבה או בעת העברת פתרונות לסביבות אחרות. החלופה משאירה ערכי פרמטרים עם קוד קשיח בתוך הרכיבים המשתמשים בהם.
סוגי משתנים
לכל משתנה יש סוג בסיס. הסוג קובע באילו ערכים המשתנה יכול להחזיק ואת האופרטורים שבהם תוכל להשתמש בעת בניית ביטוי לוגי באמצעותו.
| סוג | תיאור |
|---|---|
| מחרוזת | רצף תווים המשמש לייצוג טקסט |
| בוליאני | ערך לוגי שיכול להיות רק true או false |
| מספר | כל מספר ממשי |
| טבלה | רשימת ערכים, אך כל הערכים חייבים להיות מאותו סוג |
| רשומת נתונים | אוסף של זוגות ערכי שמות שבהם הערכים יכולים להיות מכל סוג |
| תאריך ושעה | תאריך, שעה, יום בשבוע או חודש יחסית לנקודה בזמן |
| בחירה | רשימה של ערכי מחרוזת עם מילים נרדפות משויכות |
| ריק | מציין מיקום עבור "אין ערך" או "ערך לא ידוע"; לקבלת מידע נוסף, ראה ריק בתיעוד של Power Fx |
הגדרת סוג משתנה בפעם הראשונה שאתה מקצה לו ערך. לאחר מכן, הסוג יתוקן ולא תוכל להקצות ערכים מכל סוג אחר. לדוגמה, אם תקצה את הערך ההתחלתי 1 למשתנה, תגדיר את הסוג שלו ל'מספר'. אם תנסה להקצות ערך מחרוזת כגון "apples", תקבל שגיאה.
בעת בדיקת סוכן, משתנה עשוי להופיע באופן זמני עם הסוג לא ידוע. למשתנה לא ידוע עדיין אין ערך.
סדר המשתנים נקבע מלמעלה למטה על משטח העבודה של העריכה. צמתים בחלק העליון של מסך העריכה נחשבים לפני צמתים בחלק התחתון.
בעת יצירת הסתעפויות עם צמתי תנאי, הענפים מסודרים משמאל לימין. צמתים בענף הימני ביותר נחשבים לפני צמתים בהסתעפות הימנית ביותר.
ישויות
Copilot Studio משתמש entities כדי לזהות סוגי מידע ספציפיים מהתגובות של המשתמש. המידע המזוהה נשמר במשתנה מסוג המתאים למידע. הטבלה הבאה מפרטת את סוג הבסיס המשתנה המשויך לישויות שנבנו מראש.
| ישות | סוג בסיס משתנה |
|---|---|
| אפשרויות בחירה מרובות | בחירה |
| התגובה כולה של המשתמש | מחרוזת |
| גיל | מספר |
| בוליאני | בוליאני |
| עיר | מחרוזת |
| צבע | מחרוזת |
| יבשת | מחרוזת |
| מדינה או אזור | מחרוזת |
| תאריך ושעה | תאריך ושעה |
| דואר אלקטרוני | מחרוזת |
| אירוע | מחרוזת |
| מספר שלם | מספר שלם |
| שפה | מחרוזת |
| כסף | מספר |
| מספר | מספר |
| מסדרי | מספר |
| הארגון | מחרוזת |
| אחוז | מספר |
| שם אדם | מחרוזת |
| מספר טלפון | מחרוזת |
| נקודת עניין | מחרוזת |
| מהירות | מספר |
| מצב | מחרוזת |
| כתובת רחוב | מחרוזת |
| טמפרטורה | מספר |
| כתובת URL | מחרוזת |
| משקל | מספר |
| מיקוד | מחרוזת |
| ישות מותאמת אישית | בחירה |
משתני סביבה
משתני סביבה הם רעיון של Power Platform. משתני סביבה מאפשרים את תרחיש ניהול מחזור החיים הבסיסי של היישום (ALM) של העברת יישום בין סביבת Power Platform. בתרחיש זה, היישום נשאר זהה בדיוק למעט כמה הפניות חיצוניות מרכזיות השונות בין סביבת המקור לבין סביבת היעד.
השתמש במשתנה סביבה באותו אופן כמו משתני נושא, כללי ומערכת. הבדל משמעותי אחד הוא שמשתנה סביבה הם read-only ב- Copilot Studio. מחברי סוכן אינם יכולים לשנות משתני סביבה Copilot Studio. עם זאת, מנהלי מערכת יכולים לשנות את הערך של משתני סביבה Power Apps. ב Copilot Studio, באפשרותך להשתמש בחלונית Variables כדי לראות מידע אודות משתנה סביבה. לוח המאפיינים Variable כולל גם קישור ל- Power Apps, חוויית העריכה עבור משתני סביבה.
הגירסה שפורסמה של סוכן המשתמש במשתני סביבה מכילה את הערכים שהוגדרו עבור משתנים אלה בעת פרסומו. בכל פעם שמנהל מערכת מעדכן משתני סביבה, עליך לפרסם מחדש סוכנים המשתמשים במשתנים אלה, כדי שהשינויים ייכנסו לתוקף בזמן ריצה. עם זאת, קיים יוצא מהכלל אחד: אין צורך לפרסם מחדש את הסוכנים שלך כאשר הערך של משתנה סביבה מסוג סוד משתנה. בניגוד למשתנה סביבה אחרים, משתנים סודיים מאוחזרים בזמן ריצה.
סוגי משתני הסביבה ב-Copilot Studio מותאמים לסוגי הנתונים של Power Apps כדלקמן:
| הקלד ב-Copilot Studio | הקלד Power Apps |
|---|---|
| מספר עשרוני | מספר |
| JSON | לזהות את הסוג מהערך. אם לא JSON => Unspecified (שגיאת אימות) |
| טקסט | מחרוזת |
| כן/לא | בוליאני |
| מקור נתונים | מחרוזת |
| סודי | מחרוזת |
הערה
שגיאות משתני סביבה גלויות בצ'אט הבדיקה ו בעת הפרסום. עם זאת, שגיאות אלה אינן מוצגות ברשימת הנושאים מאחר שהן אינן משתני נושא.
משתני מערכת
כל סוכן מגיע עם משתני מערכת מוכללים המספקים מידע נוסף אודות שיחה.
הערה
לקבלת מידע נוסף אודות משתני סוכן המותאמים לקול, ראה שימוש במשתנה קוליים.
Copilot Studio אינו מציג את כל משתני המערכת. כדי לגשת למשתנה מערכת מוסתרים, השתמש בנוסחת Power Fx.
כדי להשתמש במשתנה מערכת בנוסחת Power Fx, הוסף System. לפני שם המשתנה. לדוגמה, כדי לכלול את משתנה User.DisplayName המערכת בנוסחה, התייחס אליו בתור System.User.DisplayName.
| שם | סוג | הגדרה |
|---|---|---|
| פעולה.קבצים מצורפים | טבלה | הקבצים המצורפים שהמשתמש מספק. |
| פעילות.ערוץ | בחירה | מזהה הערוץ של השיחה הנוכחית. |
| Activity.ChannelData | כל / כלשהו | אובייקט המכיל תוכן ספציפי לערוץ. |
| Activity.ChannelId | מחרוזת | מזהה הערוץ של השיחה הנוכחית, כמחרוזת. |
| Activity.From.Id | מחרוזת | המזהה הייחודי הספציפי לערוץ של השולח. |
| פְּעִילוּת.מְאֵת.שֵׁם | מחרוזת | השם הידידותי למשתמש הספציפי לערוץ של השולח. |
| שם.פעילוּת | מחרוזת | שם האירוע. |
| Activity.Recipient.Id | מחרוזת | המאפיין של סוג הפעילות הנכנסת. |
| Activity.Recipient.Name | מחרוזת | מייצג את שם התצוגה עבור הסוכן בתוך הערוץ. בהקשר של ערוץ טלפוניה, הערך של משתנה זה הוא מספר הטלפון שאליו מצורף הסוכן. |
| פעילות.טקסט | מחרוזת | ההודעה העדכנית ביותר שנשלחה על-ידי המשתמש. |
| סוג פעילות | בחירה | סוג פעילות. |
| Activity.TypeId | מחרוזת | סוג הפעילות, כמחרוזת. |
| Activity.Value | כל / כלשהו | ערך פתוח. |
| Bot.EnvironmentId | מחרוזת | מזהה הסביבה של הסוכן. |
| Bot.Id | מחרוזת | המזהה של הסוכן. |
| Bot.Name | מחרוזת | שם הסוכן שלך. |
| Bot.SchemaName | מחרוזת | שם הסכימה של הסוכן. |
| Bot.TenantId | מחרוזת | מזהה משכיר של הסוכן. |
| ClientPluginActions | בחירה | אוסף תוספי לקוח דינאמיים לשקול לתזמור גנרטיבי. |
| Conversation.Id | מחרוזת | המזהה הייחודי של השיחה הנוכחית. |
| Conversation.InTestMode | בוליאני | דגל בוליאני המייצג אם השיחה מתרחשת בסביבת בדיקה. |
| Conversation.LocalTimeZone | מחרוזת | שם אזור הזמן שבו יש להשתמש על-ידי המשתמש בתבנית מסד הנתונים של אזור הזמן של IANA. |
| Conversation.LocalTimeZoneOffset | תאריך ושעה | הפרש הזמן מול "UTC" עבור אזור הזמן המקומי הנוכחי. |
| קוד שגיאה | מחרוזת | קוד השגיאה עבור השגיאה הנוכחית. הודעת השגיאה עבור השגיאה הנוכחית. |
| שגיאה. הודעה | מחרוזת | הודעת השגיאה עבור השגיאה הנוכחית. הערה: משתנה זה נתמך רק אם הגורם המפעיל הוא On Error. |
| מונה חזרות | מספר | משתנה זה סופר את השעות שלא היתה אפשרות להתאים נושא לקלט של המשתמש. הערה: משתנה זה נתמך רק אם הגורם המפעיל הוא On Unknown Intent. |
| InactivityTimer.Continue | בוליאני | דגל בוליאני המייצג אם שעון העצר צריך להמשיך. הערה: משתנה זה נתמך רק אם הגורם המפעיל הוא Inactivity. |
| InactivityTimer.Count | מספר | מספר הפעמים ששעון העצר של OnInactivity הופעל עקב חוסר פעילות משתמש לאחר פרק הזמן שהוגדר. הערה: משתנה זה נתמך רק אם הגורם המפעיל הוא Inactivity. קבל מידע נוסף במפעיל של חוסר פעילות אודות קביעת תצורה של גורמים מפעילים של חוסר פעילות ושימוש במשתנים אלה. |
| LastMessage.Id | מחרוזת | מזהה ההודעה הקודמת שנשלחה על-ידי המשתמש. |
| הודעה אחרונה.טקסט | מחרוזת | ההודעה הקודמת שנשלחה על-ידי המשתמש. |
| Recognizer.ExtractedEntities | בחירה | מייצג את הישויות שחולצו מהודעת טריגר. הערה: משתנה זה נתמך רק אם הגורם המפעיל הוא On Select Intent. |
| Recognizer.IntentOptions | בחירה | מייצג את אפשרויות המטרה כאשר מזהה מחזיר תוצאות רב-משמעיות. הערה: משתנה זה נתמך רק אם הגורם המפעיל הוא On Select Intent. |
| Recognizer.SelectedIntent | בחירה | מייצג את הכוונה שנבחרה מהמזהה. הערה: משתנה זה נתמך רק אם הגורם המפעיל הוא On Select Intent. |
| Recognizer.TriggeringMessage.Id | מחרוזת | המזהה של הודעת המשתמש שהפעיל את הנושא הנוכחי. |
| מאפיין Recognizer.TriggeringMessage.Text | מחרוזת | הודעת המשתמש שהפעילה את הנושא הנוכחי. |
| Recognizer.MultipleTopicsMatchedReason | מחרוזת | משמש כדי לקבוע מדוע הותאימו נושאים מרובים. הערה: משתנה זה נתמך רק אם הגורם המפעיל הוא On Select Intent. |
| סיבת כניסה | בחירה | משמש כדי לקבוע איזו אפשרות כניסה נדרשת בעת הפעלת הנושא. הערה: משתנה זה נתמך רק אם הגורם המפעיל הוא On Sign In. |
| שפת משתמש | בחירה | משתנה זה משמש כדי להגדיר את אזור שפת המשתמש לכל שיחה. |
משתנים לאימות משולב (ברירת מחדל)
המשתנים הבאים זמינים עבור נציגים שתצורתם נקבעה לאימות עם Microsoft. תצורה זו משתמשת Microsoft Entra ID אימות אוטומטי והיא ברירת המחדל עבור סוכנים חדשים.
לקבלת מידע נוסף, ראה משתני אימות.
| שם | סוג | הגדרה |
|---|---|---|
| שםתצוגתמשתמש | מחרוזת | שם התצוגה של המשתמש המשוחח כעת עם הסוכן. |
| משתמש.אימייל | מחרוזת | כתובת הדואר האלקטרוני של המשתמש המשוחחת כעת עם הסוכן. |
| [שם משתמש.שם פרטי] | מחרוזת | השם הפרטי של המשתמש המשוחח כעת עם הסוכן. |
| User.Id | מחרוזת | המזהה הייחודי של המשתמש המשוחח כעת עם הסוכן. |
| User.IsLoggedIn | בוליאני | דגל בוליאני המייצג אם המשתמש המשוחח כעת עם הסוכן מאומת או לא. |
| User.LastName | מחרוזת | שם המשפחה של המשתמש המשוחח כעת עם הסוכן. |
| User.PrincipalName | מחרוזת | שם המשתמש הראשי של המשתמש המשוחח כעת עם הסוכן. |
משתנים לאימות ידני עם OAuth 2 כללי
המשתנים הבאים זמינים עבור נציגים שתצורתם נקבעה לשימוש ספק השירות הכללי של OAuth 2.
| שם | סוג | הגדרה |
|---|---|---|
| User.AccessToken | מחרוזת | אסימון הגישה עבור המשתמש המ מאמת עם הסוכן. |
| שםתצוגתמשתמש | מחרוזת | שם התצוגה של המשתמש המשוחח כעת עם הסוכן. |
| User.Id | מחרוזת | המזהה הייחודי של המשתמש המשוחח כעת עם הסוכן. |
| User.IsLoggedIn | בוליאני | דגל בוליאני המייצג אם המשתמש המשוחח כעת עם הסוכן מאומת או לא. |
משתנים לאימות ידני עם Microsoft Entra ID
המשתנים הבאים זמינים עבור סוכנים שתצורתם נקבעה לשימוש בספקי השירות של Microsoft Entra ID (לשעבר Azure Active Directory).
| שם | סוג | הגדרה |
|---|---|---|
| User.AccessToken | מחרוזת | אסימון הגישה עבור המשתמש המ מאמת עם הסוכן. |
| שםתצוגתמשתמש | מחרוזת | שם התצוגה של המשתמש המשוחח כעת עם הסוכן. |
| משתמש.אימייל | מחרוזת | כתובת הדואר האלקטרוני של המשתמש המשוחחת כעת עם הסוכן. |
| [שם משתמש.שם פרטי] | מחרוזת | השם הפרטי של המשתמש המשוחח כעת עם הסוכן. |
| User.Id | מחרוזת | המזהה הייחודי של המשתמש המשוחח כעת עם הסוכן. |
| User.IsLoggedIn | בוליאני | דגל בוליאני המייצג אם המשתמש המשוחח כעת עם הסוכן מאומת או לא. |
| User.LastName | מחרוזת | שם המשפחה של המשתמש המשוחח כעת עם הסוכן. |
| User.PrincipalName | מחרוזת | השם הראשי של המשתמש המשוחח כעת עם הסוכן. |
משתנים עבור סוכנים המותאמים לקול
המשתנים הבאים זמינים רק עבור סוכנים המותאמים לקול.
הערה
לקבלת מידע נוסף אודות משתני סוכן המותאמים לקול, ראה שימוש במשתנה קוליים.
| שם | סוג | הגדרה |
|---|---|---|
| Activity.InputDTMFKeys | מחרוזת | ערך המפתח הגולמי של DTMF מהטלפוניה. |
| Activity.SpeechRecognition.Confidence | מספר | תוצאת הביטחון עבור Azure Site Recovery ההשערה כולה, 0 עד 1. |
| Activity.SpeechRecognition.MinimallyFormattedText | מחרוזת | טקסט מעוצב מעט של תוצאת התרחיש ב-Azure Site Recovery. לדוגמה, "500 דולר". מילים מאויתות, אך רישיות וסימני פיסוק בסיסיים כלולים. |
| Activity.UserInputType | בחירה | סוג הקלט האחרון מהמשתמש הסוכן. הערך יכול להיות בדיקה, דיבור או DTMF. |
| שיחה.אפשר רק DTMF | בוליאני | דגל בוליאני המייצג אם יש להגדיר את IVR למצב DTMF-only בזמן ריצה. |
| Conversation.SipUuiHeaderValue | מחרוזת | מחרוזת הכותרת של ממשק המשתמש המשמשת כדי להעביר הקשר ל- IVR בעת התחלת השיחה. |