Les AI Tools vous permettent de définir des connexions à des API externes que votre assistant IA (prompts Specialist) peut appeler pendant les conversations. Au lieu de coder en dur les appels d'API dans votre parcours, c'est l'IA qui décide quand et comment utiliser chaque outil, selon le contexte de la conversation.
Rendez-vous dans Integrate > AI Tools pour accéder à la fonctionnalité.
📘 Fonctionnalité en bêta AI Tools est actuellement en bêta. La fonctionnalité est disponible pour les bots sur lesquels AI Specialist est activé.
Vue d'ensemble
La page AI Tools liste toutes vos définitions d'outils. Les outils sont répartis dans deux onglets :
Tools : les outils de type API, qui appellent des endpoints externes
Auth Tokens : les jetons d'authentification HTTP utilisés par vos outils d'API
Vous pouvez rechercher des outils par nom et les trier par nom, type, description, date de dernière modification ou auteur.
Chaque outil affiche sa méthode HTTP sous forme d'étiquette (GET, POST, PUT, DELETE).
Créer un outil
Cliquez sur Add a New Tool pour ouvrir l'assistant de création. Il vous guide en quatre étapes.
Étape 1 — About
Renseignez les informations de base qui aident l'IA à comprendre quand et pourquoi utiliser cet outil.
Tool Name : utilisez une formule verbe + nom (par ex. « Check Flight Status », « Get Order Details »)
Description : décrivez le problème précis que cet outil résout
📘 Comment l'IA utilise ces informations Contrairement à un logiciel classique, les champs Name et Description ne sont pas de simples libellés : ce sont des instructions. L'IA les lit pour décider si elle doit utiliser cet outil pendant une conversation, et à quel moment.
Étape 2 — API Connection
Configurez la façon dont l'outil appelle votre API externe.
Collecter les données d'entrée
Définissez les paramètres que votre outil attend de la conversation. Pour chaque paramètre, indiquez :
Name : le nom de la variable (par ex.
order_id,flight_number)Format : Text, Number, Integer, Boolean, Enum, Array ou Object
Required or Optional : les paramètres obligatoires utilisent la syntaxe
${variable}, les paramètres facultatifs la syntaxe?{variable}Description : aide l'IA à comprendre quelle information recueillir auprès de l'utilisateur
Méthode HTTP
Choisissez la méthode de votre requête d'API : GET, POST, PUT ou DELETE.
URL
Saisissez l'URL de l'endpoint. Vous pouvez y insérer vos données d'entrée et les variables de votre bot grâce au sélecteur de variables (icône en forme d'accolades). Les variables apparaissent sous forme de badges dans le champ URL.
Exemple : https://api.example.com/orders/${order_id}
En-têtes
Ajoutez des en-têtes à votre requête. Deux types sont disponibles :
Key-value pair : en-tête standard (par ex.
Content-Type: application/json)HTTP Authentication token : fait référence à un jeton d'authentification préconfiguré (voir Auth Tokens plus bas)
Corps de la requête
Pour les requêtes POST/PUT, fournissez le corps de la requête en JSON. Vous pouvez là aussi y insérer des variables. Vous pouvez saisir le corps ou le coller : le contenu collé est conservé tel quel, et les variables qu'il contient s'affichent en badges.
Variables de plateforme
En plus des données d'entrée recueillies par l'IA, un outil peut envoyer à votre API les variables de votre bot. Ouvrez le sélecteur de variables (icône en forme d'accolades) dans l'URL, un en-tête ou le corps de la requête. La liste comporte deux groupes :
Data inputs : les valeurs que l'IA recueille dans la conversation. Elles utilisent la syntaxe
${variable}ou?{variable}.Platform variables : les variables custom, user channel et system de votre bot. Elles utilisent la syntaxe
#{variable}.
Quand l'outil s'exécute, chaque variable de plateforme est remplacée par sa valeur dans la conversation en cours. L'IA ne choisit ni ne modifie ces valeurs. Utilisez-les pour les données qui doivent arriver telles quelles à votre API, par exemple :
un identifiant client envoyé par votre site quand le visiteur est connecté (variable user channel)
la langue de la conversation (variable system)
un niveau de fidélité défini plus tôt dans le parcours par une étape Data Manipulation (variable custom)
Chaque variable apparaît sous forme de badge, avec une couleur par catégorie. Les variables ne peuvent pas être saisies à la main : choisissez-les dans la liste, ou collez un corps de requête qui en contient : elles s'affichent aussi en badges. Une variable qui n'existe plus est signalée dans le champ, et l'outil reçoit une valeur vide à sa place.
Les variables de plateforme sont aussi disponibles dans l'URL, les en-têtes et le corps de vos Auth Tokens.
📘 Voir les valeurs dans la trace Dans la trace d'une conversation, chaque appel d'outil liste les valeurs qu'il a reçues : les données d'entrée remplies par l'IA et les variables de plateforme résolues par la plateforme. Voir Trace dans le Flow Builder.
Étape 3 — Test Response
Avant la mise en production, testez votre outil sur le véritable endpoint de l'API.
Saisissez une valeur de test pour chaque donnée d'entrée et chaque variable de plateforme utilisée par l'outil
Cliquez sur Test request pour exécuter l'appel
Examinez la réponse JSON brute pour vérifier qu'elle est correcte
Si le test réussit, un bandeau vert « Successful response received (200 OK) » s'affiche avec le corps complet de la réponse.
Vous pouvez passer cette étape, mais il est fortement recommandé de tester pour :
Vérifier que la connexion fonctionne correctement
Filtrer les données sensibles de la réponse
Associer les résultats de l'API à des variables ViaSay utilisables dans votre parcours
⚠️ Passer le test Si vous passez cette étape, vous risquez de ne pas pouvoir vérifier la connexion, filtrer les données sensibles de la réponse ni associer les résultats de l'API à des variables ViaSay.
Étape 4 — Data Access
Choisissez les champs de la réponse de l'API auxquels l'IA peut accéder.
Full data access : l'IA voit l'intégralité de la réponse JSON
Manually restrict access : sélectionnez les champs précis à exclure de ce que l'IA reçoit
C'est utile pour empêcher l'IA d'accéder à des données sensibles (par ex. identifiants internes, jetons ou informations privées sur les clients).
Auth Tokens
Pour les API qui exigent une authentification, vous pouvez configurer des jetons d'authentification HTTP.
Ouvrez l'onglet Auth Tokens de la page AI Tools, ou ajoutez-en un directement depuis l'étape API Connection via Add a header > HTTP Authentication token.
Configurez les éléments suivants :
Token title : un nom pour identifier ce jeton (par ex. « Booking API Auth »)
Description : description facultative
HTTP Method / URL / Headers / Body : l'endpoint d'authentification à appeler
Token configuration :
Access Token Field : le champ de la réponse qui contient le jeton (par ex.
access_token)Header Token Key : la clé d'en-tête dans laquelle envoyer le jeton (par ex.
Authorization)Token Type : le préfixe de la valeur du jeton (par ex.
Bearer)
Cliquez sur Test request pour vérifier que l'endpoint du jeton fonctionne, puis sur Save token.
Une fois enregistré, le jeton peut être utilisé dans la section Headers de n'importe quel outil. La plateforme appelle automatiquement l'endpoint du jeton et injecte le jeton dans vos requêtes d'API.
Associer des outils à une étape Gen AI
Une fois vos outils créés, vous pouvez les associer à n'importe quelle étape Gen AI dans le Flow Builder.
Ouvrez une étape Gen AI dans le Flow Builder
Ouvrez Create or Edit a prompt
Ouvrez Advanced Settings
Activez Tools
Sélectionnez des outils dans la liste déroulante (les outils de type jeton sont automatiquement exclus)
Cliquez sur un outil associé pour ouvrir son panneau de détail, où vous pouvez :
Consulter la description et les paramètres de l'outil
Accéder à la page de définition de l'outil via Edit tool
Ouvrir la fenêtre Test tool pour le tester avec des valeurs d'exemple
Configurer les correspondances Save output pour extraire des données de la réponse de l'outil vers des variables de conversation
Correspondance des sorties
Dans la section Save output, associez des champs de la réponse JSON de l'outil à des variables de conversation :
Cliquez sur + Add pour créer une nouvelle correspondance
Sélectionnez ou créez une variable de conversation
Saisissez une requête JMESPath pour extraire le champ voulu de la réponse
Exemple : pour extraire le statut du vol de {"status": "On Time", "gate": "B42"}, utilisez la requête JMESPath status.
Modifier et supprimer des outils
Modifier un outil
Dans la liste AI Tools, cliquez sur le menu d'actions (⋮) d'un outil et sélectionnez Edit. L'assistant s'ouvre, prérempli avec la configuration existante de l'outil.
Vous pouvez aussi accéder directement à la page de modification depuis le panneau de détail du Flow Builder, via le lien Edit tool.
⚠️ Modifier un outil affecte tous les prompts Quand vous modifiez un outil existant, les changements s'appliquent à tous les prompts auxquels cet outil est associé.
Supprimer un outil
Dans le menu d'actions, sélectionnez Delete. Une fenêtre de confirmation s'affiche. Cette action est irréversible.