Utiliser des variables

Vous pouvez utiliser des variables pour enregistrer les réponses des clients et réutiliser leur contenu plus tard dans la conversation.

Vous pouvez aussi utiliser des variables pour créer des expressions logiques qui dirigent dynamiquement le client vers différents chemins de conversation. Par exemple, enregistrez le nom d’un client dans une variable appelée UserName et le copilote peut s’adresser au client par son nom pendant que la conversation se poursuit.

Les variables peuvent également être transmises dans d’autres rubriques et flux Power Automate.

Application Web

Les variables peuvent exister à quatre niveaux ou portées :

• Les variables rubrique ne peuvent être utilisées que dans les rubriques dans lesquelles elles sont créées. Il s’agit de la portée par défaut pour les variables que vous créez.
• Les variables globales peuvent être utilisées dans toutes les rubriques. Vous pouvez modifier la portée d’une variable de rubrique pour en faire une variable globale.
• Les variables système sont créées automatiquement avec votre copilote. Elles fournissent des informations plus contextuelles sur la conversation ou l’utilisateur. Elles sont disponibles dans toutes les rubriques.
• Les variables environnement sont créées dans Power Platform et sont en lecture seule dans Copilot Studio. Elles stockent les clés et les valeurs des paramètres, qui servent ensuite d’entrée à divers autres objets de l’application, y compris Copilot Studio. La séparation des paramètres des objets qui les consomment vous permet de modifier les valeurs dans le même environnement ou lorsque vous migrez des solutions vers d’autres environnements. L’alternative consiste à laisser les valeurs des paramètres codées en dur dans les composants qui les utilisent.

Types de variable

Une variable est associée à un type de base. Le type détermine les valeurs que la variable peut contenir et les opérateurs que vous pouvez utiliser lors de la construction d’une expression logique avec la variable correspondante.

Type	Description
Chaîne	Séquence de caractères utilisés pour représenter du texte
Booléen	Valeur logique qui ne peut être que true ou false
Nombre	Tout nombre réel
Table	Liste de valeurs, mais toutes les valeurs doivent être du même type
Enregistrement	Collection de paires nom-valeur où les valeurs peuvent être de n’importe quel type
DateHeure	Date, heure, jour de la semaine ou mois par rapport à un moment donné
Option	Une liste de valeurs de chaîne avec des synonymes associés
Vide	Un espace réservé pour « aucune valeur » ou « valeur inconnue » ; pour plus d’informations, voir Vides dans Power Fx

Le type d’une variable est défini la première fois qu’une valeur est affectée. Après cela, le type de cette variable est fixe et des valeurs d’un autre type ne peuvent pas lui être affectées. Par exemple, le type Nombre est affecté à une variable avec la valeur de début 1. Toute tentative d’affectation à une valeur de Chaîne de "apples" entraîne une erreur.

Lorsque vous testez un copilote, une variable peut apparaître temporairement comme étant de type inconnu. Une valeur n’a pas encore été affectée à une variable inconnue.

L’ordre des variables est déterminé de haut en bas du canevas de création. Les nœuds en haut du canevas de création sont pris en compte avant les nœuds en bas.

Lorsque vous créez des branches avec des nœuds Condition , les branches sont triées de gauche à droite. Les nœuds de la branche la plus à gauche sont considérés avant les nœuds de la branche la plus à droite.

Entités

Copilot Studio utilise des entités pour comprendre et identifier un type spécifique d’information dans les réponses d’un utilisateur. Les informations identifiées sont enregistrées dans une variable du type approprié pour les informations. Le tableau suivant répertorie le type de base de variable associé aux entités prédéfinies.

Entity	Type de base de variable
Options à choix multiples	Option
Réponse complète de l’utilisateur	Chaîne
Âge	Nombre
Booléen	Booléen
Ville	Chaîne
Color	Chaîne
Continent	Chaîne
Pays ou région	Chaîne
Date et heure	DateHeure
E-mail	Chaîne
Événement	Chaîne
Entier	Entier
Langue	Chaîne
Money	Nombre
Nombre	Nombre
Ordinal	Nombre
Organisation	Chaîne
Pourcentage	Nombre
Nom de la personne	Chaîne
Numéro de téléphone	Chaîne
Point d’intérêt	Chaîne
Vitesse	Nombre
État	Chaîne
Adresse postale	Chaîne
Température	Nombre
URL	Chaîne
Poids	Nombre
Code postal	Chaîne
Entité personnalisée	Option

Créer une variable

Tout nœud qui vous invite à sélectionner une variable comme sortie, telle que le nœud Question, crée automatiquement une variable de sortie de type approprié.

Astuce

Renommez les nœuds pour les identifier plus facilement. Sélectionnez le champ de nom du nœud pour mettre à jour le nom directement, ou sélectionnez l’icône Plus (…) du nœud et sélectionnez Renommer dans le menu. Vous pouvez également renommer les nœuds dans l’éditeur de code .

