Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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.
| Catégorie | 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 |
| 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 |
| Date et Heure | Date, heure, jour de la semaine ou mois par rapport à un moment donné |
| Choix | Une liste de valeurs de chaîne avec des synonymes associés |
| Blank | Un espace réservé à « aucune valeur » ou « valeur inconnue » ; pour plus d’informations, consultez Blank 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 | Choix |
| Réponse complète de l’utilisateur | Chaîne |
| Âge | Chiffre |
| Booléen | Booléen |
| Ville | Chaîne |
| Couleur | Chaîne |
| Continent | Chaîne |
| Pays ou région | Chaîne |
| Date et heure | Date et Heure |
| Courrier électronique | Chaîne |
| Événement | Chaîne |
| Entier | Entier |
| Langage | Chaîne |
| Argent | Chiffre |
| Chiffre | Chiffre |
| Ordinal | Chiffre |
| Organisation | Chaîne |
| Pourcentage | Chiffre |
| Nom de la personne | Chaîne |
| Numéro de téléphone | Chaîne |
| Point d’intérêt | Chaîne |
| Vitesse | Chiffre |
| État | Chaîne |
| Adresse postale | Chaîne |
| Température | Chiffre |
| URL | Chaîne |
| Poids | Chiffre |
| Code postal | Chaîne |
| Entité personnalisée | Choix |
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 du texte 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éen |
| 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 | Catégorie | Définition |
|---|---|---|
| Activité.Pièces Jointes | Table | Les pièces jointes fournies par l’utilisateur. |
| Activité.Canal | choix | ID de canal de la conversation actuelle. |
| Activity.ChannelData | n’importe laquelle | Objet contenant du contenu spécifique au canal. |
| Activity.ChannelId | chaîne de caractères | L'identifiant du canal de la conversation actuelle, sous forme textuelle. |
| Activity.From.Id | chaîne de caractères | ID unique spécifique au canal pour l’expéditeur. |
| Activity.From.Name | chaîne de caractères | Nom convivial spécifique au canal de l’expéditeur. |
| Activité.Nom | chaîne de caractères | Nom de l’événement. |
| Activity.Recipient.Id | chaîne de caractères | Propriété type d’activité entrante. |
| Activity.Recipient.Name | chaîne de caractères | 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é. |
| Texte.Activity | chaîne de caractères | Message le plus récent envoyé par l’utilisateur. |
| Type d'activité | choix | Type d’activité. |
| Activity.TypeId | chaîne de caractères | Type d’activité, sous forme de chaîne. |
| Activité.Valeur | n’importe laquelle | Valeur sans limite. |
| Bot.EnvironmentId | chaîne de caractères | ID d’environnement de l’agent. |
| Bot.Id | chaîne de caractères | ID de l’Agent. |
| Bot.Name | chaîne de caractères | Le nom de votre assistant. |
| Bot.SchemaName | chaîne de caractères | Nom du schéma de l'agent. |
| Bot.TenantId | chaîne de caractères | ID de locataire de l'agent. |
| ClientPluginActions | choix | Collection d’actions de plug-in client dynamique à prendre en compte pour l’orchestration générative. |
| Conversation.Id | chaîne de caractères | 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 de caractères | 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. |
| Code d'erreur | chaîne de caractères | Code d’erreur pour l’erreur actuelle. Message d’erreur pour l’erreur actuelle. |
| Erreur.Message | chaîne de caractères | 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éen | 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 | chaîne de caractères | ID du message précédent envoyé par l’utilisateur. |
| LastMessage.Text | chaîne de caractères | Message précédent envoyé par l’utilisateur. |
| Reconnaisseur.EntitésExtraites | choix | 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 | choix | 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 | choix | 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 | chaîne de caractères | ID du message de l’utilisateur qui a déclenché la rubrique actuelle. |
| Recognizer.MessageDéclencheur.Texte | chaîne de caractères | Message de l’utilisateur qui a déclenché la rubrique actuelle. |
| Recognizer.MultipleTopicsMatchedReason | chaîne de caractères | 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 | choix | 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. |
| Utilisateur.Langue | choix | 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 | Catégorie | Définition |
|---|---|---|
| Utilisateur.NomAffichage | chaîne de caractères | Le nom d’affichage de l’utilisateur qui parle actuellement à l’agent. |
| Utilisateur.Email | chaîne de caractères | L’adresse e-mail de l’utilisateur qui parle actuellement à l’agent. |
| Utilisateur.Prénom | chaîne de caractères | Le prénom de l’utilisateur qui parle actuellement à l’agent. |
| User.Id | chaîne de caractères | L’ID unique de l’utilisateur qui parle actuellement à l’agent. |
| User.IsLoggedIn | Booléen | Indicateur booléen représentant si l’utilisateur qui parle actuellement à l’agent est authentifié ou non. |
| User.LastName | chaîne de caractères | Nom de famille de l’utilisateur qui parle actuellement à l’agent. |
| User.PrincipalName | chaîne de caractères | 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 | Catégorie | Définition |
|---|---|---|
| User.AccessToken | chaîne de caractères | Le jeton d’accès pour l’utilisateur s’authentifiant avec l’agent. |
| Utilisateur.NomAffichage | chaîne de caractères | Le nom d’affichage de l’utilisateur qui parle actuellement à l’agent. |
| User.Id | chaîne de caractères | L’ID unique de l’utilisateur qui parle actuellement à l’agent. |
| User.IsLoggedIn | Booléen | 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 | Catégorie | Définition |
|---|---|---|
| User.AccessToken | chaîne de caractères | Le jeton d’accès pour l’utilisateur s’authentifiant avec l’agent. |
| Utilisateur.NomAffichage | chaîne de caractères | Le nom d’affichage de l’utilisateur qui parle actuellement à l’agent. |
| Utilisateur.Email | chaîne de caractères | L’adresse e-mail de l’utilisateur qui parle actuellement à l’agent. |
| Utilisateur.Prénom | chaîne de caractères | Le prénom de l’utilisateur qui parle actuellement à l’agent. |
| User.Id | chaîne de caractères | L’ID unique de l’utilisateur qui parle actuellement à l’agent. |
| User.IsLoggedIn | Booléen | Indicateur booléen représentant si l’utilisateur qui parle actuellement à l’agent est authentifié ou non. |
| User.LastName | chaîne de caractères | Nom de famille de l’utilisateur qui parle actuellement à l’agent. |
| User.PrincipalName | chaîne de caractères | 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 | Catégorie | Définition |
|---|---|---|
| Activité.InputDTMFKeys | chaîne de caractères | Valeur brute de la clé DTMF de la téléphonie. |
| Activity.ReconnaissanceVocale.Confiance | nombre | Score de confiance pour le résultat complet de l’hypothèse Azure Site Recovery, 0 à 1. |
| Activity.SpeechRecognition.MinimallyFormattedText | chaîne de caractères | Texte légèrement formaté du résultat de l’hypothèse Azure Site Recovery. Par exemple, « Cinq cents dollars ». Les mots sont écrits en toutes lettres, mais les majuscules et la ponctuation de base sont incluses. |
| Activité.UserInputType | choix | Type de l’entrée la plus récente de l’agent utilisateur. La valeur peut être test, voix 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 de caractères | La chaîne d’en-tête UUI utilisée pour transmettre le contexte à l’IVR au début de l’appel. |