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 agents 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 l’agent se souvienne du nom et de l’adresse e-mail du client. Dans Microsoft Copilot Studio, ces variables sont appelées variables d’agent. Elles sont accessibles par toute rubrique dans l’agent.
Les variables d’agent 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 d’agent pour les distinguer des variables de niveau rubrique.
Créer une variable d’agent
Pour définir une variable en tant que variable d’agent, 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 Globale (toutes les rubriques peuvent y accéder). Le nom de la variable se voit alors affecter une chaîne de préfixe agent pour le différencier des variables de niveau rubrique.
Par exemple, la variable UserName s’affiche désormais comme Global.UserName. Lorsque vous convertissez une variable en variable d’agent, 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 agent.
Définir des variables d’agent
Une fois qu’une variable d’agent 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 d’agent sont regroupées dans le menu des variables, car elles commencent toutes par le terme « agent ».
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 d’agent qui y sont disponibles.
Gérer les variables d’agent
Après avoir créé une variable d’agent à 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 nouvel agent 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 :
Référence : 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 d’agent à partir de sources externes
Vous pouvez définir une variable d’agent à initialiser avec une source externe. Ainsi, l’agent 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 à l’agent 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 d’agent, consultez Réutiliser des variables dans des rubriques.