Il n’est pas possible de renommer les nœuds Sélectionner et d’accéder aux nœuds étape .

Les noms de nœud peuvent comporter jusqu’à 500 caractères.

Choisir une entité à utiliser

Les nœuds de question sont créés avec des options à choix multiples par défaut. Pour utiliser une entité prédéfinie ou personnalisée différente, cochez la case Identifier et choisissez le type d’informations que le copilote doit écouter.

Renommer une variable

Les variables reçoivent automatiquement un nom lors de leur création. Une pratique recommandée consiste à donner à vos variables des noms significatifs pour que leur objectif soit clair à toute autre personne qui doit maintenir votre copilote.

1. Sélectionnez la variable pour l’ouvrir dans le volet Propriétés de la variable.

2. Sous Nom de la variable, entrez un nouveau nom pour votre variable.

Définir une variable

En général, vous utilisez un nœud Question pour enregistrer la saisie utilisateur dans une variable. Il peut toutefois y avoir des situations dans lesquelles vous souhaitez définir la valeur vous-même. Dans ces cas, utilisez un nœud Définir la valeur de la variable.

1. Sélectionnez Ajouter un nœud (+) pour ajouter un nœud, puis sélectionnez Gestion des variables>Définir une valeur de variable.

2. Sélectionnez la zone sous Définir la variable, puis sélectionnez Créer une variable.

   

   Une variable est créée. Son type est inconnu jusqu’à ce que vous lui attribuiez une valeur.

   

3. Pour Valeur de fin, affectez une valeur en utilisant l’une des options suivantes :

   • Saisissez une valeur littérale.
   • Sélectionnez une variable existante du même type. Cette action définit votre variable sur la même valeur que la variable que vous sélectionnez.
   • Utilisez une formule Power Fx. Les formules Power Fx sont utiles pour les types plus complexes, où les valeurs littérales ne peuvent pas être utilisées, comme les types Table et Enregistrement.

Note

Lors de la définition d’une variable de type chaîne, si vous rencontrez une incompatibilité entre Définir la variable et Vers la valeur, un message d’erreur et le bouton Corriger l’incompatibilité de type apparaissent. Sélectionner le bouton pour générer automatiquement une formule qui résout l’incompatibilité. Copilot Studio Power Fx

Utiliser des valeurs littérales

Au lieu de sélectionner une valeur de variable, vous pouvez saisir une valeur littérale dans une variable.

Le nœud tente d’interpréter les valeurs littérales comme une chaîne, un nombre ou une valeur booléenne. Par exemple, 123 est interprété comme un nombre. Si vous voulez que cela soit interprété plutôt comme une valeur de chaîne, vous pouvez entourer cette valeur de guillemets doubles, comme "123".

Pour certains scénarios, ou lorsque vous utilisez des types plus complexes, utilisez une formule Power Fx pour définir un type spécifique.

Volet Variables

Le volet Variables vous permet d’afficher toutes les variables disponibles dans la rubrique, quels que soient les nœuds dans lesquels elles sont définies ou utilisées. Pour chaque variable, vous pouvez choisir si elle peut recevoir sa valeur d’autres rubriques, renvoyer sa valeur à d’autres rubriques, ou les deux. Vous pouvez également sélectionner une variable pour modifier ses propriétés dans le volet Propriétés de la variable.

Pour ouvrir le volet Variables, dans la barre de menus de la rubrique, sélectionnez Variables.

Volet des propriétés des variables

Dans le volet Propriétés des variables, vous pouvez renommer une variable, voir où une variable est utilisée ou convertir une variable en variable globale. Cependant, vous ne pouvez pas la reconvertir d’une variable globale en une variable de rubrique. Vous pouvez également choisir si elle peut recevoir des valeurs ou transmettre sa valeur à d’autres rubriques.

Pour ouvrir le volet Propriétés de la variable, sélectionnez une variable dans le volet Variables. Vous pouvez également ouvrir le volet Propriétés des variables en sélectionnant une variable dans un nœud.

Variables d’environnement

Les variables environnement sont un Power Platform concept. Les variables d’environnement activent le scénario de gestion du cycle de vie des applications (ALM) de base pour déplacer une application entre les environnements Power Platform. Dans ce scénario, l’application reste exactement la même, à l’exception de quelques références externes clés qui sont différentes entre l’environnement source et l’environnement de destination.

Utilisez les variables d’environnement de la même manière que les variables de rubrique, globales et système. Une différence notable est que vous ne pouvez utiliser les variables d’environnement qu’en mode lecture seule. Les auteurs de Copilot ne peuvent pas modifier la variable d’environnement dans Copilot Studio. Cependant, les administrateurs peuvent modifier la valeur des variables d’environnement dans le portail PowerApps.

