Creare espressioni utilizzando Power Fx

Importante

Le capacità e funzionalità di Power Virtual Agents ora fanno parte di Microsoft Copilot Studio a seguito di investimenti significativi nell'intelligenza artificiale generativa e integrazioni migliorate in Microsoft Copilot.

Alcuni articoli e schermate potrebbero fare riferimento a Power Virtual Agents durante l'aggiornamento della documentazione e dei contenuti per il training.

Power Fx è un linguaggio con poco codice che utilizza formule simili a Excel. Utilizza Power Fx per creare una logica complessa che consenta ai tuoi copiloti 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 Microsoft 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
• Utilizzare 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, devi fare riferimento ad esso 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"
Booleano	Solo true o false
Numero	1, 532, 5.258, -9201
Table	[1], [45, 8, 2], ["cats", "dogs"]
Registra	{ 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()

Utilizzare Power Fx per impostare una variabile

In questo esempio, verrà utilizzata un'espressione Power Fx per archiviare il nome del cliente e restituirlo in lettere maiuscole.

1. Crea un argomento e aggiungi un nodo Domanda.

2. Per Immetti un messaggio, immetti What is your name?.

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. Immetti 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, il copilota determina se una data di prenotazione è idonea per 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, immetti Booking date?.

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 +, quindi seleziona Aggiungi una condizione.

6. Nel nodo Condizione, select the menu Nodo (⋮), quindi seleziona Modifica 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 Invia un messaggio e immetti il messaggio You qualify for a discount.

10. Nel nodo Tutte le altre condizioni, aggiungi un nodo Invia un messaggio e immetti il messaggio Sorry, you don't qualify for a discount.