
Mini-leçon 17 sur 30 · Relier données et IA
Choisissez une petite conversation à tester
À qui s’adresse cette leçon ?
Pour les personnes ajoutant un assistant conversationnel à un petit site. Le projet est fourni ; vous dirigez et testez son comportement au lieu d’écrire la gestion des messages.
Le second message doit dépendre du premier.
Objectif de cette leçon
- Obtenez une première vraie réponse d’IA.
- Vérifiez une relance dépendant du message précédent.
- Conservez un message échoué pour pouvoir réessayer.
Explications, exemple détaillé et exercices
Avant de commencer
Votre propre accès API Google AI Studio et le projet serveur distinct fourni sont nécessaires. La leçon API-key explique la configuration privée si besoin. Confirmez d’abord modèles accessibles, limites et frais possibles. Utilisez des messages fictifs et un code détenu par le propriétaire ; authentification, limites durables et suivi du budget sont nécessaires avant un usage public.
Vérifiez vos acquis de départ
Ce sont des compétences utiles, pas des cours obligatoires bloquants. Si vous les maîtrisez, commencez ici ; sinon, ouvrez la préparation. Les fichiers fournis remplacent un site personnel préalable.
- Comment garder les clés d’API hors de votre interface web
Placez le secret fournisseur uniquement dans l’environnement serveur privé.
Durée estimée: 20–32 min
Estimations avec les fichiers fournis et les comptes et outils requis déjà prêts. La configuration, les files de déploiement et les délais de messagerie ou de DNS demandent du temps supplémentaire. Les vraies requêtes utilisent le quota du compte configuré. Authentification publique, limites durables et révision de confidentialité sont des travaux séparés.
Comprendre le principe
Ouvrez le chatbot prêt avec l’assistant. Choisissez un sujet fictif simple et une relance renvoyant à la réponse précédente pour juger si la conversation se poursuit.
Une bonne réponse isolée ne prouve pas le fonctionnement d’une conversation. Prévoyez d’examiner les deux messages et leur relation.
Un exemple concret
Demandez une explication courte, puis une version plus simple de cette même explication.
Utilise le chatbot fourni et guide la configuration privée de run-locally.txt. Garde identifiants et instructions du modèle sur le serveur. Aide-moi à poser une question, la prolonger sur le même sujet et tester un échec sans perdre le texte saisi. Ne reconstruis pas le site et ne déduis pas le bon fonctionnement de la conversation de sa première réponse seulement.Fichiers de cette étape
Commencer iciFichiers de l’atelier
Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.
À vous de jouer
Quelle première question et quelle relance dépendante essaierez-vous ?
Afficher une solution détaillée
Exemple de paire : « Que fait un serveur de site web ? », puis « Simplifie cette explication pour quelqu’un qui construit son premier site. » La seconde réponse doit simplifier le même rôle, pas commencer un sujet sans rapport.
C’est un plan de test, pas une transcription. Je jugerai la continuité après la vraie première réponse et adapterai ma relance si une autre précision est nécessaire.
Éléments d’une réponse solide
- Propose une première question concrète et une relance faisant référence à sa réponse.
- Explique ce qui démontrerait la continuité au lieu de juger suffisante une seule bonne réponse.
Comment ça marche (facultatif)
Ajoutez un chatbot capable de poursuivre une conversation
Une intégration utile doit lire le dernier message de l’élève et son contexte.
Cette leçon construit un petit tuteur web. Le visiteur pose une question, lit la réponse et poursuit. Le navigateur envoie la conversation acceptée avec chaque message ; le serveur appelle Gemini et renvoie une véritable réponse du modèle.
Un modèle ne mémorise pas automatiquement votre précédente requête HTTP. Nous gardons un court historique dans la mémoire de cet onglet. Recharger l’efface, et l’atelier s’arrête après quatre échanges réussis pour borner la pratique.
Exemple détaillé
Demandez “What is DNS?” (qu’est-ce que le DNS ?), puis “Explain that using a street-address example.” (expliquez-le avec une adresse postale). La seconde requête a besoin de la question et réponse précédentes pour définir ce que désigne « cela ».
Exercice technique complémentaire
Pourquoi une réponse au deuxième tour peut-elle sembler sans rapport même si l’appel API réussit ?
Afficher une solution détaillée
L’intégration peut avoir envoyé une instruction générique ou omis l’historique. Examinez le tableau messages envoyé et confirmez les tours acceptés précédents et la nouvelle question, dans l’ordre.
- Vérifie la présence des messages précédents.
- Vérifie la conservation du dernier message utilisateur.

