Faire agir votre chatbot, pas seulement parler
Votre chatbot répond bien, mais il ne fait rien. Un visiteur demande à voir vos tarifs : il décrit la page au lieu de l'ouvrir. Une question factuelle : il récite de mémoire au lieu de chercher. Un visiteur chaud se déclare : la conversation se termine et vous n'avez ni son nom ni son email. Un chatbot qui parle sans agir, c'est un vendeur qui indique le rayon sans jamais s'y rendre.
Cette masterclass vous donne la méthode du tool use : le partage du travail entre le modèle et votre code, vos trois premiers outils (naviguer, chercher, collecter), des descriptions qui déclenchent au bon moment, et la règle de retenue qui empêche votre chatbot de dégainer pour rien.
Ce que cet exercice ne peut pas casser
Tout commence sur une feuille : trois colonnes, trois outils, zéro ligne de code. Vous ne touchez pas à votre chatbot en production avant d'avoir une fiche d'outils qui tient debout. Et quand vous passerez au code, le modèle ne fera jamais rien lui-même : c'est votre code qui exécute, donc c'est vous qui gardez la main.
Ce que vous saurez faire à la fin
- Décrire vos trois premiers outils (naviguer, chercher, collecter) sur une fiche en trois colonnes : le nom en verbe, la phrase qui déclenche, les informations reçues.
- Expliquer le partage du travail : le modèle décide quel outil appeler, votre code l'exécute et lui renvoie le résultat.
- Cadrer l'usage des outils dans votre prompt système avec la règle de retenue : un seul outil par message, et dans le doute, répondre sans outil.
- Diagnostiquer un outil qui se déclenche au mauvais moment : resserrer sa description, pas réécrire votre code.
- Niveau membre· le prompt prêt à coller qui transforme votre fiche d'outils en déclarations techniques, boucle d'exécution et bloc de prompt système.
- Niveau Pro· je branche les outils avec vous sur votre vrai chatbot et je règle les déclenchements en direct.
Le modèle décide, votre code exécute, et la boucle tourne jusqu'à ce que le modèle ait fini de parler, sous garde-fou.
Le modèle décide, votre code exécute
Le tool use (l'API Claude parle aussi de function calling) repose sur un malentendu à dissiper d'abord : le modèle n'exécute jamais rien lui-même. Il demande un outil, votre code l'exécute, et lui renvoie le résultat. Toute la méthode découle de ce partage : bien décrire les outils pour qu'il demande au bon moment, bien construire la boucle pour que votre code réponde, et bien cadrer le prompt pour qu'il sache se retenir.
1Le partage du travail entre le modèle et votre codedoute : « le modèle va-t-il faire n'importe quoi sur mon site ? »
Non, parce qu'il ne fait rien du tout. Le modèle lit la conversation, décide qu'un outil serait utile, et formule une demande : quel outil, avec quelles informations. C'est votre code qui reçoit cette demande, qui exécute (ou refuse), et qui renvoie le résultat. Le modèle décide, votre code exécute : la frontière de sécurité reste entièrement chez vous.
2Vos trois premiers outils : naviguer, chercher, collecterdoute : « par quoi commencer ? »
Trois outils couvrent l'essentiel d'un chatbot de site. La navigation : ouvrir une page précise quand le visiteur la demande (elle s'exécute côté client, dans le navigateur). La recherche : trouver la réponse à une question factuelle au lieu de réciter (côté serveur). La collecte : enregistrer les coordonnées d'un visiteur qualifié avant qu'il ne disparaisse (côté serveur aussi). À la main : pour chacun, une ligne sur votre fiche en trois colonnes. Le nom en verbe, la phrase de visiteur qui doit le déclencher, les informations qu'il reçoit. Exemple : ouvrir-page / quand le visiteur veut voir une page précise / l'adresse de la page.
3Des descriptions qui disent quoi ET quanddoute : « comment le modèle sait-il quel outil prendre ? »
Il lit les descriptions, rien d'autre. Chaque outil est déclaré avec un nom explicite, une description et un schéma de paramètres : c'est sur la description que le modèle s'appuie pour décider. Elle doit donc préciser deux choses : à quoi l'outil sert, et quand l'employer. C'est la règle de diagnostic la plus rentable de toute la masterclass : si un outil se déclenche au mauvais moment, c'est sa description qu'il faut resserrer, pas votre code.
4La boucle d'exécution et son garde-foudoute : « et si ça tourne sans fin ? »
Côté code, le tool use est une boucle : détecter que le modèle demande un outil, l'exécuter (côté serveur pour la recherche et la collecte, côté client pour la navigation), renvoyer le résultat au modèle, et recommencer jusqu'à ce qu'il ait fini de parler. Cette boucle exige un garde-fou : un compteur qui limite le nombre d'outils enchaînés par tour. Sans lui, un modèle qui hésite peut enchaîner les appels sans jamais conclure.
5La règle de retenue dans votre prompt systèmedoute : « le chatbot ne va-t-il pas dégainer un outil pour rien ? »
C'est le dernier bloc : une section de votre prompt système qui liste vos outils, le moment où chacun devient pertinent, et la règle de retenue : un seul outil par message, et dans le doute, répondre sans outil. Le test final est simple : une demande de page déclenche la navigation, une question factuelle la recherche, un visiteur qualifié la collecte, et une question hors sujet (quel temps fait-il ?) ne déclenche rien du tout.
À vous de jouer : votre fiche d'outils
Prenez une feuille, trois colonnes : le nom en verbe, la phrase qui déclenche, ce que l'outil reçoit. Une ligne par outil.
Le résultat, en 30 secondes
À partir de votre seule fiche, le prompt produit quatre blocs : vos outils déclarés au format attendu par l'API Claude, votre boucle d'exécution décrite en clair avec son garde-fou, la section à ajouter à votre prompt système, et la liste des questions qu'il lui reste à vous poser.
Outil ouvrir-page, déclaré : une description qui précise « ouvre une page du site quand le visiteur demande explicitement à la voir », un paramètre requis (l'adresse de la page), et une ligne en dessous : le modèle le déclenchera sur « montrez-moi vos tarifs », pas sur une question générale. Plus bas : la boucle d'exécution étape par étape, le compteur d'outils par tour, le bloc de prompt système avec la règle de retenue, et une question ouverte : quel est le framework de votre site ?
Le prompt prêt à coller
# RÔLE Tu es un ingénieur spécialisé dans l'intégration de l'API Claude, en particulier le tool use (function calling). Tu es rigoureux et pédagogue : tu expliques chaque choix en une phrase simple. Tu ne t'appuies QUE sur ce que je te donne. Ce qui te manque pour produire un outil correct, tu me le demandes au lieu de l'inventer. Si une description d'outil est ambiguë, tu signales le risque plutôt que de combler par une supposition. # CONTEXTE Je construis ou j'améliore un chatbot propulsé par l'API Claude, sur mon propre site. Je veux qu'il agisse (naviguer, chercher, collecter), pas seulement qu'il réponde. J'ai déjà un chatbot fonctionnel avec un appel API et un prompt système. Ma fiche d'outils (si je l'ai préparée, sinon je passe en mode interview) :
Le prompt transforme votre fiche d'outils en déclarations prêtes à coller, boucle d'exécution avec garde-fou et bloc de prompt système, et il passe en mode interview, question par question, si votre fiche n'est pas prête. Laissez votre email, je vous l'envoie.
Vérifiez que c'est à vous
Votre visiteur écrit « montrez-moi la page des tarifs » et le chatbot lance la recherche au lieu d'ouvrir la page. Que corrigez-vous en premier ?
D'abord avec vos mots, sans regarder les options :
Expliquez-le pour l'ancrer
En une phrase, à un confrère qui découvre le tool use : pourquoi le modèle ne fait-il jamais rien lui-même quand votre chatbot utilise un outil ? Si vous savez expliquer le partage du travail simplement, c'est à vous.
Ce que vous savez faire maintenant
- Décrire un outil par son nom en verbe, son déclencheur et ce qu'il reçoit, avant d'écrire la moindre ligne de code.
- Tracer la boucle d'exécution : le modèle demande, votre code exécute au bon endroit (client ou serveur), le résultat revient, et un compteur empêche les enchaînements sans fin.
- Corriger un déclenchement raté par la description de l'outil, jamais par le code.
- Imposer la retenue dans le prompt système : un seul outil par message, et dans le doute, aucun.
Le modèle décide, votre code exécute : si un outil se déclenche au mauvais moment, c'est sa description qu'il faut resserrer, pas votre code.
Continuez seul
Vous avez tout pour préparer votre fiche d'outils. Pour continuer :
Toutes les masterclass →Faites-le avec moi
Je branche les outils avec vous, sur votre vrai chatbot : déclarations, boucle, garde-fou, et les tests de déclenchement en direct, jusqu'à ce qu'une question hors sujet ne déclenche plus rien.