Les types de variables d’environnement dans Copilot Studio sont mappés aux types de données PowerApps, comme suit :

Type dans Copilot Studio	Type dans PowerApps
Nombre décimal	Nombre
JSON	Détectez le type à partir de la valeur. Si non, Json => Non spécifié (erreur de validation)
Texte	chaîne
Oui/Non	Valeur booléenne
Source de données	chaîne
Secret	Chaîne

Note

Les erreurs des variables d’environnement sont visibles dans la conversation instantanée de Test et lors de la publication. Cependant, ces erreurs ne sont pas affichées dans la liste Rubrique, car ce ne sont pas des variables de rubrique.

Vous ne pouvez ni créer ni modifier des variables d’environnement dans Copilot Studio. Vous devez utiliser le portail PowerApps pour modifier ou définir des variables d’environnement. Depuis Copilot Studio, vous pouvez utiliser le volet Variables pour voir les informations sur une variable d’environnement. Le volet Variables dispose également d’un lien vers l’expérience de création native.

Utiliser les variables d’environnement pour les secrets Azure Key Vault

Une variable d’environnement peut référencer un secret dans Key Vault. Il s’agit d’un cas particulier de variables d’environnement avec des considérations uniques.

Pour créer une variable d’environnement secrète dans le portail PowerApps, vous devez configurer son Key Vault.

Outre la configuration ci-dessus, vous devez effectuer les actions suivantes pour autoriser Copilot Studio à lire ce Key Vault :

1. Attribuez le rôle Key Vault Secrets User à l’application Microsoft Virtual Agents Service.

2. Pour autoriser tous les copilotes de l’environnement à accéder au secret, créez une balise AllowedEnvironments dans le secret et ajoutez les ID des environnements autorisés séparés par une virgule.

3. Pour autoriser uniquement des copilotes spécifiques de l’environnement à utiliser ce Key Vault, créez une balise AllowedCopilots et mettez l’identifiant du copilote au format {envId}/{schemaName}. Pour plusieurs valeurs, séparez les valeurs avec des virgules.

Si vous atteignez le nombre maximum de caractères mais que vous devez encore ajouter d’autres copilotes, ajoutez une autre balise avec un nom descriptif mais unique (par exemple : AllowedCopilots2).

La valeur secrète est mise en cache lors de l’exécution de la boîte de dialogue pendant cinq minutes. Les lectures ayant échoué sont mises en cache pendant 30 secondes.

Avertissement 

En ajoutant le secret dans le copilote, vous pouvez exposer la valeur de ce secret à tous les utilisateurs qui peuvent modifier le copilote dans l’environnement, car ces utilisateurs peuvent modifier le copilote pour renvoyer la valeur dans le nœud SendMessage.

Variables système

Chaque copilote est fourni avec des variables système intégrées qui fournissent des informations supplémentaires sur une conversation.

Note

Pour plus d’informations sur les variables de copilote activées pour la voix, voir Utiliser les variables vocales.

Toutes les variables système ne sont pas affichées dans la liste. Vous devez accéder à ces variables système cachées avec une formule Power Fx.

Pour utiliser des variables système dans une formule Power Fx, vous devez ajouter System. avant le nom de la variable. Par exemple, pour inclure la variable système User.DisplayName dans une formule, faites-y référence en tant que System.User.DisplayName.

