Brancher des outils sur un chatbot
| Projet | Durée | Difficulté | Âge |
|---|---|---|---|
| Youth AI Lab | 2 h (110 min + 10 min de marge) | Intermédiaire | Adultes (animateur·rices) |
Matériel
- Le dépôt de l'atelier, où l'on travaille : https://github.com/Youth-AI-Lab/yal-workshop-tools
- Les diapositives projetées par l'animateur·rice : https://youth-ai-lab.github.io/yal-workshop/4/
- La fiche animateur·rice (en anglais) : https://youth-ai-lab.github.io/yal-workshop/4/facilitator.html
- Par binôme : un ordinateur avec un navigateur, un compte GitHub, une clé d'API (elle commence par
sk-ant-pour Anthropic, parsk-or-pour OpenRouter), le fichiermy-work.zipsauvegardé à la fin de l'atelier 3, et l'adresse de la page officielle qui donne le niveau de danger feu de forêt de son territoire, s'il en existe une - Imprimés : la fiche d'une page
sheet.mddu dépôt (une par binôme) et les cartes de sortie (une par personne)
Cette série de six ateliers de 2 h s'adresse aux animateur·rices, avant tout usage avec des jeunes : on y construit, pièce par pièce, un chatbot sur la prévention des feux de forêt, pour comprendre ce qu'il y a derrière les cases Instructions et Knowledge d'un Claude Project ou d'un Gemini Gem. Dans cette fiche, les « participant·es » sont donc les animateur·rices qui suivent l'atelier, en binômes.
Les pages, les commandes et le Codespace sont en anglais ; cette fiche en est l'adaptation française. Les captures d'écran sont dans le dépôt de l'atelier.
- Atelier précédent : Laisser un chatbot chercher et lui apprendre des savoir-faire
- Atelier suivant : Organiser ce que sait un chatbot dans un wiki
Introduction
Jusqu'ici, le chatbot ne lisait que ce qui se trouvait déjà dans le Codespace : ses instructions, ses documents, ses skills. Mais certaines connaissances changent tous les jours, comme le niveau de danger feu de forêt, et aucun document ne peut les contenir. Aujourd'hui, on branche des outils sur le chatbot : des actions qu'il peut appeler pendant qu'il répond, et qui lui rapportent ce qu'elles trouvent. La question du jour :
Que se passe-t-il quand le chatbot agit à l'extérieur ?
Un document dit ce qui était vrai le jour où il a été écrit. Le niveau de danger feu de forêt, lui, est décidé chaque jour par une autorité, et le chatbot ne peut pas le deviner. Un outil comble ce manque : le modèle lui pose une question, l'outil répond par un fait, et le modèle s'en sert dans sa réponse.
Derrière un outil, il y a un programme qui tourne dans votre Codespace, avec vos droits : il peut y faire ce que vous pouvez y faire, comme ouvrir un fichier, le modifier ou lire votre clé. Les règles de AGENTS.md s'adressent au modèle, pas au programme : elles ne l'arrêtent donc pas. Certains outils envoient aussi ce que le modèle leur demande (un lieu, un mot) à un service sur Internet. Avant d'en brancher un, on lit donc ce qu'il fait, comme on regarde une application avant de l'installer sur son téléphone.
Un outil, enfin, ne rapporte que ce que contiennent ses données. L'outil de danger feu de forêt de l'atelier lit un fichier qu'une personne remplit, le jour même, à partir de la source officielle. Si personne ne l'a rempli, l'outil le dit, et ne donne aucun niveau.
Pendant toute la séance, on continue de tester le chatbot avec les mêmes questions : aujourd'hui, la colonne D, avec les questions 8, 11 et 12.
Le lien avec WikiYouthBot. La partie 2 donne au chatbot ce que les jeunes demandent souvent en premier : « Peut-on aller en forêt aujourd'hui ? ». Seule une source officielle peut y répondre, le jour même. La partie 4 donne la question à se poser avant toute activité avec un chatbot qui utilise des outils : qu'envoie-t-il à l'extérieur, et qui le lit ? La partie 5 met le même outil dans votre chatbot dans Open WebUI, en lecture seule, avec des sources publiques seulement (partie 5, étape 2). Une autre voie, pour les adultes, sans Claude Code : le guide Construire son chatbot avec OpenCode, partie 6.
La série avance une pièce du chatbot à la fois :
- Atelier 1 : les instructions, et comment tester un chatbot
- Atelier 2 : toutes les connaissances dans le contexte, puis un RAG
- Atelier 3 : le modèle cherche tout seul, et les skills
- Atelier 4 (celui-ci) : des outils qui apportent les faits du jour
- Atelier 5 : organiser ce qu'il sait dans un wiki, et emballer le chatbot de son territoire
- Atelier 6 : régler un petit modèle, pour trier les messages avant le chatbot
Structure de l'atelier
| Partie | Niveau | Durée |
|---|---|---|
| Partie 1 : Accueil | - | 20 min |
| Partie 2 : Notre outil, le niveau de danger du jour | ★★ | 20 min |
| Partie 3 : Des serveurs qui existent déjà | ★★ | 30 min |
| Partie 4 : Lire avant d'installer, citer sa source | ★★★ | 25 min |
| Partie 5 : Clôture | - | 15 min |
| Marge | - | 10 min |
Avant de commencer
Apporter my-work.zip, le fichier sauvegardé à la fin de l'atelier 3. Il contient le préprompt du binôme, sa question 12, ses documents, son résumé et sa skill. Sans lui, l'exemple du kit (Feurisson) devient le préprompt, et le document de Bénévent est ajouté automatiquement. Apporter aussi l'adresse de la page officielle qui donne le niveau de danger feu de forêt de son territoire, s'il en a une : en partie 4, on remplit son entrée dans le fichier de l'outil.
Les documents de référence sont tous dans le Codespace, dans la liste des fichiers à gauche :
mcp/fire-danger.json: les données de l'outil, une entrée par territoire. On le remplit aujourd'hui.mcp/fire_danger_server.py: le programme de l'outil, environ 160 lignes de Python..mcp.json: la liste des serveurs que branche le mode D, et comment chacun démarre.test-questions.mdetscores.md: le jeu de test et la feuille de notes. La façon de noter (0, 1 ou 2) est danstest-questions.md, section « How to score ».SETUP.md: mise en place, commandes et problèmes courants. La jauge (la ligne... / 200kau-dessus de la zone de saisie) y est expliquée à l'étape 4.
Glossaire
- Modèle : le programme d'IA qui lit le texte qu'on lui envoie et écrit la réponse. Aux ateliers 1 à 5, Claude Sonnet écrit les réponses avec une clé Anthropic, et
deepseek/deepseek-v4-flashavec une clé OpenRouter : le même pour tous les binômes qui ont ce type de clé. - Contexte : tout ce que le modèle lit avant de répondre (instructions, documents, conversation, résultats des outils). Sa taille est limitée.
- Jeton (token) : un morceau de mot. La taille du contexte se compte en jetons : 200k signifie 200 000 jetons.
- Jauge : la ligne au-dessus de la zone de saisie qui montre combien de jetons occupe le contexte. Avec OpenCode, c'est le compteur context du panneau latéral.
- Préprompt (ou instructions) : le texte, dans
AGENTS.md, qui dit au chatbot qui il est et quelles règles il suit. - Skill : une procédure écrite que le modèle peut suivre quand une demande correspond à sa description (vue à l'atelier 3).
- Outil : une action que le modèle peut appeler pendant qu'il répond, et qui lui rapporte un fait.
- Serveur MCP : le petit programme qui offre un ou plusieurs outils. Il tourne dans le Codespace.
- MCP (Model Context Protocol) : la manière commune de brancher un serveur sur un chatbot. Le même serveur peut se brancher sur Claude Code, sur OpenCode ou sur un autre programme qui fait tourner un chatbot.
- Description d'un outil : le texte qui dit au modèle à quoi sert l'outil. C'est d'après elle que le modèle décide de l'appeler.
- Codespace : un ordinateur prêté par GitHub, ouvert dans le navigateur avec l'éditeur VS Code. Rien à installer.
- Claude Code : le programme qui fait tourner le chatbot dans le terminal du Codespace. OpenCode est le second moteur possible, celui que choisit une clé OpenRouter.
- Mode D : le mode de l'atelier, lancé par
workshop D. C'est le mode C de l'atelier 3 (le modèle cherche dans les documents) plus des outils. replayetscore: les commandes qui reposent toutes les questions du jeu de test, puis les notent avec l'aide d'un juge (un modèle qui compare chaque réponse à la réponse attendue : un plus petit avec une clé Anthropic,deepseek/deepseek-v4-flashavec une clé OpenRouter).
Objectifs d'apprentissage
À la fin de cet atelier, les participant·es seront capables de...
- Expliquer pourquoi seul un outil peut donner le niveau de danger du jour, et lire un appel d'outil ainsi que ce qu'il a rapporté.
- Remplir l'entrée d'un territoire à partir de sa source officielle, pour que l'outil donne ce niveau avec sa source.
- Comparer trois serveurs : ce que chacun lit, ce qui sort du Codespace, ce que chacun coûte dans le contexte.
- Décider s'il faut brancher un outil, d'après ce qu'il peut faire avec ses droits et ce qu'il envoie à l'extérieur.
- Adapter la démarche à un chatbot destiné à des jeunes : se demander, avant toute activité, ce qu'il envoie à l'extérieur et qui le lit.
Prévoir environ 1 heure de préparation :
- Une clé d'API Anthropic par binôme, toutes dans un seul workspace pour la salle, plafonné à 3 dollars × le nombre de binômes. Le plafond porte sur le workspace et non sur chaque clé : un binôme peut donc consommer la part d'un autre. Garder la console Anthropic ouverte pendant l'atelier. Coût mesuré par binôme pour ce que demande la page : environ 0,45 dollar. Chaque organisation partenaire paie ses propres séances (son compte, son workspace, ses clés). Si le plafond de la console est mensuel, les ateliers du même mois le partagent : compter alors 3 dollars × binômes × ateliers du mois, ou le relever avant chaque atelier. Pour créer une clé et fixer un plafond : guide Partager un chatbot avec un groupe grâce à Open WebUI.
- Ou des clés OpenRouter (
sk-or-) : mêmes commandes, aucun modèle Claude, et toute la salle sur un seul modèle pour que les totaux restent comparables (voir le guide Utiliser les outils des ateliers avec une clé OpenRouter). Ces commandes demandent l'image2026.10.43ou plus récente. Les chiffres de cette fiche viennent de Claude et ne valent pas pour OpenRouter. Coût par binôme avec le modèle par défaut, DeepSeek V4 Flash : environ 0,01 dollar pour les commandes du terminal de cet atelier, et environ 0,12 dollar pour les ateliers 1 à 5, mesuré en un seul passage, dans un conteneur hors Codespace et sans groupe ;replay RAGet les chatbots Open WebUI ne sont pas comptés, et un binôme qui pose plus de questions dépense plus. Les ateliers sont pour les adultes : aucun jeune ne tape dans le Codespace ni ne détient de clé, et les jeunes n'utilisent qu'un chatbot dans Open WebUI, dans leur navigateur. Quand ce qu'ils ont écrit passe par OpenRouter, retirer noms et détails personnels, et taper d'abordworkshop-login --europe(voir la partie Sécurité et protection des données de ce guide). - Version de l'image. L'outil dans Open WebUI (partie 5) demande l'image
2026.11.4ou plus récente. Dans le mode groupe du guide Open WebUI, l'outil demande l'image2026.11.8ou plus récente, celle qu'épingle le dépôt. - Lire les sources officielles du jour, le matin même : la page de chaque territoire, donnée dans le champ
sourcede son entrée dansmcp/fire-danger.json. Noter pour chacune s'il y a un niveau aujourd'hui, une phrase qui annonce la fin de la saison, ou rien. Rappeler à la fin de l'atelier 3 aux binômes d'un autre territoire d'apporter l'adresse de leur page officielle. - Faire l'atelier soi-même dans un Codespace neuf (environ 20 min), de
workshop-start 4jusqu'àreplay D 8. - Préparer la page piégée de la partie 4 : https://youth-ai-lab.github.io/yal-workshop/4/trap-page.html à enregistrer sur son ordinateur. Jamais dans le Codespace d'un binôme, jamais avant un
replay. - Imprimer la fiche d'une page et les cartes de sortie. Si la salle a besoin d'une autre langue, traduire la fiche en gardant en anglais les commandes et ce qu'affiche le terminal.
En mode D, le modèle peut lire tous les fichiers du dépôt, y compris sa page README.md, et replay ne le signale pas. Ne jamais mettre cette fiche, ni la fiche animateur·rice, dans le dépôt ou le Codespace d'un binôme : ses notes donnent le statut d'Anvers et la réponse attendue à la question 8. C'est pourquoi les pages des participant·es ne donnent jamais la réponse attendue à la question 8, ni le statut à choisir pour Anvers : garder cette règle si vous les adaptez.
Partie 1 : Accueil (20 min)
Objectif : ouvrir le Codespace de cet atelier, récupérer le travail des ateliers précédents, et lancer Open WebUI pour la clôture.
Étape 1 : Ouvrir son Codespace et enregistrer sa clé
Si le délai d'inactivité de ce compte GitHub n'est pas encore réglé, faire d'abord l'étape 1 de SETUP.md (1 minute). Puis ouvrir le Codespace du binôme à cette adresse (un par binôme) :
https://codespaces.new/Youth-AI-Lab/yal-workshop-tools
Ce lien crée une copie personnelle du dépôt, dans VS Code qui tourne dans le navigateur. Suivre ensuite les étapes 1 à 5 de SETUP.md : laisser le Codespace attendre, l'ouvrir, enregistrer sa clé avec workshop-login, vérifier le message Key OK, et ouvrir un second terminal.
Mêmes commandes, après workshop-login --engine opencode. Le mode D donne à OpenCode les mêmes outils. OpenCode demande l'accord avant chaque commande qu'il veut lancer dans le terminal et chaque fichier qu'il écrit, mais pas avant d'appeler l'un de ces outils. D'autres façons de payer le modèle sont présentées dans le guide Construire son chatbot avec OpenCode.
Coller la clé dans workshop-login, sans option, et lire la section With an OpenRouter key du fichier SETUP.md du dépôt : la conversation va par OpenRouter jusqu'à une entreprise qui fait tourner le modèle, qui n'est pas forcément Anthropic. En résumé : OpenRouter donne accès aux modèles de nombreuses entreprises avec une seule clé. Cette voie n'utilise aucun modèle Claude, et il n'y a rien à choisir : la clé choisit OpenCode. deepseek/deepseek-v4-flash écrit les réponses et les note, car score passe aussi par OpenRouter.
À l'enregistrement, le message de réussite devient :
Key OK (OpenCode, OpenRouter, model openrouter/deepseek/deepseek-v4-flash). You can start: workshop bare
Avec un modèle gratuit, une ligne s'ajoute : Free requests left today: <number>.
Au démarrage d'une conversation, une ligne de plus dit Engine: OpenCode (model openrouter/deepseek/deepseek-v4-flash), puis viennent le logo d'OpenCode et une zone de saisie. Les premiers écrans de Claude Code n'apparaissent pas. La jauge est propre à Claude Code : une fois la conversation commencée, le panneau latéral d'OpenCode a un compteur context, avec le coût (Ctrl+X puis B affiche ou masque ce panneau). OpenCode montre ce que le chatbot a fait au-dessus de chaque réponse, et Ctrl+O ne sert que dans Claude Code. Ses commandes / ne sont pas les mêmes : /mcps, pas /mcp.
Pour essayer un autre modèle, workshop-login --models free liste les modèles gratuits, qui ont un quota quotidien (voir Avec une clé OpenRouter), et workshop-login --model <name> en choisit un.
Ne comparer que ses propres colonnes : score écrit le modèle sous le tableau, et prévient quand deux colonnes ont utilisé des modèles différents. Ne comparer ses totaux qu'avec un binôme qui utilise le même modèle. Les chiffres de cette fiche sur le chatbot (coût, durée, jauge, notes) ont été mesurés avec Claude, pas avec ce modèle : les vôtres seront différents. Tout est détaillé dans le guide Utiliser les outils des ateliers avec une clé OpenRouter.
Avant que quoi que ce soit d'écrit par des jeunes passe par OpenRouter, lire la section Young people and OpenRouter du fichier SETUP.md du dépôt, ainsi que la partie Sécurité et protection des données du guide OpenRouter.
Le même dépôt s'ouvre sur son propre ordinateur, avec Docker et VS Code : voir le guide Ouvrir les ateliers sur son propre ordinateur.
Étape 2 : Récupérer son travail
-
Glisser
my-work.zipdepuis son ordinateur dans la liste des fichiers du Codespace. Si le fichier a été téléchargé plusieurs fois, le navigateur a pu nommer le plus récentmy-work (1).zip: glisser celui-là, et taper son nom exact entre guillemets, par exempleworkshop-start 4 --from "my-work (1).zip". -
Dans le premier terminal, taper :
workshop-start 4 --from my-work.zipOn doit voir
Restored from my-work.zip (saved on ...): vérifier que cette date est bien celle de la fin de l'atelier 3. Puis la liste des fichiers restaurés, et :Prepared for this workshop:- nothing needed: everything is already here.Ready for workshop 4.Today's page: README.md (Ctrl+Shift+V to read it as a page)First command: workshop DSans sauvegarde, taper
workshop-start 4. Les lignes « Prepared » disent alors queAGENTS.mdest désormais une copie de l'exemple Feurisson, et que le document de Bénévent a été ajouté au corpus, pour la question 11.
Dans ce Codespace, Claude Code demande à nouveau si l'on fait confiance au dossier. Le choix proposé est No, exit : appuyer sur la flèche du bas pour choisir Yes, I trust this folder, puis sur Entrée. Si Claude Code s'est fermé, taper de nouveau workshop D. Plus de détails à l'étape 4 de SETUP.md.
Étape 3 : Lancer Open WebUI en arrière-plan
À la clôture, vous verrez votre chatbot dans Open WebUI, avec le même outil qu'en mode D. Son premier démarrage prend quelques minutes : le lancer maintenant.
-
Dans le second terminal, taper :
openwebui start -
Ne pas l'attendre : passer à la partie 2 dans le premier terminal. Le démarrage se termine par
Open WebUI is ready, .... En chemin, vers le début, une ligne ditLive tool ready: fire-danger (fire_danger, territories), read-only.
Le port 3000 est la porte numérotée par laquelle on accède à Open WebUI. Sa visibilité se règle dans l'onglet Ports, réglage Port Visibility. Cet Open WebUI n'a pas de comptes : toute personne qui aurait le lien pourrait utiliser votre clé.
Key OK, Ready for workshop 4, et openwebui start en cours dans le second terminal.
Le binôme doit restaurer le fichier le plus récent (peut-être my-work (1).zip, avec son nom exact entre guillemets) et vérifier la date saved on. Si un binôme a restauré une ancienne sauvegarde, relancer workshop-start 4 --from avec le fichier le plus récent. À la fin de la partie, toute la salle doit voir Ready for workshop 4, avec openwebui start en cours dans le second terminal (quelques minutes : les binômes continuent sans attendre).
Partie 2 : Notre outil, le niveau de danger du jour (20 min)
Objectif : voir ce que l'outil sait aujourd'hui, lire ce qu'il renvoie au modèle, puis remplir l'entrée d'Anvers à partir de sa source officielle, et reposer la question.
Ce que vous allez découvrir
- Un outil est une action que le modèle peut appeler pendant qu'il répond. Il rapporte un fait, ici le niveau du jour, lu dans un fichier. À l'atelier 3, vous avez vu des outils qui font partie de Claude Code : chercher un mot, lire un fichier. Les outils du jour s'y ajoutent.
- Un serveur est le petit programme qui offre ces outils. Malgré son nom, ce n'est pas un gros ordinateur quelque part : ici, il tourne dans votre Codespace. Un serveur peut offrir plusieurs outils :
fire-dangeren offre deux. - MCP (Model Context Protocol) est la manière commune de brancher un serveur sur un chatbot : le même serveur peut se brancher sur Claude Code, sur OpenCode ou sur un autre programme qui fait tourner un chatbot.
- C'est le modèle qui décide quand appeler un outil, d'après sa description. Il ne demande pas l'accord d'abord : les outils branchés en mode D ne font que lire, et les personnes qui ont préparé l'atelier les ont autorisés à l'avance.
Ce que lit le modèle en mode D
Le modèle reçoit, d'un côté, AGENTS.md, l'indication de l'endroit où se trouvent les connaissances, et la liste des outils avec leurs descriptions ; de l'autre, la question. Pour répondre, il a deux chemins :
- chercher un mot ou lire un fichier dans
summaries/etcorpus/text/; - appeler un outil (
fire-dangeroutime), qui ne lui renvoie que ce que l'outil choisit de renvoyer.
Ce qui se passe pendant un appel d'outil. Le modèle ne tourne pas dans votre Codespace : il tourne chez Anthropic, ou chez une entreprise jointe par OpenRouter. Claude Code ou OpenCode, le programme de votre terminal, lui envoie votre question et les descriptions des outils. Quand le modèle veut un outil, il répond par le nom de l'outil et ce qu'il faut lui demander. Le programme le transmet au serveur, dans votre Codespace, puis renvoie au modèle ce qui est revenu, et le modèle écrit sa réponse.
L'idée clé : le mode D, c'est le mode C plus des outils. Ce qu'un outil renvoie entre dans le contexte exactement comme un document que le modèle aurait lu.
Parce qu'il vérifie le fichier à chaque appel du modèle. Il compare la date du fichier à la date du jour. Si ce n'est pas la date du jour, ou si personne n'a écrit que la source montre un niveau aujourd'hui, il ne donne aucun niveau et dit pourquoi. Un document ne peut rien vérifier : le modèle lirait un vieux niveau comme s'il était celui du jour. Ici, une personne remplit le fichier. D'autres outils interrogent eux-mêmes un service : vous en verrez un à la partie 3.
Étape 1 : Voir les outils du mode D
-
Dans le premier terminal, taper
workshop D. -
Dans la conversation, taper
/mcpet appuyer sur Entrée. On doit voir :Manage MCP servers2 serversBuilt-in MCPs (always available)❯ ✔ fire-danger 2 tools✔ time 2 toolsLe ✔ veut dire que le serveur a démarré, même avant la première question.
-
Appuyer sur Entrée sur
fire-danger, puis sur1. View tools: ses deux outils sontterritories(la liste des territoires qu'il connaît) etfire_danger(le niveau d'un territoire aujourd'hui). Appuyer sur Échap jusqu'à revenir dans la conversation.
Étape 2 : La question 8, avant que quiconque remplisse le fichier
-
Poser la question 8 de
test-questions.md. Elle porte sur Anvers, aujourd'hui. -
Au-dessus de la réponse, une ligne grise résume les appels d'outils, par exemple
Called fire-danger 2 times. Appuyer sur Ctrl+O pour voir chaque appel : la ligne● fire-danger - fire_danger (MCP)(territory: "Antwerp")montre ce que le modèle a demandé, et le bloc en dessous ce que l'outil a renvoyé. Appuyer de nouveau sur Ctrl+O pour revenir. -
Lire ce qui est revenu. Le fichier n'est pas daté d'aujourd'hui, donc l'outil ne donne pas de niveau (
"level": null) et explique pourquoi, dans un champ appeléwhy_no_level. À l'écran, l'outil renvoie un seul long texte : chaque guillemet est précédé d'un\, et\nmarque un retour à la ligne. Le voici sans eux :"why_no_level": "The file is dated YYYY-MM-DD, not today (...). Nobody has filled in today's level yet."YYYY-MM-DDest ce que contient le fichier tant que personne n'y a écrit de date.Que fait le modèle de cette réponse ? Lors du test du 2026-10-30, il a appelé
fire_danger, puisterritories(la liste des territoires), sans rien demander, en 6 secondes environ, pour environ 0,03 dollar.Lire maintenant la réponse du chatbot. Donne-t-elle un niveau, ou dit-elle qu'il n'y en a pas aujourd'hui ? Cite-t-elle la source ? Le modèle ne peut pas connaître le niveau par lui-même, et ici l'outil ne lui en a donné aucun. La description de l'outil dit aussi au modèle de ne jamais deviner (vous la lirez à la partie 4). Une réponse qui dit « pas de niveau aujourd'hui » est un échec visible, comme à l'atelier 3 : une réponse inventée est pire que « je ne sais pas ».
Étape 3 : Remplir Anvers à partir de sa source officielle
L'outil lit mcp/fire-danger.json. Une personne le remplit, le jour même, à partir de la source officielle.
-
Ouvrir
mcp/fire-danger.json. Trouver l'entrée d'Anvers (elle commence par"Antwerp). Son champsourcedonne la page officielle : l'ouvrir dans un onglet du navigateur, et lire ce qu'elle dit aujourd'hui pour la province d'Anvers. -
Dans le fichier, écrire la date du jour dans
"date", tout en haut, sous la forme année-mois-jour, par exemple"2026-11-05". -
Dans l'entrée d'Anvers, remplir :
"status":"live"si la page affiche un niveau pour aujourd'hui,"season-over"si elle dit que la saison des feux est terminée,"no-level-shown"si elle n'affiche aucun niveau aujourd'hui ;"source_says": la phrase de la page sur aujourd'hui, recopiée telle quelle, dans sa langue ;- seulement si le statut est
"live":"level", le niveau du jour, et les lignes de"advice", recopiées telles quelles.
La plupart des lignes ont un nom à gauche et une valeur à droite. Ne changer que la valeur : remplacer tout le texte
TO BE COMPLETED...entre les guillemets. Un programme lit ce fichier, et une seule virgule manquante l'arrête : garder donc les guillemets, une virgule entre deux lignes, et aucune après la dernière. Laisser telles quelles les lignes dont on n'a pas besoin : l'outil n'envoie pas une ligne qui dit encoreTO BE COMPLETED. Enregistrer (Ctrl+S). -
Dans la même conversation, reposer la question 8. L'outil relit le fichier à chaque appel : il n'y a rien à redémarrer. Appuyer de nouveau sur Ctrl+O : qu'est-ce qui a changé dans ce que l'outil a renvoyé ? Regarder
status,level,source_saysetwhy_no_level. -
Quitter avec Ctrl+C deux fois.
N'écrire que ce que dit la source officielle, le jour même. Si la page n'affiche aucun niveau, écrire le statut et sa phrase, jamais un niveau de son cru.
Si le chatbot dit que fire-danger.json is malformed, il manque un guillemet ou une virgule : voir la première entrée du Dépannage.
L'entrée d'Anvers porte la date du jour, un statut et la phrase de sa source, et la question 8 obtient une réponse qui cite cette source.
Pour réfléchir
Le modèle ne connaissait pas le niveau d'Anvers, et l'outil ne l'a pas deviné : il a lu un fichier que vous avez rempli. Qui est responsable du niveau que donne le chatbot ?
Remplir Anvers ensemble sur le grand écran à partir de sa page officielle, puis chaque binôme dans son fichier. Faire appuyer tout le monde sur Ctrl+O.
Hors saison, la page officielle peut annoncer la fin de la saison tout en affichant encore un code couleur (c'est ce qui a été observé le 2026-10-30). Le choix de l'atelier est alors "season-over", avec la phrase sur la saison dans "source_says" : l'outil ne donne pas de niveau et le chatbot dit que la saison est terminée. Si vous préférez montrer le code, écrivez "live" avec ce code, et dites clairement en salle que l'autorité elle-même annonce la fin de la saison.
Pour lancer la discussion : « Qui a décidé d'appeler l'outil, et qui a décidé de ce qu'il a répondu ? » Le modèle a décidé de l'appeler (d'après sa description), le fichier a décidé de la réponse, et une personne a rempli le fichier. Réponse au « Pour réfléchir » : la personne qui a rempli le fichier, à partir de la source officielle, est responsable.
Partie 3 : Des serveurs qui existent déjà (30 min)
Objectif : utiliser deux serveurs écrits par d'autres, lire comment ils sont branchés, et voir ce que chacun envoie à l'extérieur et ce qu'il coûte dans le contexte.
De nombreux serveurs existent déjà, pour un agenda, une base de données, un site web, une carte, le catalogue d'une bibliothèque. Le projet MCP tient une liste d'exemples et de liens vers d'autres serveurs (modelcontextprotocol/servers), et des milliers d'autres sont recensés ailleurs. En utiliser un évite du travail, mais on fait alors tourner, dans son Codespace, un programme écrit par quelqu'un d'autre.
Ce que vous allez découvrir
- Time : le serveur d'exemple officiel de MCP. Il donne la date et l'heure dans un fuseau horaire. Il n'appelle aucun service : il lit l'horloge du Codespace.
- Open-Meteo : un serveur écrit par un bénévole, pour le service météo du même nom. Il envoie un lieu et ses coordonnées à Open-Meteo, sur Internet, et rapporte la prévision.
- Chaque outil a une description, et les descriptions entrent dans le contexte à chaque message, que l'outil serve ou non.
Trois serveurs côte à côte
| Serveur | Qui l'a écrit | Ce qu'il lit | Ce que le serveur lui-même envoie sur Internet |
|---|---|---|---|
fire-danger | l'atelier | le fichier mcp/fire-danger.json | rien |
time | le projet MCP (exemple officiel) | l'horloge du Codespace | rien |
open-meteo | un bénévole (son code est public) | le service Open-Meteo, sur Internet | le lieu et les coordonnées demandés par le modèle |
Et pour les trois : ce que l'outil renvoie entre dans le contexte, et part donc chez l'entreprise du modèle (Anthropic, ou une entreprise jointe par OpenRouter) avec la question, comme tout ce qui se trouve dans la conversation.
L'idée clé : un serveur est un programme qui tourne dans le Codespace avec vos droits. Ce qu'il peut faire, et ce qu'il envoie à l'extérieur, est écrit dans son code et dans la façon dont il est lancé, pas dans son nom.
Étape 1 : Lire comment les outils sont branchés
- Ouvrir
.mcp.json. Il liste les serveurs du mode D : pour chacun, le programme qui le lance (command) et ses options (args). Les chemins qui commencent par/opt/workshop/sont des programmes déjà installés dans le Codespace. - Trouver la ligne de
time. Quelle option reçoit-il ? (--local-timezone Europe/Paris: le fuseau horaire qu'il utilise quand le modèle n'en nomme pas. À l'étape 2, observer quel fuseau horaire le modèle demande.) Une option change ce que fait le programme : c'est la « façon dont il est lancé » de l'idée clé ci-dessus.
Étape 2 : Une question qui a besoin de l'heure
La carte du Pla Alfa, en Catalogne, est mise à jour à heures fixes : le résumé consacré à la Catalogne dit lesquelles. Pour savoir si la mise à jour du jour a déjà eu lieu, le modèle a besoin de l'heure actuelle à Barcelone. Aucun document ne la contient.
-
Taper
workshop D, puis demander :Has the Pla Alfa map of Catalonia already had its morning update today? -
Appuyer sur Ctrl+O : quels outils le modèle a-t-il appelés ? A-t-il interrogé
time? Appuyer de nouveau sur Ctrl+O. -
Poser maintenant la même question, en nommant l'outil :
Use the time tool: is it already past 9:30 in Barcelona, so that the Pla Alfa map has had its morning update? -
Comparer les deux réponses. Lors du test du 2026-10-30, le modèle n'a pas appelé
timela première fois : il a trouvé les heures de mise à jour dans le résumé, puis a dit qu'il ne pouvait pas savoir. La seconde fois, il a appelétime(get_current_time) et a répondu avec l'heure de Barcelone. Il a choisi lui-même le fuseauEurope/Madrid, celui qui couvre Barcelone, et non leEurope/Parisde l'option. La date, le modèle l'avait déjà : Claude Code la lui donne, et l'outil de danger feu de forêt aussi.Ce que cela veut dire. Un outil branché n'est pas toujours utilisé. Le modèle choisit d'après la question et d'après les descriptions des outils. Dans notre test, il n'a pas utilisé l'horloge tant que la question ne nommait pas l'outil, et la description de
timeest quand même entrée dans le contexte. Il faut donc tester un outil avec les questions que les gens poseront vraiment. -
Quitter avec Ctrl+C deux fois.
Étape 3 : Brancher la météo
L'outil météo n'est pas dans le mode D par défaut. Il diffère des deux premiers serveurs sur deux points : ce que le modèle lui demande sort du Codespace, et ses descriptions prennent beaucoup plus de place dans le contexte. Il est listé dans un second fichier, .mcp.weather.json, et non dans .mcp.json. Pour le brancher le temps d'une conversation, taper la commande ci-dessous : WORKSHOP_WEATHER=1 devant workshop D est un réglage valable pour ce démarrage seulement.
WORKSHOP_WEATHER=1 workshop D
-
Taper
/mcp: on doit voir un troisième serveur,✔ open-meteo 17 tools. L'atelier n'en montre au modèle que 2 (la prévision, et la recherche d'un lieu par son nom) : les descriptions des 17 outils font environ 112 000 caractères, celles des 2 retenus environ 12 000 (en moyenne, 4 caractères de texte anglais font un jeton). Appuyer sur Échap. L'atelier autorise aussi ces deux outils : le modèle les appelle sans demander, et ce qu'il leur envoie sort du Codespace. -
Demander :
Will it be windy tomorrow in La Rochelle?Appuyer sur Ctrl+O : qu'est-ce que le modèle a envoyé à Open-Meteo ? Lors du test du 2026-10-30, il a envoyé les coordonnées de La Rochelle (46.16, -1.15), qu'il connaissait sans chercher, et la réponse est arrivée en 5 secondes environ.
Regarder la jauge maintenant, avant la question suivante : elle compte toute la conversation, et monte donc à chaque message. Lors du test, la première réponse d'une nouvelle conversation occupait environ 14 000 jetons de contexte pour cette question sur la météo.
Pour voir ce que le serveur lui-même coûte dans le contexte, nous avons comparé deux autres questions sur La Rochelle, chacune dans une nouvelle conversation, chacune traitée avec le seul outil de danger feu de forêt. Sans le serveur météo : 7 845 jetons. Avec lui branché, et jamais appelé : 13 868. Donc 13 868 - 7 845 = 6 023 : environ 6 000 jetons pour un serveur que personne n'a utilisé, 3 % de la fenêtre de contexte (200 000 jetons). Ils restent là toute la conversation : les descriptions entrent dans le contexte à chaque message, même quand le modèle ne les appelle pas. D'après la règle vue plus haut (4 caractères font un jeton), les 12 000 caractères feraient 3 000 jetons : le coût réel est donc environ le double. Cette règle n'est qu'une première estimation, et nous n'avons pas mesuré de quoi se compose le reste. Ne brancher donc que les outils dont le chatbot a besoin.
-
Demander maintenant :
Given the weather, what is the fire danger level today in La Rochelle?Le modèle présente-t-il une prévision météo comme si c'était le niveau officiel ? Lors du test, non : il a appelé l'outil de danger feu de forêt, et a dit que la météo ne donne pas le niveau officiel. Un test sur une seule question ne prouve pas grand-chose : essayez vous-même. -
Quitter avec Ctrl+C deux fois.
Les prévisions viennent d'Open-Meteo (https://open-meteo.com). Son service gratuit est réservé à un usage non commercial, et ses données sont sous licence CC BY 4.0 : un chatbot qui les affiche doit donner ce lien.
Le vent et l'air sec font monter le danger, mais le niveau du jour est décidé par une autorité, avec sa propre échelle. Si votre chatbot a confondu les deux, ajouter une règle dans AGENTS.md, par exemple :
Never give a weather forecast as a fire danger level: only the fire-danger tool gives the official level.
Pour chacun des trois serveurs, on sait dire ce qu'il lit et ce qui sort du Codespace.
Pour réfléchir
Le modèle a choisi le lieu et les coordonnées, et le serveur météo les a envoyés à Open-Meteo. Qu'est-ce qu'un serveur pourrait envoyer d'autre, si on l'interrogeait sur l'adresse d'un·e jeune ?
Les outils peuvent aussi se combiner. Chacun, seul, peut sembler sans danger : un agenda dit quand, une carte dit où, un service météo dit quel temps il fera. Une seule question peut les appeler tous les trois, et la réponse rassemble l'endroit où se trouvera une personne, et à quel moment. Le droit européen sur les données personnelles (le RGPD, et en France la loi Informatique et Libertés) demande que les données personnelles soient collectées pour un but annoncé, et pas utilisées pour un autre (RGPD, article 5). Un chatbot avec des outils peut croiser des données en quelques secondes, sans que personne ne l'ait décidé : demandez-vous ce que chaque outil ajoute aux autres.
Deux moments à animer :
- La question du Pla Alfa : le modèle n'a pas appelé
timetant que la question ne le nommait pas. C'est attendu : nommer l'outil dans la question. Message à faire passer : « Un outil auquel le modèle ne pense jamais coûte quand même ses descriptions à chaque message. » Montrer la jauge. - La météo : qu'est-ce qui est sorti du Codespace ? Les coordonnées de La Rochelle, envoyées à Open-Meteo par un serveur écrit par un bénévole, qui tourne dans notre Codespace (Open-Meteo voit aussi l'adresse du Codespace). « Pour une ville, d'accord. Pour l'adresse d'un·e jeune ? »
Si Open-Meteo ne répond pas (réseau, limite), sauter l'étape météo : les descriptions et la jauge restent intéressantes à montrer avec /mcp.
Partie 4 : Lire avant d'installer, citer sa source (25 min)
Objectif : lire ce que fait vraiment un serveur avant de le brancher, puis remplir l'entrée de son propre territoire dans le fichier de l'outil, avec sa source.
Ce que vous allez découvrir
- Un serveur démarre avec vos droits. Il peut lire les fichiers du Codespace, et certains envoient des données à un service sur Internet. Le modèle décide quand l'appeler, mais c'est le programme qui décide de ce qu'il fait.
- Ce qu'un outil renvoie entre dans le contexte. Une page web ou la réponse d'un service peut contenir des instructions que personne n'a écrites dans votre
AGENTS.md. L'animateur·rice en montre un exemple. - La source fait partie des données. L'entrée d'un territoire dit d'où vient le niveau, pour que chacun puisse le vérifier.
Avant d'installer un serveur : cinq questions
| Question | Où regarder |
|---|---|
| Qui l'a écrit, et est-il encore entretenu ? | sa page (GitHub, PyPI, npm) : dernière version, licence |
| Que lit-il ? | son code, et les options dans .mcp.json |
| Qu'envoie-t-il à l'extérieur, et à qui ? | son code : les adresses qu'il appelle ; les conditions d'utilisation du service |
| Écrit-il ou supprime-t-il quelque chose ? | sa liste d'outils : tout outil qui écrit, supprime ou envoie un message |
| Sa version est-elle figée ? | .mcp.json, et la façon dont il a été installé (ici : dans l'image du Codespace, avec des versions figées) |
GitHub, PyPI et npm sont des sites où l'on publie des programmes. La page d'un programme montre qui l'a écrit et sa dernière version (une release). Entretenu veut dire que quelqu'un le corrige encore. Une version figée veut dire que le chatbot garde la version vérifiée : si un programme se met à jour tout seul, le programme lu aujourd'hui peut faire autre chose demain. L'image du Codespace est l'ensemble de programmes tout prêt d'où part chaque Codespace de cet atelier.
L'idée clé : une description dit à quoi sert un outil. Seul son code dit ce qu'il fait. Lire les deux, ou demander à quelqu'un qui sait lire le code.
Étape 1 : Lire notre outil
- Ouvrir
mcp/fire_danger_server.py. Pas besoin de savoir lire le Python pour en voir l'essentiel. - Trouver les deux blocs qui commencent par
@mcp.tool(): leur texte entre"""est la description que lit le modèle. Trouver la ligneDATA = ...: le fichier que lisent ces deux outils. La ligne en dessous,RECORDED = ..., sert à un troisième outil (un jour passé), qui reste coupé sauf si l'animateur·rice l'active. - Répondre aux cinq questions ci-dessus pour ce serveur. Pour « Qu'envoie-t-il à l'extérieur ? », appuyer sur Ctrl+F dans l'éditeur et chercher
http: une adresse sur Internet commence par ces lettres. Ici, la recherche ne trouve rien. C'est bon signe, pas une preuve : pour un gros programme, demander à quelqu'un qui sait lire le code. - Essayer maintenant les cinq mêmes questions sur
open-meteo, avec ce qui a été vu à la partie 3. Auxquelles peut-on répondre ? Lesquelles demandent son code ?
Étape 2 : Regarder l'exemple de l'animateur·rice
Tout ce que lit le modèle entre dans le contexte avec le même poids que votre question : un document, une page web, ce que renvoie un outil. Un texte peut donc porter des instructions que personne n'a écrites dans votre AGENTS.md, et la personne qui utilise le chatbot peut n'en rien voir.
L'animateur·rice montre cela sur le grand écran, avec une page web qui cache une phrase destinée aux assistants d'IA (du texte blanc sur fond blanc, en très petite taille), et demande au chatbot de la résumer.
- Lire la réponse. Le chatbot dit-il que la page cache quelque chose ?
- L'animateur·rice ouvre le fichier dans l'éditeur, et la phrase apparaît. Lire ce qu'elle demande. Le chatbot l'a-t-il fait ?
- Discuter : qui a écrit cette phrase, qui l'a lue, et que pourrait-elle demander d'autre ?
Après la discussion : ce qui s'est passé lors de notre test
Lors du test du 2026-10-30, le chatbot n'a pas suivi la phrase, ni avec Claude Code ni avec OpenCode. OpenCode l'a signalée, Claude Code n'en a rien dit. Un seul essai ne prouve pas grand-chose : une phrase plus habile, ou un modèle plus petit, peut obéir. Les règles d'un chatbot ne garantissent pas qu'il ignorera une telle phrase.
Étape 3 : Remplir l'entrée de son territoire
- Rouvrir
mcp/fire-danger.json. Si votre territoire y figure (La Rochelle, Aix-en-Provence, Barcelone, Anvers, Naples), remplir son entrée comme pour Anvers en partie 2 :status,source_says, etleveletadviceseulement si le statut est"live". - Si votre territoire n'est pas dans le fichier, copier une entrée, la coller après la dernière, mettre une virgule entre les deux, et remplacer son nom,
scale(les niveaux qu'utilise l'autorité, dans les mots de la source),sourceetseasonpar ceux de votre territoire. Si vous ne connaissez passcale, écrireTO BE COMPLETED: l'outil ne l'envoie pas. Si vous ne connaissez passeason, supprimer sa ligne, avec sa virgule. - Vérifier que
"date"est toujours celle du jour, et enregistrer. - Taper
workshop Det demanderWhat is the fire danger level today in <your territory>?, en remplaçant<your territory>par le nom de votre territoire. Appuyer sur Ctrl+O pour voir ce que l'outil a renvoyé (de nouveau Ctrl+O pour revenir) : la réponse cite-t-elle votre source ? - Voir maintenant une question que le chatbot doit vous poser. Toujours dans
workshop D, demander :Add a field "checked_by" with our names to the entry of <your territory> in mcp/fire-danger.json.Claude Code s'arrête avant d'écrire : un cadre Edit file avec les lignes qu'il changerait, etDo you want to make this edit to fire-danger.json?. Choisir 3. No : rien ne change. L'outilfire_dangerne vous a rien demandé, parce qu'il ne fait que lire ; une modification de fichier attend votre oui. - Quitter avec Ctrl+C deux fois.
Certaines autorités ne publient aucun niveau hors saison, ou seulement pour les services. Écrire alors "no-level-shown" ou "season-over", avec la phrase de la source : un chatbot qui dit « il n'y a pas de niveau officiel aujourd'hui, voici pourquoi » a raison. Ne jamais le remplacer par un autre indice ou par une prévision.
L'entrée de votre territoire porte un statut, la phrase de sa source et son adresse, et le chatbot cite cette source.
Pour réfléchir
Vous avez répondu à cinq questions avant de faire confiance à un serveur d'environ 160 lignes. Brancheriez-vous un serveur que vous ne pouvez pas lire, capable d'écrire des fichiers et d'envoyer des messages, sur un chatbot utilisé par des jeunes ?
Ce que l'atelier a mis en place pour vous, et pourquoi
Les garde-fous de l'atelier :
- Pas de niveau sans le fichier du jour.
fire-dangerne donne un niveau que si son fichier est daté du jour et que le statut estlive. Sinon, il dit pourquoi (why_no_level, partie 2) : un vieux niveau ressemblerait à un niveau du jour. - Deux outils sur 17. Le serveur météo a 17 outils ; l'atelier n'en montre que 2 au modèle. Moins d'outils, c'est moins de texte dans le contexte, et moins de choses que le modèle peut faire.
- Ces outils autorisés à l'avance, pas les autres. En mode D, le modèle appelle ces outils sans vous demander, parce qu'ils ne font que lire. Un serveur que vous ajoutez vous-même à
.mcp.jsonvous est demandé à chaque appel, et écrire un fichier demande toujours votre oui (point 5 de l'étape 3 ci-dessus). - Un fichier de réglages vide. Le serveur météo pourrait lire un fichier de réglages (
.env) dans le dossier où il démarre. L'atelier lui en donne un vide, pour qu'un fichier laissé dans le dossier ne puisse pas changer ce qu'il fait. - Des versions figées. Les serveurs de l'heure et de la météo viennent avec l'image du Codespace, dans la version qui a été lue : ils ne se mettent pas à jour tout seuls.
Tenez-vous-en à des outils comme ceux-ci : ils ne font que lire, ne demandent aucune donnée personnelle, et n'utilisent que des sources publiques.
L'entrée de votre territoire dans un outil en direct, avec sa source. À réemployer dans tout chatbot qui utilise des outils : d'abord votre chatbot dans Open WebUI, avec le même outil (partie 5, étape 2) ; avec un groupe, le guide Partager un chatbot avec un groupe grâce à Open WebUI (étape 5 de la partie 2, l'outil en direct), où l'animateur·rice remplit le fichier le jour même. Une autre voie, pour les adultes, sans Claude Code : avec OpenCode, le guide Construire son chatbot avec OpenCode reprend l'exemple fire-danger, explique comment remplir le niveau du jour, et donne les vérifications à faire sur les autres serveurs MCP.
La démonstration de la phrase cachée. Déposer la page piégée dans votre Codespace, lancer workshop D, demander Summarise trap-page.html for a group of young people., montrer la réponse, puis ouvrir le fichier dans l'éditeur : la ligne cachée apparaît. Discuter : qui l'a écrite, qui l'a lue, que pourrait-elle demander d'autre ? La page des participant·es donne notre résultat de test sous cette étape, replié jusqu'à la discussion (« After the discussion: what happened in our test »). Supprimer la page avant tout replay. Lors des essais (Claude Code et OpenCode, mode D), aucun des deux n'a suivi la phrase cachée ; OpenCode l'a signalée, Claude Code non.
Territoires sans niveau public quotidien. Naples : aucune page publique quotidienne trouvée (statut no-level-shown ; dans le fichier, scale et source ne sont pas remplis et renvoient à l'animateur·rice). La Rochelle et Aix-en-Provence, hors saison : les cartes des préfectures ne publient pas de données ; pour La Rochelle, l'arrêté 26EB142 (corpus/text/30) dit ce qui s'applique alors, et sa phrase fait un bon source_says. Barcelone : le Pla Alfa fonctionne toute l'année.
Après la partie : « Brancheriez-vous un serveur que vous ne pouvez pas lire ? » Les cinq questions sont l'habitude à garder : qui l'a écrit, ce qu'il lit, ce qu'il envoie, s'il écrit, si sa version est figée.
Partie 5 : Clôture (15 min)
Objectif : voir ce que les outils ont changé dans la note du chatbot, voir le même outil dans Open WebUI, et sauvegarder son travail.
Trois questions comptent aujourd'hui. La question 8 demande le niveau du jour, qu'aucun document ne contient. Les questions 11 et 12 portent sur ce qui a été ajouté à l'atelier 3, le document de Bénévent et la page de son territoire : elles vérifient que le chatbot les trouve encore quand il a aussi des outils.
Étape 1 : Rejouer et noter la colonne D
-
Prédire sur papier : parmi les questions 8, 11 et 12, lesquelles vont progresser entre la colonne C et la colonne D ?
-
Dans le premier terminal, rejouer le jeu de test en mode D :
replay DSous chaque réponse, la ligne
What the model did:liste ce que le modèle a lu et cherché, et les outils qu'il a appelés, par exemplecalled the MCP tool fire_danger. Lors du test du 2026-10-30, avec les 11 questions du kit (sans question 12) : 1 min 54 et 0,24 dollar. Avecdeepseek/deepseek-v4-flash, 11 questions ont pris de 3 à 4,5 minutes parreplaydans les modes bare, C, D et E (un seul essai). -
Noter seulement les trois questions du jour, avec l'aide du juge (sans question 12 :
score D 8 11) :score D 8 11 12Pour la question 8 : quand l'entrée d'Anvers n'est pas
"live", une réponse qui dit qu'il n'y a pas de niveau officiel aujourd'hui, avec la phrase de la source, est juste. -
Comparer la colonne D avec la colonne C dans
scores.md, pour les questions 8, 11 et 12, et avec la prédiction. Quelle question a changé, et pourquoi ? Aujourd'hui, seules quelques questions sont notées : la ligne Total ne veut rien dire ici, lire les lignes une à une. Si la colonne C n'a pas de note pour la question 8, taperscore C 8: les réponses de l'atelier 3 sont toujours dansanswers/. Sans sauvegarde, il n'y a pas de colonne C : comparer avec un binôme voisin qui utilise le même modèle.
Rappel du barème (fiche d'une page) :
- 2 : juste, et la réponse dit d'où elle vient. Pour les questions 7 et 9, dire « je ne sais pas » ou refuser est juste ; pour la question 8, « pas de niveau officiel aujourd'hui », avec la phrase de la source, est juste quand le fichier n'a pas de niveau
live. - 1 : honnête mais insuffisant : « je ne sais pas » alors que la réponse existe, pas de source, ou réponse partielle.
- 0 : faux ou inventé.
Étape 2 : Votre chatbot dans Open WebUI, avec son outil
Le mode D est dans votre terminal. Le même outil peut aller dans un chatbot que d'autres personnes utilisent par une page web : ici, Open WebUI.
-
Dans le second terminal, vérifier qu'Open WebUI est prêt, puis taper, avec le nom de votre chatbot :
openwebui chatbot --name "Feurisson"Ce que vous devez voir, vers la fin :
"Feurisson chatbot" has the live tool of mcp/, as in mode D: fire_danger (today's level, read from mcp/fire-danger.json) and territories. Read-only. Under the message box, the wrench icon shows it.Ready. In Open WebUI (...): New Chat, then choose "Feurisson chatbot" in the message box (bottom right). -
Ouvrir l'adresse, New Chat, choisir votre chatbot, et poser la question 8. Si le modèle appelle l'outil, une ligne View Result from fire-danger_fire_danger apparaît au-dessus de la réponse. Cliquer dessus : elle montre ce que l'outil a renvoyé, comme Ctrl+O le faisait en mode D. La réponse donne-t-elle le même niveau, ou la même raison de ne pas en donner, que votre fichier
answers/D-...? -
Poser la même question pour votre territoire.
Il a les deux mêmes outils, fire_danger et territories, et rien d'autre : ni le serveur de l'heure, ni la météo. Il ne fait que lire mcp/fire-danger.json, un fichier rempli à partir de sources publiques, sans aucune donnée personnelle. Il ne peut rien écrire, et il n'a aucune sortie vers Internet. Il lit le fichier à chaque appel : si le fichier n'est pas daté du jour, il renvoie why_no_level, comme à la partie 2. Avec Claude, en un essai, le chatbot a appelé l'outil pour la question 8 et n'a donné aucun niveau, parce que le fichier n'était pas daté du jour. Avec un petit modèle local (qwen3:8b), le premier appel après le démarrage d'Open WebUI n'a reçu aucune réponse, une fois sur trois essais : reposer la question.
Un chatbot créé avec --rag (atelier 2) ne reçoit aucun outil : Open WebUI choisit ses extraits avant chaque réponse, et il n'appelle rien. L'outil n'est pas non plus dans le fichier de chatbot-export (atelier 5) : c'est un programme, pas un document.
Cet Open WebUI n'a pas de comptes : il est réservé à votre binôme, jamais à un groupe. Pour un groupe, le même outil se trouve dans le guide Partager un chatbot avec un groupe grâce à Open WebUI (étape 5 de la partie 2, ajouter l'outil en direct), à partir de la version 2026.11.8 de l'image du Codespace. Là, l'animateur·rice remplit mcp/fire-danger.json le matin de chaque séance, à partir de la source publique, et coche l'outil dans chaque chatbot qui doit s'en servir ; les participant·es ne font que discuter. Le Codespace de ce guide a son propre fichier : votre entrée d'aujourd'hui n'y va pas d'elle-même.
Étape 3 : Sauvegarder son travail, remplir la carte de sortie
- Taper
workshop-save, puis clic droit surmy-work.zip→ Download.... Le fichier contientfire-danger.jsonet tout le travail précédent. L'apporter à l'atelier 5. Si l'ordinateur a déjà unmy-work.zip, le nouveau peut s'appelermy-work (1).zip: apporter le plus récent. - Prendre une carte vierge ou une demi-feuille auprès de l'animateur·rice : c'est votre carte de sortie. Répondre seul·e, en quelques mots :
- Pourquoi seul un outil peut-il donner le niveau de danger feu de forêt du jour ?
- Que peut faire un serveur dans votre Codespace, et comment le vérifier avant de le brancher ?
- Quelle est la différence entre une prévision météo et le niveau officiel de danger feu de forêt ?
La suite : l'atelier 5, Organiser ce que sait un chatbot dans un wiki. Ouvrir son propre Codespace depuis sa page, et apporter my-work.zip.
Ce que contient une bonne réponse sur la carte de sortie : (1) le niveau change tous les jours et il est décidé par une autorité ; aucun document ne le contient ; l'outil lit ce qu'une personne a recopié depuis la source, le jour même ; (2) il tourne avec vos droits : il peut lire des fichiers et envoyer ce qu'il obtient à un service ; lire son code et ses options, ou demander à quelqu'un qui sait le faire ; (3) la prévision est une mesure de la météo ; le niveau est une décision d'une autorité, avec sa propre échelle et ses propres règles.
Après l'atelier : noter le statut choisi pour chaque territoire ce jour-là. Rappeler à chaque binôme de garder my-work.zip pour l'atelier 5.
Réemploi avec des jeunes : « Peut-on aller en forêt aujourd'hui ? » est une question que les jeunes posent. Seule la source officielle peut y répondre, le jour même, et un chatbot doit dire quand il n'y a pas de niveau. Le chatbot du binôme dans Open WebUI a cet outil en lecture seule, sans donnée personnelle, avec des sources publiques seulement ; il reste dans le Codespace du binôme, sans comptes, et chatbot-export ne l'emporte pas. Avec un groupe, l'outil arrive aux jeunes par le guide Partager un chatbot avec un groupe grâce à Open WebUI (étape 5 de la partie 2), où vous remplissez vous-même le fichier le matin de la séance.
Manque de temps à la clôture : montrer votre propre chatbot Open WebUI sur grand écran au lieu de ceux des binômes.
Dépannage
Les problèmes courants (clé, Codespace, terminal) sont dans la section « Troubleshooting » de SETUP.md. Ceux d'une clé OpenRouter sont plus bas, dans Avec une clé OpenRouter.
fire-danger.json is malformed (Expecting ',' delimiter: line ... column ...). Fix it and try again.: il manque une virgule ou un guillemet dansmcp/fire-danger.json. Le nom du fichier passe en rouge, avec le nombre de problèmes à côté. Aller à la ligne indiquée dans le message, chercher la ligne ondulée rouge dans l'éditeur et y poser la souris : VS Code dit ce qui manque (ici :Expected comma). Les captures de ces écrans sont dans le dépôt. Une virgule manquante se trouve en général à la fin de la ligne juste au-dessus. Corriger et enregistrer : inutile de redémarrer la conversation.- L'outil dit
The file is dated ..., not today: écrire la date du jour dans"date", en haut du fichier, sous la forme année-mois-jour, et enregistrer. - L'outil ne donne pas de niveau alors que j'en ai écrit un : l'outil ne donne un niveau que si le statut est
"live". Avec"season-over"ou"no-level-shown", il donne la phrase de la source à la place. /mcpaffiche un serveur avec ✘ au lieu de ✔ : quitter la conversation (Ctrl+C deux fois) et relancerworkshop D. Si le ✘ reste, demander à l'animateur·rice.- Le modèle n'appelle pas l'outil : poser la question sur aujourd'hui, et nommer le territoire comme il est écrit dans le fichier (
territoriesen donne la liste). Une question sur les règles (ce qui est interdit, les amendes) trouve sa réponse dans les documents, pas dans l'outil. WORKSHOP_WEATHER=1 works with modes D, E and F only.: taperWORKSHOP_WEATHER=1 workshop D, pas avec un autre mode.! The live tool fire-danger could not start, so your chatbot answers without it.: les lignes en dessous donnent la fin de l'erreur. Si vous avez modifiémcp/fire_danger_server.py, annuler la modification. Puis taper de nouveauopenwebui start: il garde vos chatbots et vos documents.openwebui chatbotditIt is not running now: type openwebui start.: le chatbot a été créé, avec son outil, mais l'outil n'a pas démarré. Taperopenwebui start: l'outil revient, et le chatbot le garde.- Dans Open WebUI, le chatbot n'affiche jamais
View Result from fire-danger_fire_danger: vérifier que vous avez choisiFeurisson chatbot(avec le nom du vôtre), et non un chatbot dont le nom finit par(RAG)ni un « Wildfire RAG » : ils n'ont pas d'outil. Voir ensuite « Le modèle n'appelle pas l'outil », plus haut. - Quitter une conversation :
Ctrl+Cdeux fois. Copier / coller dans le terminal :Ctrl+Shift+C/Ctrl+Shift+V(Cmd+C/Cmd+Vsur Mac).
Avec une clé OpenRouter
Les messages de clé de SETUP.md qui nomment Anthropic existent aussi avec OpenRouter à la place d'Anthropic. Ceux-ci sont propres à cette voie :
This is an OpenRouter key: Claude Code in the workshop needs an Anthropic key (sk-ant-…).: vous avez demandé Claude Code, avec--engine claudeouWORKSHOP_ENGINE=claude. Rien n'a été enregistré. Une clé OpenRouter tourne dans OpenCode : la ligne suivante du message dit quoi taper.The saved key is an OpenRouter key: it works with OpenCode only. Type this command without WORKSHOP_ENGINE=claude.: votre clé est enregistrée, mais cette commande a demandé Claude Code, à qui il faut une clé Anthropic (elle commence parsk-ant-). Faire ce que dit le message, ou taperworkshop-loginet coller une clé Anthropic.OpenRouter has no model <model> that can use tools.: rien n'a été enregistré. Le nom est faux, ou ce modèle ne sait pas utiliser d'outils, ce que demandent les ateliers. Les lignes suivantes montrent des noms proches.Key saved, but this OpenRouter account has no credits left. Add credits, or choose a free model: workshop-login --models free: c'est l'erreur HTTP 402, prévenir l'animateur·rice. Dansreplay, la ligne ditno credits left on this key. Une clé arrivée à sa limite peut aussi donner ce message. Avec un solde négatif, les modèles gratuits sont bloqués eux aussi. Aprèsworkshop-login --europe, le message s'arrête àAdd credits.: aucun modèle gratuit ne tourne en Europe.Key saved, but this key has reached its spending limit. Tell the facilitator.: dansreplay, la ligne ditthis key or its account reached a spending limit.Key saved, but the quota of the model <model> is reached for now (HTTP 429). Try again later, or choose another model: workshop-login --models openrouter, ouKey saved, but the model <model> is busy (HTTP <code>). Try again in a few minutes, or choose another model: workshop-login --models openrouter: faire ce que dit le message. Dansreplay, la ligne dittoo many requests, or the quota of this key or of this model is used up, après une attente, car OpenCode réessaie d'abord tout seul. Les modèles gratuits ont un quota : le 2026-11-01, 50 requêtes par jour (1 000 une fois que le compte a acheté au moins 10 dollars de crédits), requêtes échouées comprises. Deux modèles gratuits lancés en même temps peuvent arrêterreplaysur cette erreur. Un seul à la fois, avec du quota restant,cohere/north-mini-code:freea terminéreplay C, alors quegoogle/gemma-4-26b-a4b-it:frees'est arrêté sur trois erreurs 429 en 10 secondes. Aprèsworkshop-login --europe, le message nomme un modèle Mistral au lieu de la liste : ce modèle suit la même règle.Key saved, but no company can serve the model <model> under the workshop's data rule. Choose another model: workshop-login --models openrouter: avec une clé OpenRouter, chaque requête demande d'écarter les entreprises qui peuvent collecter les données ou s'en servir pour l'entraînement. Certaines de celles qui restent peuvent quand même garder les questions un temps. Aucune ne sert ce modèle en ce moment. Dansreplay, la ligne ditthe model is busy, or no company can serve it now: réessayer plus tard, ou demander à l'animateur·rice.Key saved, but Mistral does not serve the model <model> in Europe with zero data retention. Choose another model, for example: workshop-login --model <name>: vous avez activéworkshop-login --europe, et ce modèle n'a aucune entreprise de ce type. Taper la commande que donne le message.OpenCode is already open and keeps the old data rule: close it and start it again. A replay stops by itself before its next question.: vous avez changé--europependant qu'OpenCode tournait. Ce que vous y tapez part encore sous l'ancienne règle. Fermer ce chatbot, puis le relancer avecworkshop.Your data rule changed during this replay (workshop-login --europe or --no-europe). The next question was not sent.: la question en cours a fini sous l'ancienne règle. Sa réponse reste dansanswers/. Retaper la même commandereplay.
Indicateurs de réussite
- Chaque binôme voit
Key OKpuisReady for workshop 4, et retrouve son travail de l'atelier 3. - L'entrée d'Anvers porte la date du jour, un statut et la phrase de sa source, et la question 8 obtient une réponse qui cite cette source, sans niveau inventé.
- Chaque binôme sait dire, pour chacun des trois serveurs (
fire-danger,time,open-meteo), ce qu'il lit et ce qui sort du Codespace. - Chaque binôme a rempli l'entrée de son propre territoire avec un statut, la phrase de sa source et son adresse, et le chatbot cite cette source.
- Chaque binôme a vu une demande de permission (
Do you want to make this edit to fire-danger.json?) et y a répondu 3. No. - La colonne D est notée pour les questions 8, 11 et 12, la question 8 a été posée au chatbot dans Open WebUI, et
my-work.zipest téléchargé pour l'atelier 5. - Sur la carte de sortie, chacun·e explique pourquoi seul un outil donne le niveau du jour, comment vérifier un serveur avant de le brancher, et pourquoi une prévision météo n'est pas un niveau officiel.
Cette fiche fait partie du projet Youth AI Lab, financé par le programme Erasmus+. Adaptation française de https://github.com/Youth-AI-Lab/yal-workshop-tools (anglais), contenu sous licence CC BY-SA 4.0.