הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
הערה
המאפיינים במאמר זה מופעלים על ידי הרתמה הסטנדרטית, המשתמשת באפשרויות החיוב המתוארות ברישוי לסוכנים המופעלים על ידי הרתמה הסטנדרטית. למד כיצד לגשת ליכולות סטנדרטיות ב-גישה לסוכנים סטנדרטיים ולתזרימי סוכן.
משתנים קיימים בארבע רמות, או טווחים:
- משתני נושא שבהם ניתן להשתמש רק בנושאים שבהם אתה יוצר אותם. טווח זה הוא ברירת המחדל עבור משתנים שאתה יוצר.
- משתנים כלליים שבהם ניתן להשתמש בכל הנושאים. באפשרותך לשנות את הטווח של משתנה נושא כדי להפוך אותו למשתנה כללי.
- משתני מערכת ש-Copilot Studio יוצר באופן אוטומטי עבור סוכן. הם מספקים מידע הקשרי יותר אודות השיחה או המשתמש. הם זמינים בכל הנושאים.
- משתני סביבה שאתה יוצר ב- Power Platform. ב-Copilot Studio הם לקריאה בלבד. הם מאחסנים את מפתחות הפרמטרים והערכים, אשר משמשים לאחר מכן כקלט לאובייקטים שונים של יישומים אחרים, כולל Copilot Studio. על ידי הפרדת הפרמטרים מהאובייקטים הצורכים, ניתן לשנות את הערכים באותה סביבה או כשאתה מעביר פתרונות לסביבות אחרות. החלופה משאירה ערכי פרמטרים עם קוד קשיח בתוך הרכיבים המשתמשים בהם.
סוגי משתנים
לכל משתנה יש סוג בסיס. הסוג קובע באילו ערכים המשתנה יכול להחזיק ואת האופרטורים שבהם תוכל להשתמש בעת בניית ביטוי לוגי באמצעותו.
| סוג | תיאור |
|---|---|
| מחרוזת | רצף תווים המשמש לייצוג טקסט |
| בוליאני | ערך לוגי שיכול להיות רק true או false |
| מספר | כל מספר ממשי |
| טבלה | רשימת ערכים, אך כל הערכים חייבים להיות מאותו סוג |
| רשומת נתונים | אוסף של זוגות ערכי שמות שבהם הערכים יכולים להיות מכל סוג |
| תאריך ושעה | תאריך, שעה, יום בשבוע או חודש יחסית לנקודה בזמן |
| בחירה | רשימה של ערכי מחרוזת עם מילים נרדפות משויכות |
| ריק | תחליף זמני ל"אין ערך" או "ערך לא ידוע"; למדו עוד ב-Blank בתיעוד Power Fx |
הגדרת סוג משתנה בפעם הראשונה שאתה מקצה לו ערך. לאחר מכן, הסוג יתוקן ולא תוכל להקצות ערכים מכל סוג אחר. לדוגמה, אם תקצה את הערך ההתחלתי 1 למשתנה, תגדיר את הסוג שלו ל'מספר'. אם תנסה להקצות ערך מחרוזת כגון "apples", תקבל שגיאה.
בעת בדיקת סוכן, משתנה עשוי להופיע באופן זמני עם הסוג לא ידוע. למשתנה לא ידוע עדיין אין ערך.
סדר המשתנים נקבע מהחלק העליון ועד התחתון של קנבס הכתיבה. הסוכן בוחן את הצמתים בראש קנבס המחבר לפני הצמתים בתחתית.
כשאתה יוצר סניפים באמצעות צמתים של Condition, Copilot Studio מורה להסתעפים משמאל לימין. הסוכן בוחן את הצמתים בענף השמאלי ביותר לפני הצמתים בענף הימני ביותר.
ישויות
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.
| Name | סוג | הגדרה |
|---|---|---|
| פעולה.קבצים מצורפים | טבלה | הקבצים המצורפים שהמשתמש מספק. |
| פעילות.ערוץ | בחירה | מזהה הערוץ של השיחה הנוכחית. |
| 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. |
| שפת משתמש | בחירה | משתנה זה משמש כדי להגדיר את אזור שפת המשתמש לכל שיחה. |
משתנים עבור סוכנים המותאמים לקול
המשתנים הבאים זמינים רק עבור סוכנים המותאמים לקול. למידע נוסף, ראו שימוש במשתני קול.
| Name | סוג | הגדרה |
|---|---|---|
| Activity.InputDTMFKeys | מחרוזת | ערך המפתח הגולמי של DTMF מהטלפוניה. |
| Activity.SpeechRecognition.Confidence | מספר | ציון האמון של השערת זיהוי הדיבור האוטומטית הוא התוצאה המלאה, 0 ל-1. |
| Activity.SpeechRecognition.MinimallyFormattedText | מחרוזת | טקסט מעט מעוצב של תוצאת השערת זיהוי דיבור אוטומטית. לדוגמה, "500 דולר". מילים מאויתות, אך רישיות וסימני פיסוק בסיסיים כלולים. |
| Activity.UserInputType | בחירה | סוג הקלט האחרון מהמשתמש הסוכן. הערך יכול להיות בדיקה, דיבור או DTMF. |
| שיחה.אפשר רק DTMF | בוליאני | דגל בוליאני המייצג אם יש להגדיר את IVR למצב DTMF-only בזמן ריצה. |
| Conversation.SipUuiHeaderValue | מחרוזת | מחרוזת הכותרת של ממשק המשתמש המשמשת כדי להעביר הקשר ל- IVR בעת התחלת השיחה. |
משתנים לאימות משולב (ברירת מחדל)
המשתנים הבאים זמינים עבור נציגים שתצורתם נקבעה לאימות עם Microsoft. תצורה זו משתמשת Microsoft Entra ID אימות אוטומטי והיא ברירת המחדל עבור סוכנים חדשים. למדו עוד במשתני אימות.
| Name | סוג | הגדרה |
|---|---|---|
| שםתצוגתמשתמש | מחרוזת | שם התצוגה של המשתמש המשוחח כעת עם הסוכן. |
| משתמש.אימייל | מחרוזת | כתובת הדואר האלקטרוני של המשתמש המשוחחת כעת עם הסוכן. |
| [שם משתמש.שם פרטי] | מחרוזת | השם הפרטי של המשתמש המשוחח כעת עם הסוכן. |
| User.Id | מחרוזת | המזהה הייחודי של המשתמש המשוחח כעת עם הסוכן. |
| User.IsLoggedIn | בוליאני | דגל בוליאני המייצג אם המשתמש המשוחח כעת עם הסוכן מאומת או לא. |
| User.LastName | מחרוזת | שם המשפחה של המשתמש המשוחח כעת עם הסוכן. |
| User.PrincipalName | מחרוזת | שם המשתמש הראשי של המשתמש המשוחח כעת עם הסוכן. |
משתנים לאימות ידני עם OAuth 2 כללי
המשתנים הבאים זמינים עבור נציגים שתצורתם נקבעה לשימוש ספק השירות הכללי של OAuth 2.
| Name | סוג | הגדרה |
|---|---|---|
| User.AccessToken | מחרוזת | אסימון הגישה עבור המשתמש המ מאמת עם הסוכן. |
| שםתצוגתמשתמש | מחרוזת | שם התצוגה של המשתמש המשוחח כעת עם הסוכן. |
| User.Id | מחרוזת | המזהה הייחודי של המשתמש המשוחח כעת עם הסוכן. |
| User.IsLoggedIn | בוליאני | דגל בוליאני המייצג אם המשתמש המשוחח כעת עם הסוכן מאומת או לא. |
משתנים לאימות ידני עם Microsoft Entra ID
המשתנים הבאים זמינים עבור סוכנים שתצורתם נקבעה לשימוש בספקי השירות של Microsoft Entra ID (לשעבר Azure Active Directory).
| Name | סוג | הגדרה |
|---|---|---|
| User.AccessToken | מחרוזת | אסימון הגישה עבור המשתמש המ מאמת עם הסוכן. |
| שםתצוגתמשתמש | מחרוזת | שם התצוגה של המשתמש המשוחח כעת עם הסוכן. |
| משתמש.אימייל | מחרוזת | כתובת הדואר האלקטרוני של המשתמש המשוחחת כעת עם הסוכן. |
| [שם משתמש.שם פרטי] | מחרוזת | השם הפרטי של המשתמש המשוחח כעת עם הסוכן. |
| User.Id | מחרוזת | המזהה הייחודי של המשתמש המשוחח כעת עם הסוכן. |
| User.IsLoggedIn | בוליאני | דגל בוליאני המייצג אם המשתמש המשוחח כעת עם הסוכן מאומת או לא. |
| User.LastName | מחרוזת | שם המשפחה של המשתמש המשוחח כעת עם הסוכן. |
| User.PrincipalName | מחרוזת | השם הראשי של המשתמש המשוחח כעת עם הסוכן. |