Nom	Type	Définition
Activity.Attachments	table	Les pièces jointes fournies par l’utilisateur
Activity.Channel	option	ID de canal de la conversation actuelle
Activity.ChannelData	tous	Objet contenant du contenu spécifique au canal
Activity.ChannelId	chaîne	ID de canal de la conversation actuelle, sous forme de chaîne
Activity.From.Id	chaîne	ID unique spécifique au canal pour l’expéditeur
Activity.From.Name	chaîne	Nom convivial spécifique au canal de l’expéditeur
Activity.Name	chaîne	Nom de l’événement
Activity.Recipient.Id	chaîne	Propriété type d’activité entrante.
Activity.Recipient.Name	chaîne	Représente le nom d’affichage du copilote dans le canal. Dans le contexte d’un canal de téléphonie, la valeur de cette variable sera le numéro de téléphone auquel est rattaché le copilote.
Activity.Text	chaîne	Message le plus récent envoyé par l’utilisateur
Activity.Type	option	Type d’activité
Activity.TypeId	chaîne	Type d’activité, sous forme de chaîne
Activity.Value	tous	Valeur ouverte
Bot.EnvironmentId	chaîne	ID d’environnement du copilote
Bot.Id	chaîne	ID du copilote
Bot.Name	chaîne	Nom de votre copilote
Bot.SchemaName	chaîne	Nom du schéma du copilote
Bot.TenantId	chaîne	ID de locataire du copilote
ClientPluginActions	option	Collection d’actions de plug-in client dynamique à prendre en compte pour les actions génératives
Conversation.Id	chaîne	ID unique de la conversation actuelle
Conversation.InTestMode	Booléen	Drapeau booléen qui indique si la conversation se déroule dans le canevas de test
Conversation.LocalTimeZone	chaîne	Nom du fuseau horaire à utiliser par l’utilisateur dans le format de base de données des fuseaux horaires IANA
Conversation.LocalTimeZoneOffset	DateHeure	Décalage horaire par rapport à l’UTC pour le fuseau horaire local actuel
Error.Code	chaîne	Code d’erreur pour l’erreur actuelle. Remarque : Cette variable n’est prise en charge que si Gâchette est On Error.
Error.Message	chaîne	Message d’erreur pour l’erreur actuelle. Remarque : Cette variable n’est prise en charge que si Gâchette est On Error.
FallbackCount	nombre	Cette variable compte les fois où un rubrique n’a pas pu être associé à la saisie utilisateur. Remarque : Cette variable n’est prise en charge que si Gâchette est On Unknown Intent.
InactivityTimer.Continue	Booléen	Drapeau booléen qui indique si le minuteur doit continuer. Remarque : Cette variable n’est prise en charge que si Gâchette est Inactivity.
InactivityTimer.Count	nombre	Nombre de fois où le minuteur OnInactivity s’est déclenché en raison de l’inactivité de l’utilisateur après le temps configuré. Remarque : Cette variable n’est prise en charge que si Gâchette est Inactivity.
LastMessage.Id	chaîne	ID du message précédent envoyé par l’utilisateur
LastMessage.Text	chaîne	Message précédent envoyé par l’utilisateur
Recognizer.ExtractedEntities	option	Représente les entités extraites du message déclencheur. Remarque : Cette variable n’est prise en charge que si Gâchette est On Select Intent.
Recognizer.IntentOptions	option	Représente les options d’intention lorsque le module de reconnaissance renvoie des résultats ambigus. Remarque : Cette variable n’est prise en charge que si Gâchette est On Select Intent.
Recognizer.SelectedIntent	option	Représente l’intention sélectionnée à partir du module de reconnaissance. Remarque : Cette variable n’est prise en charge que si Gâchette est On Select Intent.
Recognizer.TriggeringMessage.Id	chaîne	ID du message de l’utilisateur qui a déclenché la rubrique actuelle
Recognizer.TriggeringMessage.Text	chaîne	Message de l’utilisateur qui a déclenché la rubrique actuelle
Recognizer.MultipleTopicsMatchedReason	chaîne	Utilisé pour déterminer pourquoi plusieurs sujets correspondants ont été appariés. Remarque : Cette variable n’est prise en charge que si Gâchette est On Select Intent.
User.Language	option	Cette variable est utilisée pour définir les paramètres régionaux de la langue de l’utilisateur par conversation.
SignInReason	option	Utilisé pour déterminer quelle option de connexion est nécessaire lors du déclenchement de rubrique. Remarque : Cette variable n’est prise en charge que si Gâchette est On Sign In.

Variables pour l’authentification intégrée (par défaut)

Les variables suivantes sont disponibles lorsque vous avez configuré votre copilote pour s’authentifier auprès de Microsoft. Cela utilisera l’authentification Entra ID et autorisera uniquement les équipes et PowerApps chaînes. C’est la valeur par défaut des nouvelles copilotes.

Pour plus d’informations, voir Variables d’authentification.

Nom	Type	Définition
User.DisplayName	chaine	Le nom d’affichage de l’utilisateur qui parle actuellement au copilote.
User.Email	chaîne	L’adresse e-mail de l’utilisateur qui parle actuellement au copilote.
User.FirstName	chaîne	Le prénom de l’utilisateur qui parle actuellement au copilote.
User.Id	chaîne	L’ID unique de l’utilisateur qui parle actuellement au copilote.
User.IsLoggedIn	Booléen	Drapeau Sélectionner qui représente si l’utilisateur qui parle actuellement au copilote est authentifié ou non.
User.LastName	chaîne	Le nom de l’utilisateur qui parle actuellement au copilote.
User.PrincipalName	chaîne	Le nom d'utilisateur principal qui parle actuellement au copilote.

Variables pour l’authentification manuelle avec Generic OAuth 2

Les variables suivantes sont disponibles lorsque vous avez configuré votre copilote pour utiliser le fournisseur de services Generic OAuth 2.

Nom	Type	Définition
User.AccessToken	chaine	Le jeton d’accès pour l’utilisateur s’authentifiant avec le copilote.
User.DisplayName	chaîne	Le nom d’affichage de l’utilisateur qui parle actuellement au copilote.
User.Id	chaîne	L’ID unique de l’utilisateur qui parle actuellement au copilote.
User.IsLoggedIn	Booléen	Drapeau Sélectionner qui représente si l’utilisateur qui parle actuellement au copilote est authentifié ou non.

