Outil de Conversation
Créez un outil que l'IA peut utiliser lors des conversations. L'IA décide quand l'appeler en fonction du contexte.
Quand l'Utiliser
Utilisez ce déclencheur pour étendre ce que votre IA peut faire :
- Rechercher des produits dans votre catalogue
- Vérifier le statut des commandes dans votre système
- Consulter les données clients dans le CRM
- Créer des tickets de support dans JIRA
- Prendre des rendez-vous
- Toute capacité personnalisée
Configuration
Paramètres de Base
| Champ | Description |
|---|---|
| Nom de l'Outil | Nom lisible par l'homme (affiché dans la Bibliothèque de Nœuds) |
| Description | Explique quand/comment l'IA doit utiliser cet outil |
Ciblage des Utilisateurs
Choisissez qui peut utiliser cet outil :
| Option | Description |
|---|---|
| Tous les Utilisateurs | Utilisateurs anonymes + connectés |
| Utilisateurs Connectés Uniquement | Seulement les utilisateurs connectés |
| Accès Basé sur les Rôles | Rôles d'utilisateur spécifiques |
Variables de l'Outil
Définissez les paramètres que l'IA doit collecter auprès de l'utilisateur :
| Champ | Description |
|---|---|
| Nom de la Variable | Nom interne (par exemple, query, orderId) |
| Description | Aide l'IA à comprendre ce qu'il faut demander |
Les variables deviennent disponibles sous la forme {{variableName}} dans votre flux.
Comment Cela Fonctionne
- Vous définissez un outil avec un nom, une description et des variables
- L'IA apprend quand l'utiliser à partir de votre description
- L'utilisateur demande quelque chose de lié (par exemple, "Trouvez-moi un ordinateur portable")
- L'IA collecte les variables requises de manière conversationnelle
- Le flux s'exécute avec les données collectées
- Le résultat est renvoyé à l'IA pour la réponse finale
Nommer Vos Outils : Pourquoi C'est Important
Lorsque votre assistant IA a accès à plusieurs outils, il choisit lequel appeler en fonction de trois choses seulement : le nom de l'outil, la description de l'outil et les descriptions des variables. Il ne peut pas voir ce qui se trouve à l'intérieur du flux — il lit le texte et décide.
Si ces trois champs sont vagues ou trop similaires entre les outils, l'IA choisira le mauvais outil. Des études sur l'appel de fonction LLM montrent qu'améliorer la clarté de la description peut augmenter la sélection correcte de l'outil de 15 à 20 points de pourcentage, sans changer le modèle sous-jacent.
C'est particulièrement critique lorsque vous avez plusieurs outils qui recherchent différentes bases de connaissances — du point de vue de l'IA, ils "recherchent tous des informations." Le nom et la description sont le seul moyen de les distinguer.
Nom de l'Outil
Utilisez le modèle domaine_action_cible afin que le nom seul distingue chaque outil :
| ❌ Vague | ✅ Clair |
|---|---|
Rechercher | rgpd_analyse_juridique |
search_docs | ecommerce_recherche_produit |
Outil 2 | support_ticket_lookup |
L'IA utilise le nom comme premier filtre avant de lire la description. Un nom clair lui permet de présélectionner instantanément ; un nom générique l'oblige à deviner.
Description de l'Outil
La description est votre levier le plus puissant. Utilisez cette formule :
[Ce qu'il fait — 1 phrase]
Utiliser pour : [3–5 cas d'utilisation concrets avec les mots que vos utilisateurs diraient réellement]
❌ Mauvais :
Rechercher dans la base de connaissances des informations.
✅ Bon :
Recherche des sanctions de la CNIL et de la jurisprudence du CJUE.
Utiliser pour : trouver des décisions de sanction par secteur ou type de violation,
consulter les montants des amendes, citer des précédents juridiques,
évaluer le risque financier de non-conformité au RGPD.
Les mots à l'intérieur de "Utiliser pour" agissent comme des déclencheurs sémantiques. Lorsque le message d'un utilisateur contient "amende", "sanction" ou "risque", l'IA l'associe immédiatement à cet outil.
Descriptions des Variables
Une variable décrite comme "La requête de recherche" ne dit rien à l'IA. Elle collera la question brute de l'utilisateur à chaque fois. Une meilleure description guide l'IA pour extraire les bons mots-clés avant de les envoyer.
| ❌ Vague | ✅ Clair |
|---|---|
La requête de recherche | Requête de recherche : type de violation, nom de l'entreprise, secteur, montant de l'amende ou concept juridique |
Entrée utilisateur | Type de document demandé : modèle, modèle, formulaire, clause ou contrat |
Cela pousse l'IA à reformuler au lieu de copier l'intégralité du message de l'utilisateur — ce qui entraîne des recherches plus ciblées et de meilleurs résultats.
Éviter les Conflits d'Outils
Lorsque deux outils peuvent répondre à la même question, l'IA hésite — et parfois choisit au hasard. Chaque outil doit couvrir un territoire exclusif.
La règle : si vous pouvez penser à une question d'utilisateur qui pourrait aller à l'un ou l'autre outil, vos descriptions ont besoin de plus de précision.
Exemple — 5 outils de conformité avec des frontières claires :
| Outil | Couvre | Ne couvre PAS |
|---|---|---|
compliance_analyse_juridique | Articles de loi, obligations légales, droits | Pas de conseils pratiques, pas de cas concrets |
compliance_methodologie | Guides étape par étape, procédures d'audit, cadres | Pas de texte juridique, pas de modèles |
compliance_modeles_documentaires | Modèles prêts à l'emploi, formulaires, clauses de contrat | Pas de méthodologie, pas d'analyse juridique |
compliance_processus_entreprise | Flux de travail opérationnels, circuits d'approbation | Pas de texte juridique, uniquement des processus internes |
compliance_solutions_operationnelles | Solutions concrètes, recommandations techniques | Pas de théorie, uniquement des solutions actionnables |
Plus chaque description est spécifique sur ce que l'outil couvre, moins il y a d'ambiguïté. Vous n'avez pas besoin d'écrire des exclusions explicites — la précision fait le travail.
Liste de Vérification Rapide
Avant de publier un flux avec un déclencheur d'Outil de Conversation, vérifiez :
- Nom suit
domaine_action_cible— distinct sans lire la description - Description commence par ce que fait l'outil en 1 phrase
- Description inclut "Utiliser pour :" avec 3–5 cas d'utilisation concrets
- Descriptions des variables listent les types d'informations attendues, pas seulement "la requête"
- Pas de chevauchement avec le territoire d'un autre outil
- Testé avec 2–3 questions ambiguës dans le panneau de Test pour confirmer le routage correct
Exemple : Recherche de Produit
Configuration de l'Outil :
- Nom :
ecommerce_recherche_produit - Description : Recherche dans le catalogue de produits par nom, catégorie ou caractéristique. Utiliser pour : trouver un produit spécifique, comparer des produits dans une catégorie, vérifier si un produit existe, consulter les spécifications ou les prix d'un produit.
- Variable :
query— "Nom du produit, catégorie, caractéristique ou gamme de prix à rechercher"
Flux :
- Déclencheur : Outil de Conversation
- Action : Rechercher dans la Base de Connaissances (
{{query}}) - Action : Définir l'Observation (retourner les résultats)
Conversation utilisateur :
Utilisateur : "Avez-vous des écouteurs sans fil ?"
IA : appelle ecommerce_recherche_produit avec query="écouteurs sans fil"
IA : "Oui ! J'ai trouvé 3 écouteurs sans fil. Le Sony WH-1000XM5 est notre best-seller à 349 €..."
Exemple : Ticket JIRA
Configuration de l'Outil :
- Nom :
support_creer_ticket_jira - Description : Crée un ticket de support JIRA à partir de la conversation. Utiliser pour : lorsque l'utilisateur signale un bug, demande une fonctionnalité ou doit escalader un problème à l'équipe technique.
- Variables :
title— "Résumé court du problème (1 phrase)",description— "Description détaillée incluant les étapes pour reproduire, le comportement attendu et le comportement réel"
Flux :
- Déclencheur : Outil de Conversation
- Action : Demande IA (générer titre/description)
- Parallèle : Générer description + titre
- Action : JIRA Créer un Problème
