Vue d’ensemble des variables
Les variables peuvent exister à quatre niveaux ou portées :
- Rubrique : les variables 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 agent. Elles fournissent des informations plus contextuelles sur la conversation ou l’utilisateur. Elles sont disponibles dans toutes les rubriques.
- Les variables d’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 de l’affecter à une valeur Chaîne de "apples" entraîne une erreur.
Lorsque vous testez un agent, une variable peut apparaître temporairement comme le 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 considérés 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 |
| 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 | String |
| Poids | Chiffre |
| Code postal | String |
| Entité personnalisée | Option |
Variables d’environnement
Les variables d’environnement sont un concept de Power Platform. 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 les variables d’environnement sont en lecture seule dans Copilot Studio. Les auteurs d’agents ne peuvent pas modifier les variables d’environnement dans Copilot Studio. Toutefois, les administrateurs peuvent modifier la valeur des variables d’environnement dans Power Apps. Dans Copilot Studio, vous pouvez utiliser le volet Variables pour afficher des informations sur une variable d’environnement. Le volet Variables comporte également un lien vers l’expérience de création native.
La version publiée d’un agent qui utilise des variables d’environnement contient les valeurs qui ont été définies pour ces variables lors de la publication de l’agent. Chaque fois qu’un administrateur met à jour des variables d’environnement, vous devez republier tous les agents qui utilisent ces variables pour que les modifications soient effectives au moment de l’exécution. Cependant, il existe une exception : vous n’avez pas besoin de republier vos agents lorsque la valeur d’une variable d’environnement de type secret est modifiée. Contrairement aux autres variables d’environnement, les variables secrètes sont récupérées au moment de l’exécution.
Les types de variables d’environnement dans Copilot Studio sont mappés aux types de données Power Apps, comme suit :
| Type dans Copilot Studio | Type dans Power Apps |
|---|---|
| Nombre décimal | Chiffre |
| JSON | Détectez le type à partir de la valeur. Sinon JSON => Non spécifié (erreur de validation) |
| Text | String |
| Oui/non | Valeur booléenne |
| Source de données | String |
| Secret | String |
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.
Variables système
Chaque agent est livré 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 agent vocales, consultez Utiliser des 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 | chaine | ID de canal de la conversation actuelle, sous forme de chaîne |
| Activity.From.Id | chaine | ID unique spécifique au canal pour l’expéditeur |
| Activity.From.Name | chaine | Nom convivial spécifique au canal de l’expéditeur |
| Activity.Name | chaine | Nom de l’événement |
| Activity.Recipient.Id | chaine | Propriété type d’activité entrante. |
| Activity.Recipient.Name | chaine | Représente le nom d’affichage de l’agent dans le canal. Dans le contexte du canal de téléphonie, la valeur de cette variable est le numéro de téléphone auquel l’agent est rattaché. |
| Activity.Text | chaine | Message le plus récent envoyé par l’utilisateur |
| Activity.Type | option | Type d’activité |
| Activity.TypeId | chaine | Type d’activité, sous forme de chaîne |
| Activity.Value | tous | Valeur ouverte |
| Bot.EnvironmentId | chaine | ID d’environnement de l’agent |
| Bot.Id | chaine | ID de l’agent |
| Bot.Name | chaine | Nom de votre agent |
| Bot.SchemaName | chaine | Nom du schéma de l’agent |
| Bot.TenantId | chaine | ID de locataire de l’agent |
| ClientPluginActions | option | Collection d’actions de plug-in client dynamique à prendre en compte pour l’orchestration générative |
| Conversation.Id | chaine | ID unique de la conversation actuelle |
| Conversation.InTestMode | Valeur booléenne | Drapeau booléen qui indique si la conversation se déroule dans le canevas de test |
| Conversation.LocalTimeZone | chaine | 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 | chaine | Code d’erreur pour l’erreur actuelle. Message d’erreur pour l’erreur actuelle. |
| Error.Message | chaine | Message d’erreur pour l’erreur actuelle. Note : cette variable n’est prise en charge que si le déclencheur est On Error. |
| FallbackCount | nombre | Cette variable compte les fois où un rubrique n’a pas pu être associé à la saisie utilisateur. Note : cette variable n’est prise en charge que si le déclencheur est On Unknown Intent. |
| InactivityTimer.Continue | Valeur booléenne | Drapeau booléen qui indique si le minuteur doit continuer. Note : cette variable n’est prise en charge que si le déclencheur 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é. Note : cette variable n’est prise en charge que si le déclencheur est Inactivity. |
| LastMessage.Id | chaine | ID du message précédent envoyé par l’utilisateur |
| LastMessage.Text | chaine | Message précédent envoyé par l’utilisateur |
| Recognizer.ExtractedEntities | option | Représente les entités extraites du message déclencheur. Note : cette variable n’est prise en charge que si le déclencheur est On Select Intent. |
| Recognizer.IntentOptions | option | Représente les options d’intention lorsque le module de reconnaissance renvoie des résultats ambigus. Note : cette variable n’est prise en charge que si le déclencheur est On Select Intent. |
| Recognizer.SelectedIntent | option | Représente l’intention sélectionnée à partir du module de reconnaissance. Note : cette variable n’est prise en charge que si le déclencheur est On Select Intent. |
| Recognizer.TriggeringMessage.Id | chaine | ID du message de l’utilisateur qui a déclenché la rubrique actuelle |
| Recognizer.TriggeringMessage.Text | chaine | Message de l’utilisateur qui a déclenché la rubrique actuelle |
| Recognizer.MultipleTopicsMatchedReason | chaine | Utilisé pour déterminer pourquoi plusieurs rubriques sont associées. Note : cette variable n’est prise en charge que si le déclencheur est On Select Intent. |
| SignInReason | option | Utilisé pour déterminer quelle option de connexion est nécessaire lors du déclenchement de rubrique. Note : cette variable n’est prise en charge que si le déclencheur est On Sign In. |
| User.Language | option | Cette variable est utilisée pour définir les paramètres régionaux de la langue de l’utilisateur par conversation. |
Variables pour l’authentification intégrée (par défaut)
Les variables suivantes sont disponibles pour les agents configurés pour l’authentification avec Microsoft. Cette configuration utilise l’authentification Microsoft Entra ID et constitue la valeur par défaut pour les nouveaux agents.
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 à l’agent. |
| User.Email | chaine | L’adresse e-mail de l’utilisateur qui parle actuellement à l’agent. |
| User.FirstName | chaine | Le prénom de l’utilisateur qui parle actuellement à l’agent. |
| User.Id | chaine | L’ID unique de l’utilisateur qui parle actuellement à l’agent. |
| User.IsLoggedIn | Valeur booléenne | Indicateur booléen représentant si l’utilisateur qui parle actuellement à l’agent est authentifié ou non. |
| User.LastName | chaine | Nom de famille de l’utilisateur qui parle actuellement à l’agent. |
| User.PrincipalName | chaine | Le nom d’utilisateur principal de l’utilisateur qui parle actuellement à l’agent. |
Variables pour l’authentification manuelle avec Generic OAuth 2
Les variables suivantes sont disponibles pour les agents configurés 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 l’agent. |
| User.DisplayName | chaine | Le nom d’affichage de l’utilisateur qui parle actuellement à l’agent. |
| User.Id | chaine | L’ID unique de l’utilisateur qui parle actuellement à l’agent. |
| User.IsLoggedIn | Valeur booléenne | Indicateur booléen représentant si l’utilisateur qui parle actuellement à l’agent est authentifié ou non. |
Variables pour l’authentification manuelle avec Microsoft Entra ID
Les variables suivantes sont disponibles pour les agents configurés pour utiliser les fournisseurs de services Microsoft Entra ID (anciennement Azure Active Directory).
| Nom | Type | Définition |
|---|---|---|
| User.AccessToken | chaine | Le jeton d’accès pour l’utilisateur s’authentifiant avec l’agent. |
| User.DisplayName | chaine | Le nom d’affichage de l’utilisateur qui parle actuellement à l’agent. |
| User.Email | chaine | L’adresse e-mail de l’utilisateur qui parle actuellement à l’agent. |
| User.FirstName | chaine | Le prénom de l’utilisateur qui parle actuellement à l’agent. |
| User.Id | chaine | L’ID unique de l’utilisateur qui parle actuellement à l’agent. |
| User.IsLoggedIn | Valeur booléenne | Indicateur booléen représentant si l’utilisateur qui parle actuellement à l’agent est authentifié ou non. |
| User.LastName | chaine | Nom de famille de l’utilisateur qui parle actuellement à l’agent. |
| User.PrincipalName | chaine | Nom principal de l’utilisateur qui communique actuellement avec l’agent. |
Variables pour les agents à commande vocale
Les variables suivantes ne sont disponibles que pour les agents à commande vocale.
Note
Pour plus d’informations sur les variables agent vocales, consultez Utiliser des variables vocales.
| Nom | Type | Définition |
|---|---|---|
| Activité.InputDTMFKeys | chaine | La valeur de clé DTMF brute qui a été reçue de la téléphonie. |
| Activity.SpeechRecognition.Confidence | nombre | Score de confiance pour le résultat complet de l’hypothèse Azure Site Recovery, 0 à 1. |
| Activity.SpeechRecognition.MinimallyFormattedText | chaine | Texte légèrement formaté du résultat de l’hypothèse Azure Site Recovery. Par exemple, « cinq cents dollars ». Les mots sont épelés, mais les majuscules et la ponctuation de base sont incluses. |
| Activité.UserInputType | option | Type d’entrée de l’entrée la plus récente de l’utilisateur. La valeur peut être tester, message ou DTMF. |
| Conversation.OnlyAllowDTMF | Valeur booléenne | 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 | chaine | La chaîne d’en-tête UUI utilisée pour transmettre le contexte à l’IVR au début de l’appel. |