Étape 1 · Comment ajouter un chatbot d’IA à votre site
Démarrez le chatbot fourni
Faites gérer la configuration serveur privée par l’assistant.
Explications, exemple détaillé et exercices
Comprendre le principe
Suivez run-locally.txt avec l’assistant. Confirmez compte, modèle et conditions, définissez les valeurs privées de server-env.example.txt, puis ouvrez l’URL affichée par le proxy. Saisissez le code d’exercice distinct, jamais la clé fournisseur. La configuration est obligatoire ; écrire le serveur est facultatif.
La clé fournisseur et les instructions de contrôle restent sur le serveur. Si compte/modèle est indisponible, signalez précisément cette étape plutôt que de remplir la page d’une fausse réponse.
Un exemple concret
Un champ du site ne doit pas permettre au visiteur de choisir vos identifiants fournisseur privés.
Fichiers de cette étape
Commencer iciFichiers de l’atelier
Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.
À vous de jouer
L’application exécutée a-t-elle produit une vraie première réponse ou où la configuration s’est-elle arrêtée ?
Afficher une solution détaillée
Exemple de premier appel : « L’application complète s’est ouverte à l’URL du proxy. J’ai saisi le code distinct et reçu une explication du modèle configuré. La clé Google est restée dans l’environnement serveur privé. »
Exemple de blocage : « La page locale s’est ouverte, mais le serveur n’a obtenu aucune réponse du modèle. » Consignez l’étape réelle de configuration, accès ou quota et examinez les coûts avant de réessayer. Un aperçu statique ne démontre pas une réponse réelle.
Éléments d’une réponse solide
- Identifie l’application du proxy local et une première réponse réelle du fournisseur, ou le blocage exact.
- Sépare code d’exercice et clé privée et vérifie les limites du compte et du modèle.
Comment ça marche (facultatif)
Reliez le navigateur à une fonction serveur bornée
Gardez identifiants et rôle du tuteur sous contrôle serveur.
Déployez les dossiers et configurez START-HERE.txt. public/app.js envoie des messages user/assistant à votre fonction mini-chat. Celle-ci accepte seulement des rôles alternés, un texte limité et un petit historique.
Le serveur traduit assistant vers le rôle model de Gemini et fournit une instruction système distincte. L’appelant ne choisit pas d’URL fournisseur et ne remplace pas l’instruction avec un rôle system du client. Le code du propriétaire restreint cet atelier ; il ne remplace pas l’authentification publique et les limites durables de dépenses.
generate est une fonction auxiliaire locale dans netlify/functions/mini-chat.mjs, pas un autre service déployé. Pour changer le rôle du tuteur, modifiez la chaîne passée à generate dans ce fichier serveur. Une variable .env frontend n’est pas une alternative : une valeur substituée dans le code navigateur devient publique.
Pour la séquence locale complète, ouvrez run-locally.txt : préparez l’environnement privé de la racine, liez uniquement le projet d’entraînement et démarrez le proxy de fonctions Netlify. server-env.example.txt liste les noms des variables sans vrais secrets. Ouvrir seulement le HTML ne lance pas le serveur.
Utilisez le guide actuel ci-dessous ou lancez list-text-models.mjs depuis la racine privée avec votre environnement. Il liste les candidats generateContent visibles du compte sans afficher la clé. Choisissez un modèle texte pris en charge, vérifiez conditions et quota, puis copiez son ID API exact dans GEMINI_MODEL côté serveur.
Exemple détaillé
Le validateur rejette un message system injecté avant l’appel fournisseur. Il ne rend pas les réponses infaillibles, mais garde le format et la configuration privilégiée sous votre contrôle.
Gemini : API generateContent · Gemini : clés d’API · Gemini : ID et capacités actuels des modèles · Node.js : état de prise en charge des versions
Exercice technique complémentaire
Le navigateur doit-il choisir GEMINI_API_KEY ou envoyer un message system pour remplacer le rôle du tuteur ?
Afficher une solution détaillée
Ni l’un ni l’autre. Configurez clé et rôle au serveur. Validez rôles et tailles ; les réponses doivent toujours être évaluées pour leur exactitude.
- Garde les secrets fournisseur au serveur.
- Considère les messages client comme des entrées de conversation non fiables.

