Présentation des Bot Actions
Une Bot Action est un composant qui vous permet de programmer des conditions logiques menant à des réponses et de relier des User Actions pour construire des parcours conversationnels complexes. Les Bot Actions sont généralement déclenchées par des Intents, mais peuvent aussi être activées par un filtre.
📌 Remarque :
Il n'y a aucune différence technique entre une « Start Bot Action » et une « Bot action » standard.
Exécution d'une Bot Action
Une Bot Action est exécutée selon les règles suivantes :
API Calls : exécutés dans l'ordre des API connections.
Conditions : évaluées de haut en bas. La première condition remplie détermine la réponse affichée à l'utilisateur.
API Connections
Tutoriel vidéo
Regardez un tutoriel pas à pas sur l'intégration d'API externes à votre plateforme de bots ViaSay dans la section Tutoriels vidéo.
Quand utiliser les API Connections
Utilisez les API connections pour interagir avec des systèmes externes via des API web ou avec une Knowledge Base hébergée par ViaSay.
Ajouter une API Connection
Cliquez sur Add an API Connection.
Sélectionnez une API (remarque : configurez d'abord l'API dans la section Integrate/APIs).
Exécution en parallèle
Par défaut, les appels d'API sont exécutés les uns après les autres. Activez le paramètre « Run in Parallel » pour exécuter plusieurs connexions simultanément. Notez qu'en mode parallèle, l'ordre d'exécution ne peut pas être contrôlé.
Entrées et sorties
Entrées : définissez les champs d'entrée pris en charge par l'API. Pour les entrées obligatoires :
Utilisez un nom de variable issu du contexte du bot.
Envoyez les valeurs fixes sous forme de chaînes de caractères.
Envoyez du JSON en le convertissant en chaîne, puis en le reconvertissant à l'aide des filtres et fonctions Jinja.
Sorties : attribuez des noms de variables à la réponse de l'API pour qu'elle apparaisse dans le contexte du bot. Évitez les conflits entre variables de sortie.
Entrée par défaut : "status_code" (stocke le code de statut de l'API).
Boucles
Activez les boucles pour les appels d'API répétitifs :
For : indiquez la variable d'entrée qui change.
In : définissez la liste d'éléments sur laquelle boucler (utilisez JMESPath).
Les boucles sont limitées à 8 appels par API.
Conditions et Answers
Conditions
Instructions IF : utilisez Jinja pour écrire les conditions. Vous pouvez utiliser des variables, des fonctions et les extensions ViaSay. Pour une exécution sans condition, utilisez IF True.
Go To : dirigez l'utilisateur vers un autre nœud du graphe conversationnel. Les options sont :
Start User Action : redirige vers le début d'un autre Use Case.
Current User Action : maintient l'utilisateur dans l'action en cours (par exemple après une réponse d'incompréhension).
Erase : définissez les variables à effacer après l'exécution. Les options sont :
"erase_all": réinitialise le contexte."erase_all_except variable1, variable2": conserve les variables indiquées.
Events : déclenchez des événements pour les analyses lorsqu'une condition est remplie.
Schedulers
Ajoutez des Schedulers en cliquant sur l'icône d'action.
Answers
Les Answers sont les messages affichés aux utilisateurs après l'exécution d'une Bot Action. Elles sont déclenchées par les conditions des Bot Actions.