Variables pour l’authentification manuelle avec Microsoft Entra ID

Les variables suivantes sont disponibles lorsque vous avez configuré votre copilote pour utiliser le fournisseur de services Microsoft Entra ID (avant Azure Active Directory).

Nom	Type	Définition
User.AccessToken	chaîne	Le jeton d’accès pour l’utilisateur s’authentifiant avec le copilote.
User.DisplayName	chaîne	Le nom d’affichage de l’utilisateur qui parle actuellement au copilote.
User.Email	chaîne	L’adresse e-mail de l’utilisateur qui parle actuellement au copilote.
User.FirstName	chaîne	Le prénom de l’utilisateur qui parle actuellement au copilote.
User.Id	chaîne	L’ID unique de l’utilisateur qui parle actuellement au copilote.
User.IsLoggedIn	Booléen	Drapeau Sélectionner qui représente si l’utilisateur qui parle actuellement au copilote est authentifié ou non.
User.LastName	chaîne	Le nom de l’utilisateur qui parle actuellement au copilote.
User.PrincipalName	chaîne	Le nom d'utilisateur principal qui parle actuellement au copilote.

Variables pour les copilotes activés par la voix

Les variables suivantes ne sont disponibles que dans les copilotes activés par la voix.

Note

Pour plus d’informations sur les variables de copilote activées par la voix, voir Utiliser les variables vocales.

Nom	Type	Définition
Activity.InputDTMFKeys	chaine	La valeur de clé DTMF brute qui a été reçue de la téléphonie.
Activity.SpeechRecognition.Confidence	nombre	Le score de confiance pour l’hypothèse ASR résultat entier, 0 à 1.
Activity.SpeechRecognition.MinimallyFormattedText	chaîne	Texte légèrement formaté du résultat de l’hypothèse ASR. Par exemple, cinq cents dollars. Les mots sont épelés, mais les majuscules et la ponctuation de base sont incluses.
Activity.UserInputType	option	Le type d’entrée de la saisie la plus récente de l’utilisateur final. La valeur peut être tester, message ou DTMF.
Conversation.OnlyAllowDTMF	Booléen	Booléen indicateur qui indique si l’IVR doit être défini sur le mode DTMF uniquement au moment de l’exécution.
Conversation.SipUuiHeaderValue	chaîne	La chaîne d’en-tête UUI utilisée pour transmettre le contexte à l’IVR au début de l’appel.

Transmettre des variables d’une rubrique à une autre

Lorsque vous redirigez une rubrique vers une autre, vous pouvez passer les valeurs des variables entre la rubrique d’origine et la rubrique de destination. Passer des variables entre les rubriques est particulièrement utile lorsqu’une rubrique précédente a déjà recueilli des informations dont une rubrique ultérieure a besoin. Vos utilisateurs apprécieront de ne pas avoir à répondre à nouveau aux mêmes questions.

Recevoir des valeurs d’autres rubriques

Lorsqu’une rubrique définit une variable (par exemple, dans un nœud Question), le copilote pose à l’utilisateur la question pour remplir la valeur de la variable. Si le copilote a déjà acquis la valeur dans une rubrique précédente, il n’y a aucune raison de poser à nouveau la question. Dans ces cas, vous pouvez définir la variable comme Recevoir des valeurs d’autres rubriques. Lorsqu’une autre rubrique redirige vers cette rubrique, la valeur d’une variable (ou une valeur littérale) peut être transmise dans cette variable, et la question peut être ignorée. L’expérience de l’utilisateur qui parle au copilote est fluide.

Dans cet exemple, nous utilisons deux rubriques, Bienvenue et Conversation avec le client. Les deux rubriques demandent le nom du client. Cependant, si la rubrique Bienvenue s’exécute en premier, la rubrique Conversation avec le client ignore sa question. Au lieu de cela, elle utilise la valeur de la variable transmise par la rubrique Bienvenue.

Voici le flux de la rubrique Conversation avec le client :

Comme indiqué dans le volet Tester le copilote, si cette rubrique est déclenchée en premier, elle demande à l’utilisateur : « Comment dois-je vous appeler ? » Elle stocke la valeur dans une variable de chaîne appelée userName. La variable userName est également définie pour obtenir sa valeur à partir d’autres rubriques. La rubrique se termine par le message : « J’espère que vous passez une bonne journée, {userName} ! »

Voici le flux de la rubrique Bienvenue :

Comme indiqué dans le volet Tester le copilote, si cette rubrique est déclenchée en premier, elle demande à l’utilisateur : « Quel est votre nom ? » Elle stocke la valeur dans une variable de chaîne appelée UserName. La rubrique envoie le message : « Enchanté de faire votre connaissance, {UserName} ! » Elle redirige ensuite vers la rubrique Conversation avec le client, qui envoie le message : « J’espère que vous passez une bonne journée, {userName} ! » Notez, cependant, que la rubrique Conversation avec le client a ignoré à nouveau la demande du nom de l’utilisateur. Au lieu de cela, elle utilise la valeur de la variable UserName transmise par la rubrique Bienvenue.