Étape 2 · Comment ajouter un chatbot d’IA à votre site
Poursuivez la conversation et essayez un échec
Préservez le message saisi quand la requête échoue.
Explications, exemple détaillé et exercices
Comprendre le principe
Envoyez la relance dépendante et comparez sa réponse à l’échange précédent. Demandez d’aider à simuler ou reproduire une requête ratée dans le projet jetable.
La relance doit rester liée à votre conversation et un envoi raté doit conserver brouillon et messages précédents pour réessayer.
Un exemple concret
Un échec au deuxième tour ne doit pas effacer la question que vous venez de saisir.
Fichiers de cette étape
Commencer iciFichiers de l’atelier
Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.
À vous de jouer
Que s’est-il passé pour la relance et le parcours échec/réessai ?
Afficher une solution détaillée
Exemple de conversation : « Après l’explication du serveur, ma demande de simplification portait encore sur cette explication. J’ai ensuite volontairement utilisé un mauvais code ; brouillon et messages précédents sont restés visibles. Rétablir le bon code m’a permis de réessayer. »
Le refus du mauvais code est un test local volontaire, pas une panne du fournisseur. Si le brouillon disparaît ou si une réponse réussie est dupliquée au nouvel essai, la conversation n’est pas encore prête.
Éléments d’une réponse solide
- Compare la relance à l’échange précédent pour vérifier la continuité du sujet.
- Teste un échec explicitement identifié et vérifie que brouillon et messages précédents restent disponibles pour réessayer.
Comment ça marche (facultatif)
Testez la continuation et les échecs
Intégrez le deuxième tour au test d’achèvement.
Posez la question sur le DNS donnée dans l’exemple, puis une question de suivi qui s’y réfère. Examinez le corps de la requête dans les outils du navigateur et comparez la réponse à la véritable dernière question. Une réponse longue et fluide ne prouve pas sa pertinence.
Essayez un mauvais code à l’envoi suivant. Le brouillon reste dans textarea et aucun échange échoué n’est ajouté à l’historique accepté. Corrigez l’accès et réessayez. Enter envoie ; Shift+Enter crée une ligne. Le bouton est désactivé pendant l’attente.
Exemple détaillé
Un délai dépassé ou une réponse fournisseur incomplète produit un échec visible. Le navigateur n’ajoute pas une réponse assistant vide en prétendant poursuivre.
Exercice technique complémentaire
La première réponse est bonne, mais la deuxième requête échoue. Que doit-il advenir du message saisi et de l’historique ?
Afficher une solution détaillée
Gardez le brouillon et les tours acceptés. Affichez l’échec honnêtement, réactivez les commandes et n’ajoutez la nouvelle paire qu’après une réponse valide.
- Conserve le brouillon pour réessayer.
- N’enregistre pas de réponse d’assistant inventée.

