יצירת ביטויים באמצעות Power Fx

הערה

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

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

הערה

נוסחאות Power Fx ב-Copilot Studio משתמשות במספור בסגנון אמריקאי. לדוגמה, המפריד העשרוני הוא נקודה או נקודה, כמו ב- 12,567.892. משמעות הדבר היא כי עליך להשתמש בפסיקים (,) כמפרידי פרמטרים עבור נוסחאות Power Fx שלך.

‏‫דרישות מוקדמות‬

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

שימוש במשתנים בנוסחה

כדי להשתמש במשתנה בנוסחת Power Fx, עליך להוסיף קידומת ל שמו כדי לציין את טווח המשתנה:

• עבור משתני מערכת, השתמש System.
• עבור משתנים כלליים, השתמש ב- Global.
• עבור משתני נושא, השתמש Topic.
• עבור משתני סביבה, השתמש ב- Environment.

לדוגמה, כדי להשתמש במשתנה המערכת Conversation.Id בנוסחה, עיין במשתנה המערכת בתור System.Conversation.Id.

שימוש בערךים ליטרליים בנוסחה

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

סוג	דוגמאות עיצוב
מחרוזת	"hi", , "hello world!""copilot"
בוליאני	רק true או false
מספר	1, , 532, 5.258-9201
רשומה וטבלה	[1], [45, 8, 2], ["cats", "dogs"], { id: 1 }, , { message: "hello" }{ name: "John", info: { age: 25, weight: 175 } }
תאריך ושעה	Time(5,0,23), , Date(2022,5,24)DateTimeValue("May 10, 2022 5:00:00 PM")
בחירה	לא נתמך
ריק	רק Blank()

נוסחאות נפוצות של Power Fx

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

סוג	נוסחאות Power Fx
מחרוזת	הפונקציה Text Concat ופונקציית שרשור הפונקציה Len הפונקציות Lower, Upper ו- Proper הפונקציות IsMatch, Match ו- MatchAll הפונקציות EndsWith ו- StartsWith הפונקציה Find הפונקציה Replace ו- Substitute
בוליאני	פונקציה בוליאנית הפונקציות And, Or ו- Not הפונקציות If ו- Switch
מספר	הפונקציות Decimal, Float ו- Value הפונקציות Int, Round, RoundDown, RoundUp ו- Trunc
רשומה וטבלה	Concat ופונקציית שרשור הפונקציות Count, CountA, CountIf ו- CountRows הפונקציה ForAll הפונקציות First, FirstN, Index, Last ו- LastN פונקציות סינון, חיפוש וחיפוש הפונקציה JSON ParseJSON (הפונקציה ParseJSON)
תאריך ושעה	הפונקציות Date, DateTime ו- Time הפונקציות DateValue, TimeValue ו- DateTimeValue הפונקציות Day, Month, Year, Hour, Minute, Second ו- Weekday כעת, היום, IsToday, UTCNow, UTCToday, הפונקציות IsUTCToday הפונקציות DateAdd, DateDiff ו- TimeZoneOffset הפונקציה Text
ריק	פונקציות ריקות, מתמזגות, IsBlank ו- IsEmpty Error, IfError, IsError, IsBlankOrError פונקציות

שימוש ב- Power Fx כדי להגדיר משתנה

בדוגמה זו, ביטוי Power Fx מאחסן ופלט את שם הלקוח באותיות רישיות.

1. צור נושא והוסף שאלה קֶשֶׁר.

2. עבור הזן הודעה, הזן "מהו שמך?".

3. תחת זהה, בחר את שם האדם.

4. בחר את התיבה תחת שמור תגובת משתמש בשם ולאחר מכן בחר את המשתנה Var1 ותן לו שם customerName.

5. תחת הצומת שאלה, בחר + ולאחר מכן בחר הגדר ערך משתנה.

6. בחר את התיבה תחת הגדר משתנה ולאחר מכן בחר צור חדש ותן לה שם capsName.

7. בתיבת ה-ערך ל, בחר את החץ > ולאחר מכן בחר בכרטיסייה נוסחאות.

8. בתיבה fx , הזן ולאחר Upper(Text(Topic.customerName))מכן בחר הוסף.

   

9. תחת הצומת שאלה, בחר + ולאחר מכן בחר שלח הודעה.

10. הזן "HELLO", בחר {x} ולאחר מכן בחר capsName.

    

שימוש בנוסחת Power Fx כתנאי

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

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

1. צור נושא והוסף שאלה קֶשֶׁר.

2. עבור הזן הודעה, הזן "תאריך הזמנה?".

3. תחת זהה, בחר את התאריך והשעה של הישות.

4. בחר את התיבה תחת שמור תגובת משתמש בשם ולאחר מכן בחר את המשתנה Var1 ותן לו שם bookingDate.

   

5. בחר את סמל הוסף צומת מתחת לצומת שאלה ולאחר מכן בחר הוסף תנאי.

6. בחר את שלוש הנקודות (...) של צומת התנאי ולאחר מכן בחר שנה לנוסחה.

7. בתיבה פונקציה , בחר את החץ > ולאחר מכן בחר את הכרטיסיה נוסחה .

8. החלף את התוכן של תיבת fx בנוסחה ולאחר Topic.bookingDate > (DateAdd (Now(), 14))מכן בחר הוסף.

9. תחת הצומת תנאי , הוסף צומת הודעה והזן את ההודעה "אתה זכאי להנחה".

10. תחת הצומת כל התנאים האחרים, הוסף צומת הודעה והזן את ההודעה "מצטערים, אינך זכאי להנחה".