Enfin, voici à nouveau cette deuxième conversation, cette fois du point de vue de la rubrique Conversation avec le client :

Passons en revue les étapes pour configurer une rubrique pour recevoir des valeurs d’autres rubriques. Nous utiliserons notre exemple actuel, mais les mêmes étapes fonctionneront chaque fois qu’une rubrique aura besoin d’obtenir la valeur d’une rubrique antérieure.

Configurer la rubrique Destination

La rubrique Destination désigne la rubrique de redirection, celle qui recevra les valeurs des autres rubriques. Dans notre exemple, il s’agit de Conversation avec le client.

1. Créez ou accédez à votre rubrique Destination.

2. Ajoutez un nœud Question et saisissez What should I call you? pour le message.

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

4. Sélectionnez la variable pour l’ouvrir dans le volet Propriétés des variables. Nommez-la userName, puis sélectionnez Recevoir des valeurs d’autres rubriques.

   

5. Ajoutez un nœud Message.

6. Dans la zone du message, tapez I hope you're having a wonderful day,.

7. Sélectionnez l’icône Insérer une variable ({x}), puis sélectionnez userName.

8. Sélectionnez l’espace après la variable et tapez !.

9. Enregistrez la rubrique.

Configurer la rubrique source

La rubrique source est la rubrique faisant la redirection, celle qui fournit la valeur qui sera passée à la rubrique de destination. Dans notre exemple, il s’agit de Bienvenue.

1. Accédez à la rubrique source.

2. Ajoutez un nœud de redirection et Sélectionner la destination rubrique.

3. Sélectionnez + Ajouter une entrée, puis sélectionnez la variable dans la rubrique de destination à laquelle vous souhaitez transmettre une valeur.

   

4. Sélectionnez l’icône > , puis sélectionnez la variable dont vous souhaitez transmettre la valeur.

   

   Le nœud Rediriger doit ressembler à ce qui suit :

   

5. Enregistrez la rubrique.

Renvoyer les valeurs aux rubriques d’origine

Lorsqu’une rubrique est redirigée et obtient une variable en posant une question ou à partir d’une action, cette variable peut être renvoyée à la rubrique d’origine. La variable fait également partie de la rubrique d’origine et peut être utilisée comme n’importe quelle autre variable. Les informations obtenues par le copilote sont ainsi disponibles dans toutes les rubriques, ce qui réduit le besoin de variables globales.

Cela correspond à l’exemple de la section précédente. Nous poserons une nouvelle question dans la rubrique Conversation avec le client, puis renverrons la réponse à la rubrique Bienvenue.

Configurer la rubrique source pour une variable renvoyée

Lorsque vous renvoyez une variable à une rubrique, la rubrique source est la rubrique vers laquelle vous êtes redirigée, celle qui fournit la valeur qui sera renvoyée à la rubrique d’origine. Dans cet exemple, il s’agit de Conversation avec le client.

1. Accédez à la rubrique source.

2. Ajoutez un nœud Question et saisissez What city do you live in? pour le message.

3. Sous Identifier, sélectionnez l’entité prédéfinie Ville.

4. Sélectionnez la variable pour l’ouvrir dans le volet Propriétés des variables. Nommez-la userCity, puis sélectionnez Renvoyer des valeurs aux rubriques d’origine.

   

5. Enregistrez la rubrique.

Configurer la rubrique de destination pour une variable renvoyée

Lorsque vous renvoyez une variable à une rubrique, la rubrique de destination est la rubrique effectuant la redirection, celle qui recevra les valeurs des autres rubriques. Dans notre exemple, il s’agit de Bienvenue.

1. Accédez à la rubrique de destination.

2. La variable que vous avez sélectionnée dans la rubrique source doit s’afficher dans le nœud de redirection en tant que variable de sortie.

   

3. Enregistrez la rubrique.

Classique

Entité et type de variable

Copilot Studio utilise des entités pour comprendre et identifier un type spécifique d’information dans les réponses d’un utilisateur. Un type de variable est associé aux informations identifiées lors de leur enregistrement. Le type de variable est analogue à l’entité.

Chaque entité ou type de variable correspond à un type de base, comme indiqué dans le tableau suivant. Le type de base détermine les opérateurs qui peuvent être utilisés pour la variable correspondante lors de la construction d’une expression logique. Il détermine également si vous pouvez envoyer une variable à un flux ou une compétence Bot Framework comme paramètre d’entrée.

Par exemple, un type de base booléen est mappé à un opérateur « est égal à » avec des valeurs possibles définies sur True ou False. Une base de type Numérique vous donne des opérateurs numériques tels que « est égal à », « est supérieur à » ou « est supérieur ou égal à », etc.

