Documentation Oracle Cloud Infrastructure

Autres types de variable

Outre les variables de flux et les variables globales, vous pouvez utiliser la portée utilisateur, le profil et les variables système.

Variables de portée de profil pour le contexte utilisateur

Vous pouvez accéder aux valeurs du nom, des paramètres régionaux et de l'heure locale d'un utilisateur à l'aide de variables de portée de profil, qui accèdent aux paramètres de profil à partir du client de discussion.

Par exemple :
"Hello ${profile.firstName}, how can I help you today?"

Il s'agit d'une image de profile.firstName dans la sortie.
Utilisez les variables prédéfinies suivantes pour générer les informations contextuelles de l'utilisateur de la brique.
Procédez comme suit... Utiliser...
Obtenir le prénom de l'utilisateur du bot ${profile.firstName}
Obtenir le nom de l'utilisateur du bot ${profile.lastName}
Obtenir l'environnement local de l'utilisateur du bot. ${profile.locale}
Obtenir le fuseau horaire de l'utilisateur (décalage en millisecondes) ${profile.timezoneOffset}

Ces variables prédéfinies sont établies automatiquement à partir des valeurs transmises par la plate-forme de messagerie. Les valeurs diffèrent selon la plate-forme de messagerie, et certaines de ces plates-formes peuvent ne pas en fournir. Pour les intégrations d'assistant numérique en tant qu'agent, par exemple, profile.firstName, profile.lastName et profile.email comprennent des valeurs uniquement si l'utilisateur s'est connecté à Oracle Service Cloud, ou si un utilisateur a renseigné les champs de prénom, de nom et d'adresse électronique sur la page de lancement de discussion Oracle Service Cloud avant de demander une discussion. Pour le client Oracle Web, ces valeurs de profil doivent être définies avec la propriété initUserProfile ou la méthode updateUser.

Enregistrer les valeurs spécifiques à l'utilisateur pour les visites ultérieures

Vous pouvez créer des variables de portée utilisateur pour les conserver d'une session à l'autre.

En général, lorsqu'une conversation utilisateur avec une brique ou un assistant numérique prend fin, les valeurs de variable définies à partir de la saisie utilisateur sont détruites. Toutefois, vous pouvez également définir des variables de portée utilisateur pour conserver les entrées utilisateur des sessions précédentes afin d'améliorer les nouvelles conversations. Vous créez des variables de portée utilisateur directement dans les composants eux-mêmes.

Pour créer une variable de portée utilisateur :

  1. Dans le champ Variable de l'inspecteur de propriétés du composant dans lequel vous souhaitez le créer, sélectionnez Variable de portée utilisateur dans la liste déroulante.
  2. Dans le champ Nom de la variable ciblée qui apparaît, entrez le nom de la variable.

    Entrez le nom sans le préfixe user.. (Bien que vous utilisiez ce préfixe lors du référencement d'une variable de portée utilisateur, vous ne l'utilisez pas lors de sa définition.)

Pour référencer une variable de portée utilisateur, vous utilisez une expression telle que ${user.VAR_NAME}.

Par exemple, dans l'exemple de brique Brique Pizza - Concepteur de flux visuel, la variable de portée utilisateur lastOrderNumber est définie une fois que l'utilisateur a placé l'ordre dans le flux service.reg.placeOrder. Cette variable est référencée par l'expression ${((user.lastOrderNumber)?has_content)} dans le premier état du flux appelé chaque fois que la brique démarre (handler.startSkill) afin de déterminer si l'utilisateur a effectué des commandes précédentes.

Remarque

Les valeurs des variables de portée utilisateur sont propres au canal. Par exemple, si un utilisateur accède à une brique sur un canal Web, puis y accède par la suite via un canal Microsoft Teams, le canal Teams aura ses propres instances des variables utilisateur et ne reconnaîtra pas les valeurs de la conversation précédente dans le canal Web.

Variables système

Variable Type Description
system.nlpresult Résultat du traitement du langage naturel Utilisé pour stocker le résultat du traitement du langage naturel pour la variation utilisateur. Pour obtenir le résultat du traitement du langage naturel complet, vous pouvez utiliser l'expression ${skill.system.nlpresult.value}.
system.intent.utterance Chaîne Lorsque cette variable a une valeur, elle est utilisée pour la mise en correspondance d'intention au lieu du dernier message utilisateur. Pour accéder à cette variable, vous pouvez utiliser l'expression ${skill.system.intent.utterance}.
system.event Correspondance Lorsque l'un des événements intégrés est mappé dans le flux principal ou un sous-flux, cette variable contient les propriétés d'événement que vous pouvez utiliser pour gérer l'événement. Par exemple, pour obtenir une charge utile d'événement, vous devez utiliser une expression au format ${skill.system.event.value.EVENT_NAME}.
system.rb regroupement de ressources Permet d'accéder aux entrées de groupe de ressources de langue. Pour accéder à une entrée de groupe de ressources, vous pouvez utiliser une expression au format ${skill.system.rb.RB_ENTRY_NAME}.