Share via

Créer des expressions avec Power Fx

  • Article

Important

Les capacités et les fonctionnalités de Power Virtual Agents font maintenant partie de Microsoft Copilot Studio, suite à des investissements significatifs dans l’IA générative et des intégrations améliorées dans Microsoft Copilot.

Certains articles et captures d’écran peuvent faire référence à Power Virtual Agents pendant que nous mettons à jour la documentation et le contenu de la formation.

Power Fx est un langage low-code qui utilise des formules de type Excel. Utiliser Power Fx pour créer une logique complexe qui permet à vos copilotes de manipuler les données. Par exemple, une formule Power Fx peut définir la valeur d’une variable, analyser une chaîne ou utiliser une expression dans une condition. Pour en savoir plus, voir la Vue d’ensemble Power Fx et la référence sur les formules.

Note

Les formules Power Fx dans Microsoft Copilot Studio utilisent une numérotation au format américain. Autrement dit, le séparateur décimal est un point, comme dans 12,567.892. Autrement dit, les paramètres Power Fx doivent être séparés par des virgules (,).

Conditions préalables

Utiliser des variables dans une formule

Pour utiliser une variable dans une formule Power Fx, vous devez ajouter un préfixe à son nom pour indiquer l‘étendue de la variable :

Par exemple, pour utiliser la variable système Conversation.Id dans une formule, vous devez y faire référence comme System.Conversation.Id.

Capture d’écran du volet Entrer une formule avec une expression contenant une variable système.

Utiliser des valeurs littérales dans une formule

En plus d’utiliser des variables dans une formule Power Fx, vous pouvez saisir des valeurs littérales. Pour utiliser une valeur littérale dans une formule, vous devez saisir la valeur dans le format correspondant à son type : Le tableau suivant répertorie les types de données et le format de leurs valeurs littérales correspondantes.

Type Exemples de format
String "hi", "hello world!", "copilot"
Entier Uniquement true ou false
Chiffre 1, 532, 5.258, -9201
Table [1], [45, 8, 2], ["cats", "dogs"]
Enregistrer { id: 1 }, { message: "hello" }, { name: "John", info: { age: 25, weight: 175 } }
DateHeure Time(5,0,23), Date(2022,5,24), DateTimeValue("May 10, 2022 5:00:00 PM")
Option Non pris en charge
Vide Uniquement Blank()

Utiliser Power Fx pour définir une variable

Dans cet exemple, nous utilisons une expression Power Fx pour stocker le nom du client et le sortir en majuscules.

  1. Créez une rubrique et ajoutez un nœud Question.

  2. Pour Entrer un message, saisissez What is your name?.

  3. Sous Identifier, sélectionnez l’entité Nom de la personne.

  4. Sélectionnez la zone sous Enregistrer la réponse sous, puis sélectionnez la variable Var1 et nommez-la customerName.

    Capture d’écran d’un nœud Question avec une variable nommée Var1 mise en évidence.

  5. Sous le nœud Question, sélectionnez +, puis Définir une valeur de variable.

  6. Sélectionnez la zone sous Définir la variable, puis sélectionnez Créer et nommez-la capsName.

  7. Dans la zone Vers la valeur, sélectionnez la flèche >, puis sélectionnez l’onglet Formule.

  8. Dans la zone fx, saisissez Upper(Text(Topic.customerName)), puis sélectionnez Insérer.

    Capture d’écran d’une formule Power Fx dans un nœud Définir une variable avec l’onglet Formule en surbrillance.

  9. Sous le nœud Question, sélectionnez +, puis Envoyer un message.

  10. Entrez HELLO , sélectionnez {x}, puis capsName.

    Capture d’écran du nœud Envoyer un message avec un message défini.

Utiliser une formule Power Fx comme condition

Pour évaluer des expressions plus complexes, configurez les nœuds Condition pour utiliser les formules Power Fx.

Dans cet exemple, le copilote détermine si une date de réservation donne droit à une réduction. Pour ce faire, il vérifie si la date de réservation fournie par le client est de 14 jours ou plus à partir de la date actuelle.

  1. Créez une rubrique et ajoutez un nœud Question.

  2. Pour Entrer un message, saisissez Booking date?.

  3. Sous Identifier, sélectionnez l’entité Date et heure.

  4. Sélectionnez la zone sous Enregistrer la réponse sous, puis sélectionnez la variable Var1 et nommez-la bookingDate.

    Capture d’écran d’un nœud de Question avec une entité de date et d’heure choisie et une variable définie.

  5. Sélectionnez l’icône +, puis choisissez Ajouter une condition.

  6. Dans le nְœud Condition, sélectionnez Menu du nœud (⋮), puis sélectionnez Modifier dans la formule.

    Capture d’écran d’un nœud Condition avec l’icône du Menu du nœud et Changer en formule en surbrillance.

  7. Dans la zone Fonction, sélectionnez la flèche >, puis sélectionnez l’onglet Formule.

  8. Remplacez le contenu de la zone fx par la formule Topic.bookingDate > (DateAdd (Now(), 14)), puis sélectionnez Insérer.

  9. Sous le nœud Condition, ajoutez un nœud Envoyer un message et saisissez le message You qualify for a discount.

  10. Sous le nœud Toutes les autres conditions, ajoutez un nœud Envoyer un message et saisissez le message Sorry, you don't qualify for a discount.

    Capture d’écran des nœuds de Message dans un nœud de Condition.