Entité	Type de base de variable
Options à choix multiples	Chaîne
Réponse complète de l’utilisateur	Chaîne
Âge	Nombre
Boolean	Boolean
Ville	Chaîne
Color	Chaîne
Continent	Chaîne
Pays ou région	Chaîne
Date et heure	Chaîne
Duration	Chaîne
E-mail	Chaîne
Événement	Chaîne
Langue	Chaîne
Money	Chaîne
Nombre	Chaîne
Ordinal	Chaîne
Organisation	Chaîne
Pourcentage	Nombre
Nom de la personne	Chaîne
Numéro de téléphone	Chaîne
Point d’intérêt	Chaîne
Vitesse	Nombre
État	Chaîne
Adresse postale	Chaîne
Température	Nombre
URL	Chaîne
Poids	Nombre
Code postal	Chaîne
Entité personnalisée	Chaîne

Créer une variable

Dans le canevas de création de bot, ajoutez un nœud de question. Une variable est automatiquement créée au sein du nœud.

1. Accédez à la page des sujets de votre bot et ouvrez le rubrique auquel vous souhaitez ajouter une variable. ...

2. Sélectionnez Ajouter un nœud (+), puis sélectionnez Poser une question.

   

   Une variable contenant la réponse de l’utilisateur est automatiquement créée.

   

Choisir une entité à utiliser

Par défaut, un nœud de question est créé avec des options à choix multiples. Pour utiliser une autre entité prédéfinie ou personnalisée, choisissez ce que vous souhaitez identifier à partir du nœud.

Renommer une variable

Les variables créées automatiquement sont accompagnées d’un nom par défaut. Pour renommer une variable, sélectionnez le nom de la variable, entrez un nouveau nom et sélectionnez Terminé.

Utiliser des variables dans les nœuds d’action

Lorsque vous utilisez une variable dans un nœud d’action, si son type de base correspond à un type de paramètre spécifié pour un flux ou une compétence Bot Framework, vous pouvez l’alimenter à ce paramètre. Le résultat des nœuds d’action génère de nouvelles variables.

Utiliser des valeurs littérales dans les nœuds d’action

Vous pouvez également saisir une valeur littérale dans un champ d’entrée de variable dans un nœud d’action au lieu de sélectionner une variable dans le menu.

Analyser la valeur du nœud

Le nœud Analyser la valeur vous permet de convertir une valeur d’un type en une valeur d’un autre type. Lorsque vous ajoutez un nœud à un sujet, sélectionnez Ajouter un nœud (+), puis Gestion des variables, puis Analyser la valeur.

Les scénarios clés utilisant le nœud Analyser la valeur se concentrent sur la conversion de variables JSON brut ou de variables non saisies (dont la valeur ou la structure n’est connue qu’au moment de l’exécution ; par exemple ChannelData) en types concrets.

Le processus démarre lorsqu’un flux est appelé, qui à son tour appelle une API. L’API renvoie alors un résultat. En règle générale, vous devrez analyser cette réponse et renvoyer une ou plusieurs variables primitives à Copilot Studio. Avec le nœud Analyser la valeur, vous pouvez envoyer le résultat complet de l’API sous forme de chaîne :

{
    "Name": "Gary",
    "Position": "PM",
    "Company": "Microsoft",
    "FormerPositions": [{
            "Position": "Engineer"
        }
    ]
}

La variable de chaîne que vous avez maintenant peut être convertie en une variable d’enregistrement, avec une prise en charge complète d’IntelliSense dans Power Fx, en utilisant ce nouveau nœud. Un exemple utilisant des exemples de données aidera à illustrer ce processus.

Exemple d’utilisation du nœud Analyser la valeur

1. Ajoutez un nœud Analyser la valeur et sélectionnez la variable que vous souhaitez analyser.

   

2. Sélectionnez le type de données. Dans ce cas, choisissez « À partir de l’exemple de données ».

   

3. Vous pouvez maintenant fournir JSON en cliquant sur « Obtenir le schéma à partir de l’échantillon JSON ». Cliquer dessus ouvre un éditeur dans lequel vous pouvez coller l’exemple.

   

4. Enfin, spécifiez dans quelle variable vous souhaitez placer la valeur analysée. Habituellement, vous créez une nouvelle variable pour cela.

   

   Notez que la variable de sortie est maintenant du type correct – Enregistrement.

   

Vous pouvez maintenant utiliser votre nouvelle variable. Ici dans l’éditeur Power Fx, vous pouvez voir que vous obtenez un IntelliSense complet pour les différentes propriétés.

En plus de l’analyse des chaînes JSON, une utilisation clé du nœud Analyser la valeur servira à l’analyse des UntypedObjects au moment du runtime. La plus courante d’entre elles est lorsque vous recevez un événement et que vous devez analyser la valeur de l’événement. Ou vous souhaiterez peut-être analyser la propriété System.Activity.ChannelData, qui varie au moment du runtime par canal.

