Passer au contenu principal

Vue d’ensemble

Le sélecteur de données constitue l’interface principale pour accéder aux variables extraites dans les noeuds précédents de votre graphe. Cette fonctionnalité s’active automatiquement au focus dans les champs de formulaire marqués de l’icône , indiquant la possibilité d’injection de variables dynamiques.

Interface

L’interface du sélecteur de données se compose de plusieurs éléments clés :
  • Panneau de sélection des variables : Zone d’affichage des variables disponibles selon le mode choisi
  • Commutateur de mode : Bouton à bascule pour basculer entre les modes Contexte global et Variables scopées par noeud
  • Bouton d’ajout : Confirmation de l’injection de la variable dans le champ cible
TruePath propose deux modes distincts de sélection des variables, chacun adapté à des besoins spécifiques d’utilisation.

Mode contexte global

Le mode contexte global agrège automatiquement toutes les variables extraites dans l’ensemble des noeuds précédents du graphe conversationnel. Cette approche offre une vision unifiée des données collectées avec les caractéristiques suivantes :

Fonctionnement

  • Agrégation automatique : Collecte de toutes les variables depuis le début du graphe
  • Conservation de la dernière version : En cas de variables homonymes, le système conserve la valeur la plus récente
  • Accès simplifié : Interface unique présentant toutes les variables disponibles sans référence aux noeuds source

Exemple de configuration avancée

Dans un scénario de prise de rendez-vous avec plusieurs tentatives de modification :
Noeud 3. Prise de rendez-vous initial
├── appointmentDay → "lundi"
├── appointmentTime → "14:00"

Noeud 7. Modification de la prise de rendez-vous
├── appointmentDay → "mercredi"
├── appointmentTime → "16:00"
Le mode global permet de choisir la dernière version d’une variable.

Variables système disponibles

Le mode global inclut automatiquement des variables système essentielles.

Variable système

Retrouver les variable système disponibles

Mode scopé par noeud

Le mode variables scopées par noeud offre un accès granulaire aux variables en préservant leur contexte d’extraction spécifique à chaque noeud. Cette approche permet un contrôle précis sur l’origine des données utilisées.

Fonctionnement

  • Conservation du contexte : Maintien de la valeur d’une variable au moment exact de son extraction
  • Sélection par noeud : Possibilité de choisir la version d’une variable selon le noeud source
  • Traçabilité complète : Identification claire de l’origine de chaque variable

Structure d’organisation

Le mode scopé organise les variables selon une hiérarchie claire :
Noeud Source
├── Variable 1
├── Variable 2
└── Variable n

Exemple de configuration avancée

Dans un scénario de prise de rendez-vous avec plusieurs tentatives de modification :
Noeud 3. Prise de rendez-vous initial
├── appointmentDay → "lundi"
├── appointmentTime → "14:00"

Noeud 7. Modification de la prise de rendez-vous
├── appointmentDay → "mercredi"
├── appointmentTime → "16:00"
Le mode scopé permet de choisir précisément quelle version utiliser selon le contexte métier.

Injection de variables dans les formulaires

Champs dynamiques

Les champs marqués de l’icône dans les formulaires TruePath supportent l’injection dynamique de variables. Ces champs peuvent contenir :
  • Variables pures : Injection directe d’une variable ({appointmentDay})
  • Texte mixte : Combinaison de texte fixe et de variables ("Votre rendez-vous du {appointmentDay} à {appointmentTime}")
  • Variables système : Utilisation des données contextuelles ("Appel reçu le {system.date}")
L’injection de variables fonctionne uniquement si la variable a été ajouté depuis le sélecteur de données. L’injection manuelle de texte entre accolades {} n’est pas supportée.

Processus d’injection

  1. Identification du champ : Clic sur un champ marqué de l’icône
  2. Activation du sélecteur de données : Ouverture automatique du panneau de sélection
  3. Choix du mode : Sélection entre Global Context et Scoped by Node
  4. Sélection de la variable : Choix de la variable appropriée
  5. Validation : Confirmation via le bouton “Add”

Bonnes pratiques pour l’utilisation des variables

  • Utilisez le mode context global pour les graphes simples et les données système
  • Privilégiez le mode scopé pour les logiques métier complexes
  • Testez systématiquement l’injection de variables avant publication
  • Utilisez des noms de variables explicites pour améliorer la lisibilité