Réutiliser des variables dans des rubriques
Par défaut, la valeur d’une variable est utilisable uniquement dans la rubrique où cette variable est créée. Par exemple, si vous créez une variable UserCity dans une rubrique Check Weather, vous pouvez l’inclure uniquement dans des éléments tels que des nœuds de message au sein de la rubrique Check Weather. Il s’agit de variables de type Rubrique (étendue limitée). Cependant, dans certains scénarios, vous pourriez souhaiter utiliser la même valeur dans plusieurs rubriques. Les copilotes peuvent se souvenir du contexte d’une variable lorsqu’une conversation couvre plusieurs rubriques. Par exemple, une rubrique Bienvenue pourrait demander le nom et l’adresse e-mail du client. Lorsque la conversation se déplace vers une autre rubrique telle que Réservation de rendez-vous, vous souhaiterez peut-être que le copilote se souvienne du nom et de l’adresse e-mail du client. Dans Microsoft Copilot Studio, ces variables sont appelées variables de copilote. Elles sont accessibles par toute rubrique dans le copilote.
Les variables de copilote s’appliquent pendant la session de conversation instantanée en cours. Elles ne peuvent pas être transférées d’une session de conversation instantanée client à une autre. Vous pouvez spécifier les variables à traiter comme des variables de copilote pour les distinguer des variables de niveau rubrique.
Créer une variable de copilote
Pour définir une variable en tant que variable de copilote, ouvrez-la dans le canevas de création. Ouvrez le nœud Poser une question qui stocke la variable que vous souhaitez utiliser. Dans le volet Propriétés de la variable, sous Utilisation, sélectionnez Copilot (toutes les rubriques peuvent y accéder). Le nom de la variable se voit alors affecter une chaîne de préfixe copilot pour le différencier des variables de niveau rubrique.
Par exemple, la variable UserName s’affiche désormais comme copilot.UserName. Lorsque vous convertissez une variable en variable de copilote, assurez-vous que le nom de la variable est unique dans toutes les rubriques. En cas de conflit lié au nom, vous devez renommer la variable avant d’enregistrer votre modification.
Pour en savoir plus, consultez Utiliser des variables globales dans les rubriques d’un copilote.
Définir des variables de copilote
Une fois qu’une variable de copilote est créée, elle est à la disposition de toutes les rubriques. Lorsque vous utilisez un nœud de message ou de question, cliquez sur le bouton {x}. Une liste de toutes les variables disponibles dans cette rubrique s’affiche alors. Les variables sont triées par ordre alphabétique, donc toutes les variables de copilote sont regroupées dans le menu des variables, car elles commencent toutes par le terme « copilot ».
Lorsque vous utilisez un nœud de condition, un nœud d’action de flux ou un nœud de compétence, vous pouvez également visualiser les variables de copilote qui y sont disponibles.
Gérer les variables de copilote
Après avoir créé une variable de copilote à utiliser dans plusieurs rubriques, vous devez comprendre où elle est utilisée. Vous pouvez facilement consulter où la variable a été définie pour la première fois (Source) et les autres rubriques qui l’utilisent. Cela peut être utile si vous travaillez sur un nouveau copilote ou si vous disposez de plusieurs variables et de branches de rubrique complexes.
Voici les deux principaux éléments disponibles dans le volet Propriétés de la variable :
Accéder à la source : accède au nœud où la variable a été initialement créée.
Utilisé par : affiche toutes les rubriques où la variable est utilisée, afin que vous puissiez accéder directement à cette rubrique et à ce nœud.
Définir la valeur d’une variable de copilote à partir de sources externes
Vous pouvez définir une variable de copilote à initialiser avec une source externe. Ainsi, le copilote peut démarrer la conversation avec un certain contexte.
Par exemple, un client lance une conversation instantanée depuis votre site web. Si l’utilisateur est connecté à votre site web, vous connaissez déjà le nom du client. En transmettant cette information au copilote avant de commencer la conversation, il peut avoir une conversation plus intelligente avec le client sans avoir à lui redemander son nom.
Vous pouvez indiquer qu’une variable peut obtenir ses valeurs à partir d’une source externe. Ouvrez le volet Propriétés de la variable et cochez la case Les sources externes peuvent définir des valeurs dans la section Utilisation.
Pour en savoir plus sur l’utilisation de variables de copilote, consultez Réutiliser des variables dans des rubriques.