Dans l’exemple suivant, si l’événement provenait de Teams, vous devriez utiliser la documentation pour les développeurs Teams pour trouver un exemple de ce à quoi ressemblera l’événement entrant, puis l’utiliser à partir des exemples de données comme indiqué dans cette section.

Transmettre des variables d’une rubrique à une autre

Lors de la redirection vers d’autres rubriques, vous souhaiterez peut-être transmettre des valeurs aux variables de la rubrique de destination, ou récupérer des variables à partir de celle-ci. Passer des variables entre les rubriques est particulièrement utile lorsque vous avez déjà des informations dont la rubrique a besoin. Vos utilisateurs apprécieront de ne pas avoir à répondre à nouveau à la question. Cela peut également être utile lors de la refactorisation et de la séparation de vos rubriques en composants réutilisables, lorsque vous souhaitez transmettre des variables d’une rubrique à une autre.

Note

Les variables de type Custom Entity, Date and Time, Duration et Multiple-choice ne peuvent pas être transmises d’un sujet à un autre.

Recevoir des valeurs d’autres rubriques

Lorsqu’une rubrique définit une variable (par exemple, par un nœud de question), le bot pose à l’utilisateur la question pour remplir la valeur de la variable. Si le bot a déjà acquis la valeur, il n’y a aucune raison de poser à nouveau la question. Dans ces cas, vous pouvez définir la variable comme Recevoir des valeurs d’autres rubriques. Lorsqu’une autre rubrique redirige vers cette rubrique, une variable (ou des valeurs littérales) peuvent être transmises dans cette variable, et la question pourra être ignorée. Cela permet d’offrir une expérience homogène pour l’utilisateur final qui parle au bot.

Pour recevoir des valeurs d’autres rubriques, définissez la propriété de la variable :

1. Dans le nœud Question, sélectionnez la variable pour laquelle vous souhaitez recevoir les valeurs d’autres rubriques.

2. Dans le volet Propriétés des variables, sous Rubrique (étendue limitée), sélectionnez Recevoir des valeurs d’autres rubriques.

   

3. Enregistrez la rubrique.

4. Accédez à une rubrique vers laquelle vous souhaitez rediriger. Suivez les étapes dans Rediriger vers une autre rubrique pour rediriger vers la bonne rubrique.

5. Sélectionnez Ajouter une entrée pour la rubrique de destination.

   

6. Sélectionnez la variable dans la rubrique redirigée à laquelle vous souhaitez transmettre la variable.

   

7. Sous Entrer ou sélectionner une valeur, sélectionnez la variable de la rubrique actuelle que vous souhaitez transmettre à la rubrique redirigée.

   

   La variable est affichée dans le nœud redirigé.

   

Renvoyer les valeurs aux rubriques d’origine

Lorsqu’une rubrique pose une question (ou obtient une variable à partir d’une action), cette variable peut être renvoyée à la rubrique d’origine qui a redirigé.

Dans ce cas, la variable fait également partie de la rubrique d’origine et peut être utilisée comme n’importe quelle autre variable. Cela vous aide à construire la rubrique afin que les informations que le bot obtient soient disponibles dans toutes les rubriques, réduisant ainsi le besoin de variables globales.

Pour renvoyer une variable à la rubrique d’origine, définissez la propriété de la variable :

1. Dans le nœud Question, sélectionnez la variable pour laquelle vous souhaitez recevoir les valeurs d’autres rubriques.

2. Dans le volet Propriétés des variables, sous Rubrique (étendue limitée), sélectionnez Renvoyer les valeurs aux rubriques d’origine.

   

3. Enregistrez la rubrique.

4. Accédez à une rubrique vers laquelle vous souhaitez rediriger. Suivez les étapes dans Rediriger vers une autre rubrique pour rediriger vers la bonne rubrique.

   La variable renvoyée à la rubrique est affichée dans la rubrique redirigée. Utilisez la variable renvoyée dans votre rubrique.

   

Utilisation du volet des variables

Utilisez le volet Variables pour sélectionner l’état de réception ou de retour de plusieurs variables à la fois.

1. Dans la barre de menu de la rubrique, sélectionnez Variables.

   

2. Pour chacune des variables de la rubrique, sélectionnez si vous souhaitez que les valeurs soient transmises depuis ou vers (ou les deux) différentes rubriques.

   

Utilisation de valeurs littérales sur des entrées de variables

Vous pouvez transmettre des valeurs littérales ainsi que des variables à une rubrique. Pour transmettre une valeur littérale, saisissez la valeur que vous souhaitez utiliser comme entrée au lieu de sélectionner une variable.

Contenu associé

• Utilisez des variables pour transférer du contenu entre les sujets
• Personnalisez l’apparence et la convivialité d’un copilote