Vytvoření výrazů pomocí Power Fx

Power Fx je jazyk s minimem kódu, který používá podobné vzorce jako Excel. Pomocí Power Fx můžete vytvářet komplexní logiku, která vašim agentům umožní manipulovat s daty. Vzorec Power Fx může například nastavit hodnotu proměnné, analyzovat řetězec nebo použít výraz v podmínce. Další informace viz Přehled jazyka Power Fx a informace o vzorcích.

Poznámka:

Vzorce Power Fx v Copilot Studio používají číslování v americkém stylu. To znamená, že oddělovač desetinných míst je tečka, jako v 12,567.892. To také znamená, že parametry Power Fx musí být odděleny čárkami (,).

Předpoklady

• Vytváření a úprava témat
• Přehled proměnných

Použití proměnných ve vzorci

Chcete-li použít proměnnou ve vzorci Power Fx, musíte přidat předponu k jeho názvu, abyste označili rozsah proměnné:

• Pro systémové proměnné použijte System.
• Pro globální proměnné použijte Global.
• Pro proměnné tématu použijte Topic.

Chcete-li například do vzorce zahrnout systémovou proměnnou Conversation.Id, odkazujte na ni jako System.Conversation.Id.

Použití hodnot literálů ve vzorci

Kromě použití proměnných ve vzorci Power Fx můžete zadat hodnoty literálů. Chcete-li použít hodnotu literálu ve vzorci, musíte ji zadat ve formátu, který odpovídá správnému typu. V následující tabulce jsou uvedeny typy dat a formát jejich odpovídajících hodnot literálů.

Type	Příklady formátu
Řetězcové	"hi", "hello world!", "copilot"
Logické	Pouze true nebo false
Počet	1, 532, 5.258,-9201
Záznam a tabulka	[1], [45, 8, 2], ["cats", "dogs"], { id: 1 }, { message: "hello" }, { name: "John", info: { age: 25, weight: 175 } }
DateTime	Time(5,0,23), Date(2022,5,24), DateTimeValue("May 10, 2022 5:00:00 PM")
Výběr	Nepodporováno
prázdnou	Pouze Blank()

Běžné vzorce Power Fx

V následující tabulce jsou uvedeny datové typy a odpovídající vzorce Power Fx, které se mají s daným datovým typem použít.

Type	Vzorce Power Fx
Řetězcové	Funkce Text Funkce Concat a Concatenate Funkce Len Funkce Lower, Upper a Proper Funkce IsMatch, Match a MatchAll Funkce EndsWith a StartsWith Funkce Find Funkce Replace a Substitute
Logické	Funkce Boolean Funkce And, Or a Not Funkce If a Switch
Počet	Funkce Decimal, Float a Value Funkce Int, Round, RoundDown, RoundUp a Trun
Záznam a tabulka	Funkce Concat a Concatenate Funkce Count, CountA, CountIf a CountRows Funkce ForAll Funkce First, FirstN, Index, Last a LastN Funkce Filter, Search a LookUp Funkce JSON Funkce ParseJSON
DateTime	Funkce Date, DateTime a Time Funkce DateValue, TimeValue a DateTimeValue Funkce Day, Month, Year, Hour, Minute, Second a Weekday Funkce Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday Funkce DateAdd, DateDiff a TimeZoneOffset Funkce Text
prázdnou	Funkce Blank, Coalesce, IsBlank a IsEmpty Funkce Error, IfError, IsError, IsBlankOrError

Použití Power Fx k nastavení proměnné

V tomto příkladu výraz Power Fx ukládá a vypisuje jméno zákazníka velkými písmeny.

1. Vytvořte téma a přidejte uzel Otázka.

2. Do pole Zadejte zprávu zadejte „Jak se jmenujete?“.

3. V části Identifikace vyberte entitu Jméno osoby.

4. Vyberte zaškrtávací políčko v části Uložit odpověď jako a poté vyberte proměnnou Var1 a pojmenujte ji customerName.

5. V uzlu Otázka vyberte + a pak vyberte Nastavit hodnotu proměnné.

6. Vyberte pole v sekci Nastavit proměnnou a poté vyberte Vytvořit novou a pojmenujte ji capsName.

7. V poli Hodnota Do vyberte šipku > a poté vyberte kartu Vzorec.

8. Do pole fx zadejte Upper(Text(Topic.customerName)) a vyberte Vložit.

   

9. V uzlu Otázka vyberte + a poté vyberte Odeslat zprávu.

10. Zadejte „DOBRÝ DEN", vyberte {x} a potom vyberte capsName.

    

Použití vzorce Power Fx jako podmínky

Chcete-li vyhodnotit složitější výrazy, nastavte uzly Podmínka pro použití vzorců Power Fx.

V tomto příkladu agent určuje, zda má datum rezervace nárok na slevu. Za tímto účelem zkontroluje, zda datum rezervace poskytnuté zákazníkem je 14 dní nebo více od aktuálního data.

1. Vytvořte téma a přidejte uzel Otázka.

2. Do pole Zadejte zprávu zadejte „Datum rezervace?“.

3. V části Identifikace vyberte entitu Datum a čas.

4. Vyberte zaškrtávací políčko v části Uložit odpověď jako a poté vyberte proměnnou Var1 a pojmenujte ji bookingDate.

   

5. Vyberte ikonu Přidat uzel pod uzlem Otázka a poté vyberte Přidat podmínku.

6. V uzlu Podmínka vyberte ikonu Další (…) pak vyberte Změnit na vzorec.

7. V poli Funkce vyberte šipku > a poté vyberte kartu Vzorec.

8. Nahraďte obsah pole fx vzorcem Topic.bookingDate > (DateAdd (Now(), 14)) a poté vyberte Vložit.

9. Pod uzlem Podmínka přidejte uzel Zpráva a zadejte zprávu „Máte nárok na slevu“.

10. Pod uzlem Všechny ostatní podmínky přidejte uzel Zpráva a zadejte zprávu „Bohužel nemáte nárok na slevu“.