Outils : connecter l'agent à vos propres systèmes

À quoi sert un outil

Un outil est une adresse HTTPS qui fonctionne sur votre système (un point d'accès d'API). L'agent l'appelle au besoin pendant une conversation : par exemple pour lire les disponibilités de rendez-vous, le statut d'une livraison ou le solde d'un client dans votre système.

Utilisez un outil pour tout système sans intégration prête à l'emploi. Ouvrez « Outils » depuis le menu ; ajouter, modifier, supprimer et tester des outils demandent le rôle propriétaire ou administrateur.

Ajouter un nouvel outil

1. Appuyez sur « Nouvel outil ».
2. Écrivez le « Nom de l'outil » en minuscules avec des tirets bas, par exemple check_availability.
3. Sous « Quand faut-il l'utiliser ? », décrivez clairement ce que fait l'outil et pour quelles questions il doit être appelé. L'agent décide quand l'appeler à partir de cette description.
4. Saisissez la méthode (GET ou POST) et l'adresse. L'adresse doit commencer par https ; les adresses locales et de réseau privé sont refusées.
5. Utilisez « Ajouter un champ » pour définir les champs attendus par l'outil : nom, type, description et caractère obligatoire. L'agent remplit ces champs à partir de la conversation. Les types sont expliqués plus bas.
6. Choisissez l'« Authentification » : aucune, jeton Bearer ou en-tête personnalisé (avec son nom). Le secret est conservé sur le serveur et n'est plus jamais affiché ; laissez-le vide en modification pour garder la valeur enregistrée.
7. Avant d'enregistrer, essayez avec des valeurs d'exemple grâce à « Appel de test » ; vous voyez tout de suite la réponse ou l'erreur.

Types de champs et champs imbriqués

Chaque champ a un type, et la valeur est envoyée à votre point d'accès dans ce type. Par exemple, un champ « Oui/Non » est envoyé comme true, pas comme le texte « true », et un champ « Nombre » saisi 1,234.5 est envoyé comme 1234.5.

• Texte, Nombre, Oui/Non : une seule valeur. Un champ Oui/Non comprend yes, no, true, false, 1 et 0.
• Date : vous pouvez écrire 06.10.2026 (jour d'abord) ou 2026-10-06 ; elle est envoyée comme 2026-10-06. Date et heure : par exemple 06.10.2026 14:30 ; envoyé comme 2026-10-06T14:30:00.
• Objet : un groupe avec ses propres sous-champs, par exemple un client (nom, e-mail). Sans sous-champs, la valeur est envoyée telle quelle, en JSON libre.
• Liste : plusieurs valeurs. Choisissez le « Type d'élément » ; si l'élément est un Objet, définissez ses champs, par exemple des lignes de commande (ID produit, quantité).

Les champs peuvent être imbriqués jusqu'à 5 niveaux. Objet et Liste ne peuvent être choisis que pour les outils POST ; une requête GET ne peut pas porter de données imbriquées.

Sur les outils POST, un « Exemple de corps » apparaît sous les champs : la forme du corps JSON que recevra votre point d'accès. Vous pouvez le comparer à ce qu'attend votre point d'accès. Dans l'« Appel de test », chaque champ a une saisie adaptée à son type ; les champs Objet et Liste s'ouvrent préremplis avec l'exemple de corps.

Si une valeur ne correspond pas au type de son champ (par exemple « beaucoup » dans un champ Nombre) ou si un champ obligatoire est vide, la requête n'est pas envoyée ; l'erreur indique de quel champ il s'agit, par exemple items[1].id (le champ id du deuxième élément).

Outils qui modifient des données

Si l'outil modifie quelque chose dans votre système (création d'un enregistrement, annulation, etc.), cochez « Cet outil modifie des données ». Ces outils ne sont jamais réessayés avec d'autres valeurs, et chaque appel est journalisé. Ils apparaissent dans la liste avec un badge « Modifie des données ».

Utiliser un outil dans un agent

• Dans l'onglet « Outils » de l'étape Assistant IA, choisissez les outils accessibles à l'agent : tous (y compris ceux ajoutés plus tard) ou ceux que vous sélectionnez.
• Une étape « Sélection » peut charger ses options depuis un outil ; par exemple, les créneaux libres sont listés sous forme de cartes.
• Une étape « Appel d'outil » appelle l'outil à un point précis du flux, sans IA, et enregistre la réponse dans une variable.

Voir les articles Étape Assistant IA, Étape Sélection et Étape Appel d'outil.

Gérer la liste

Cherchez des outils par nom ou description, et filtrez par méthode et type d'authentification. Les outils en panne portent un badge « En échec ». Quand vous supprimez un outil, l'agent cesse de l'appeler.