Creare espressioni utilizzando Power Fx

Power Fx è un linguaggio con poco codice che utilizza formule simili a Excel. Usa Power Fx per creare una logica complessa che consente agli agenti di manipolare i dati. Ad esempio, una formula Power Fx può impostare il valore di una variabile, analizzare una stringa o utilizzare un'espressione in una condizione. Per altre informazioni, vedi la panoramica di Power Fx e il riferimento della formula.

Nota

Le formule Power Fx in Copilot Studio utilizzano la numerazione in stile US. Vale a dire che il separatore decimale è un punto, come in 12,567.892. Questo significa che i parametri Power Fx devono essere separati da virgole (,).

Prerequisiti

• Creare e modificare argomenti
• Panoramica delle variabili

Usare le variabili in una formula

Per usare una variabile in una formula Power Fx, è necessario aggiungere un prefisso al nome per indicare l'ambito della variabile:

• Per le variabili di sistema, utilizza System.
• Per le variabili globali, utilizza Global.
• Per le variabili di argomento, utilizza Topic.

Ad esempio, per utilizzare la variabile di sistema Conversation.Id in una formula, fai riferimento alla variabile di sistema come System.Conversation.Id.

Utilizzare valori letterali in una formula

Oltre a utilizzare le variabili in una formula Power Fx, puoi inserire valori letterali. Per utilizzare un valore letterale in una formula, devi immetterlo nel formato che corrisponde al suo tipo. La tabella seguente elenca i tipi di dati e il formato dei valori letterali corrispondenti.

Type	Esempi di formato
String	"hi", "hello world!", "copilot"
Boolean	Solo true o false
Numero	1, 532, 5.258,-9201
Record e tabella	[1], [45, 8, 2], ["cats", "dogs"], { id: 1 }, { message: "hello" }, { name: "John", info: { age: 25, weight: 175 } }
Data/Ora	Time(5,0,23), Date(2022,5,24), DateTimeValue("May 10, 2022 5:00:00 PM")
Choice	Non supportato
Vuoto	Solo Blank()

Formule comuni di Power Fx

La tabella seguente elenca i tipi di dati e le formule Power Fx corrispondenti da usare con quel tipo di dati.

Type	Formule Power Fx
String	Funzione Text Funzioni Concat e Concatenate Funzione Len Funzioni Lower, Upper e Proper Funzioni IsMatch, Match e MatchAll Funzioni EndsWith e StartsWith Funzione Find Funzione Replace e Substitute
Boolean	Funzione Boolean Funzioni And, Or e Not Funzioni If e Switch
Numero	Funzioni Decimale, Float e Valore Funzioni Int, Round, RoundDown, RoundUp e Trun
Record e tabella	Funzioni Concat e Concatenate Funzioni Count, CountA, CountIf e CountRows Funzione ForAll Funzioni First, FirstN, Index, Last, e LastN Funzioni Filter, Search e LookUp Funzione JSON Funzione ParseJSON
Data/Ora	Funzioni Date, DateTime e Time Funzioni DateValue, TimeValue e DateTimeValue Funzioni Day, Month, Year, Hour, Minute, Second e Weekday Funzioni Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday Funzioni DateAdd, DateDiff e TimeZoneOffset Funzione Text
Vuoto	Funzioni Blank, Coalesce, IsBlank e IsEmpty Funzioni Error, IfError, IsError, IsBlankOrError

Utilizzare Power Fx per impostare una variabile

In questo esempio, un'espressione Power Fx memorizza e restituisce il nome del cliente in lettere maiuscole.

1. Crea un argomento e aggiungi un nodo Domanda.

2. Per Immetti un messaggio, digita "Qual è il tuo nome?"

3. In Identifica, seleziona l'entità Nome persona.

4. Seleziona la casella in Salva risposta come, quindi seleziona la variabile Var1 e denominala customerName.

5. Nel nodo Domanda, seleziona + e quindi seleziona Imposta un valore della variabile.

6. Seleziona la casella in Imposta variabile, quindi seleziona Crea nuovo e denominala capsName.

7. Nella casella A valore , seleziona la freccia>, quindi seleziona la scheda Formula.

8. Nella casella fx, immetti Upper(Text(Topic.customerName)), quindi seleziona Inserisci.

   

9. Nel nodo Domanda, seleziona + e scegli Invia un messaggio.

10. Inserisci "HELLO", seleziona {x}, quindi seleziona capsName.

    

Utilizza una formula Power Fx come condizione

Per valutare espressioni più complesse, configura i nodi Condizione in modo utilizzare formule Power Fx.

In questo esempio, l'agente determina se una data di prenotazione dà diritto a uno sconto. Per fare ciò, controlla se la data di prenotazione fornita dal cliente è di 14 giorni o più dalla data corrente.

1. Crea un argomento e aggiungi un nodo Domanda.

2. Per Immetti un messaggio, inserisci "Data di prenotazione?".

3. In Identifica, seleziona l'entità Data e ora.

4. Seleziona la casella in Salva risposta come, quindi seleziona la variabile Var1 e denominala bookingDate.

   

5. Seleziona l'icona Aggiungi nodo sotto il nodo Domanda e seleziona Aggiungi una condizione.

6. Seleziona l'icona Altro (…) del nodo Condizione , quindi seleziona Cambia in formula.

7. Nella casella Funziona , seleziona la freccia>, quindi seleziona la scheda Formula.

8. Sostituisci il contenuto della casella fx con la formula Topic.bookingDate > (DateAdd (Now(), 14)), quindi seleziona Inserisci.

9. Nel nodo Condizione, aggiungi un nodo Messaggio e inserisci il messaggio "Hai diritto a uno sconto".

10. Nel nodo Tutte le altre condizioni, aggiungi un nodo Messaggio e inserisci il messaggio "Siamo spiacenti, non hai diritto allo sconto".