Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de changer d’annuaire.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer d’annuaire.
Les variables existent à quatre niveaux, ou étendues :
- Les variables de rubrique que vous pouvez utiliser uniquement dans les rubriques où vous les créez. Il s’agit de la portée par défaut pour les variables que vous créez.
- Variables globales que vous pouvez utiliser 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 que Copilot Studio crée automatiquement pour un assistant. Elles fournissent des informations plus contextuelles sur la conversation ou l’utilisateur. Elles sont disponibles dans toutes les rubriques.
- Les variables d’environnement que vous créez dans Power Platform. Elles sont en lecture seule dans Copilot Studio. Elles stockent les clés et les valeurs de paramètres, qui peuvent ensuite servir d’entrée à divers autres objets d’application, notamment 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 des valeurs de paramètres codées en dur dans les composants qui les utilisent.
Types de variable
Chaque variable a un type de base. Le type de base détermine les valeurs que la variable peut détenir et les opérateurs qui peuvent être utilisés pour créer une expression logique.
| Type | Description |
|---|---|
| Chaîne | Séquence de caractères utilisés pour représenter du texte |
| Entier | Valeur logique qui ne peut être que true ou false |
| Chiffre | Tout nombre réel |
| Table | Liste de valeurs, mais toutes les valeurs doivent être du même type |
| Enregistrer | 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 |
| Blank | Espace réservé pour « aucune valeur » ou « valeur inconnue » ; pour plus d’informations, consultez Vide dans la documentation Power Fx |
Vous définissez le type d’une variable la première fois que vous lui attribuez une valeur. Après cela, le type est fixe et vous ne pouvez pas attribuer de valeurs d’un autre type. Par exemple, si vous affectez la valeur de départ 1 à une variable, vous définissez son type sur Numéro. Si vous essayez ensuite d’affecter une valeur de chaîne comme "apples", vous obtenez une erreur.
Lorsque vous testez un assistant, une variable de type inconnu peut apparaître temporairement. Une variable inconnue n’a pas encore de valeur.
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 identifier des types spécifiques d’information depuis 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.
| Entité | Type de base de variable |
|---|---|
| Options à choix multiples | Option |
| Réponse complète de l’utilisateur | Chaîne |
| Âge | Numéro |
| Booléen | Booléen |
| Ville | Chaîne |
| Couleur | Chaîne |
| Continent | Chaîne |
| Pays ou région | Chaîne |
| Date et heure | DateHeure |
| Courrier électronique | Chaîne |
| Événement | Chaîne |
| Entier | Entier |
| Langage | Chaîne |
| Argent | Chiffre |
| Nombre | Chiffre |
| Ordinal | Chiffre |
| Organisation | Chaîne |
| Pourcentage | Numéro |
| Nom de la personne | Chaîne |
| Numéro de téléphone | Chaîne |
| Point d’intérêt | Chaîne |
| Vitesse | Numéro |
| État | Chaîne |
| Adresse postale | Chaîne |
| Température | Numéro |
| URL | Chaîne |
| Poids | Numéro |
| Code postal | Chaîne |
| Entité personnalisée | Option |
Variables d’environnement
Les variables d’environnement sont un concept 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’assistants ne peuvent pas modifier les variables d’environnement dans Copilot Studio. Cependant, les administrateurs peuvent modifier la valeur des variables d’environnement dans Power Apps. Dans Copilot Studio, vous pouvez utiliser le volet des variables pour afficher des informations sur une variable d’environnement. Le volet des propriétés de variable a également un lien vers Power Apps, l’expérience de création pour les variables d’environnement.
La version publiée d’un assistant qui utilise des variables d’environnement contient les valeurs qui sont définies pour ces variables lorsque vous publiez l’assistant. 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 correspondent aux types de données Power Apps comme suit :
| Saisir dans Copilot Studio | Saisir dans Power Apps |
|---|---|
| Nombre décimal | Chiffre |
| JSON | Détectez le type à partir de la valeur. Sinon JSON => Non spécifié (erreur de validation) |
| Texte | Chaîne |
| Oui/non | Booléenne |
| Source de données | Chaîne |
| Clé secrète | 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 Rubriques, car il ne s’agit pas de variables de rubrique.
Variables système
Chaque assistant 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.
Copilot Studio n’affiche pas toutes les variables système. Pour accéder aux variables système masquées, utilisez une formule Power Fx.
Pour utiliser des variables système dans une formule Power Fx, ajoutez 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 | n’importe laquelle | 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 | n’importe laquelle | Valeur ouverte. |
| Bot.EnvironmentId | chaine | ID d’environnement de l’assistant. |
| Bot.Id | chaine | ID de l’Agent. |
| Bot.Name | chaine | Le nom de votre assistant. |
| Bot.SchemaName | chaine | Nom du schéma de l’assistant. |
| Bot.TenantId | chaine | ID de locataire de l’assistant. |
| 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 | 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 | Le 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 | 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 l’heure configurée. 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 est la configuration par défaut pour les nouveaux assistants.
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 | 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 assistants configurés pour utiliser le fournisseur de services générique 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 | 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 assistants 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 | 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 | Valeur brute de la clé DTMF 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 de l’entrée la plus récente de l’utilisateur de l’assistant. La valeur peut être tester, message ou DTMF. |
| Conversation.OnlyAllowDTMF | 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. |