Étape 3 · Comment ajouter un chatbot d’IA à votre site
Livrez le comportement conversationnel
Utilisez plusieurs échanges plutôt qu’une seule réponse séduisante.
Explications, exemple détaillé et exercices
Comprendre le principe
Terminez un test de trois échanges sur votre sujet fictif et gardez une transcription expurgée. Répétez la reprise après échec après toute correction.
Vérifiez qu’une nouvelle tentative ne perd pas le brouillon et ne duplique pas un échange réussi. Marquez les tests indisponibles non effectués. Cet exemple ne récupère pas de notes fiables du site ni ne garantit les faits ; la leçon content-chatbot ajoute ensuite une tâche de sources fournies à vérifier.
Un exemple concret
Les preuves doivent montrer ce qu’a demandé le visiteur, la réponse reçue et la reprise après requête ratée.
Fichiers de cette étape
Commencer iciFichiers de l’atelier
Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.
- netlify/functions/mini-chat.mjsTélécharger ce fichier
- conversation-tests.txtTélécharger ce fichier
- worksheet.htmlTélécharger ce fichier
- reference/assignment-walkthrough.txtTélécharger ce fichier
- reference/START-HERE.txtTélécharger ce fichier
- reference/netlify/functions/mini-chat.mjsTélécharger ce fichier
À vous de jouer
Fournissez la transcription et l’observation réelle d’échec/réessai.
Travail à rendre: Une courte transcription de plusieurs tours et un résultat observé d’échec/réessai, sans secrets.
Afficher une solution détaillée
Exemple de plan en trois échanges : « 1. Explique le rôle d’un serveur web. 2. Simplifie cette réponse. 3. Donne un exemple de son aide pour ce site. » Un relevé complet inclurait les réponses réelles à côté des questions pour pouvoir juger leur lien.
Exemple de reprise : « Un envoi volontairement refusé a conservé son brouillon ; le nouvel essai a ajouté un échange réussi, pas deux. » Avant ouverture publique, cet exemple réservé au propriétaire exige encore authentification, limites durables et suivi des coûts ; ce n’est pas un système de réponses fondées sur des sources.
Éléments d’une réponse solide
- Inclut trois échanges liés et assez de contexte pour juger les réponses.
- Consigne la reprise d’un envoi échoué sans brouillon perdu ni échange réussi dupliqué.
Comment ça marche (facultatif)
Votre devoir : créer un tuteur avec lequel poursuivre
Évaluez la pertinence au lieu de compter seulement les requêtes réussies.
Changez l’instruction serveur pour un tuteur HTML/CSS concis. Faites trois échanges : question sur une ancre cassée, proposition d’un couple href/id incorrect, puis demande d’explication. Utilisez du code synthétique, pas de sources privées.
Gardez une transcription expurgée et annotez si chaque réponse traite le dernier message. Répétez un envoi échoué et montrez que la nouvelle tentative garde la cohérence. Avant accès public, prévoyez authentification réelle, quotas persistants par utilisateur et explication de la destination des messages.
Exemple détaillé
Un tuteur utile indique les href/id qui diffèrent. Des conseils génériques de nommage ne répondraient pas à l’élève, même techniquement vrais.
Le parcours de référence complet est disponible dans reference/assignment-walkthrough.txt. Comparez ses étapes avec votre résultat ; remplissez le relevé de test à partir de vos propres observations sur votre projet.
Exercice technique complémentaire
Produisez une transcription de trois échanges et une observation d’échec et nouvelle tentative.
Afficher une solution détaillée
Modifiez l’instruction de la fonction serveur en tuteur HTML/CSS concis. Ne changez pas une variable frontend et ne déplacez pas generate dans public. La fonction de référence montre la version complète modifiée.
Exemple d’évaluation : l’utilisateur demande pourquoi <a href='#work'> n’atteint pas <section id='projects'>. Une réponse pertinente nomme cette différence. Il propose ensuite href='#projects' ; une suite pertinente vérifie cette correction précise. Des conseils génériques de nommage échoueraient même avec un statut HTTP 200.
Envoyez un mauvais code lors d’un tour ultérieur. La conversation acceptée reste intacte et textarea conserve le brouillon non envoyé. Corrigez et réessayez ; ajoutez une paire user/assistant seulement après une réponse valide. Cette transcription est un guide d’évaluation, pas la preuve d’une génération réelle.
- Les suites répondent aux véritables messages précédents.
- L’échec conserve brouillon et historique et la clé reste privée.
Cette leçon vous a-t-elle été utile ?
Laissez un J’aime ou partagez-la avec quelqu’un qui pourrait en profiter.