
Mini-leçon · Français
Comment faire répondre un chatbot à partir de votre contenu
Partez d’un projet de café prêt à lancer : ajoutez vos informations avec un assistant de code et vérifiez les réponses et leurs sources.
À qui s’adresse cette leçon ?
Pour qui souhaite un chatbot fondé sur ses informations. Vous lancerez le café fourni et modifierez ses notes avec un assistant de code ; écrire du HTML ou du JavaScript n’est pas requis.
Avant de commencer
Un navigateur suffit au premier exercice. Pour de vraies réponses IA : assistant de code, ouverture d’un dossier et commandes de terminal, Node LTS pris en charge, projet Netlify d’essai et votre accès API Google AI Studio. Les leçons sur les clés et le chatbot expliquent cette préparation ; sautez-les si vous la maîtrisez. Tous les fichiers sont fournis.
Durée estimée: 20–37 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. La recherche simple par mots-clés est volontairement limitée. Récupérer et vérifier les sources ne garantit pas la vérité de chaque affirmation générée.
Ce que vous apprendrez
- Lancer le chatbot fourni et comparer une réponse à sa source.
- Ajouter une règle en modifiant un seul fichier de faits.
- Distinguer information absente et échec du service.
Étape 1
Construire un chatbot qui connaît les informations du café
Votre résultat : une zone de question qui répond depuis les notes fournies et ouvre sa source.
Les visiteurs d’un café demandent horaires, accès et réservations. Un chatbot général ne connaît pas automatiquement ces faits. Nous allons lancer un café fictif fourni, lui donner des notes et tester ses réponses.
Votre travail : lancer le projet, changer un fait et vérifier le résultat. L’assistant de code réalise l’implémentation ; lire chaque fichier n’est pas nécessaire. Les faits modifiables sont dans records.json ; site et serveur sont déjà fournis.
Ouvrez d’abord practice/index.html et essayez les questions. Cet exercice local montre question, note sélectionnée et fait cité avec des règles fixes : aucun modèle IA ni envoi à Google. Vous lancerez le vrai chatbot à l’étape suivante.
Premier essai : un fait connu et un fait absent
Demandez les horaires : mardi–samedi, 09:00–17:00. Demandez ensuite le téléphone du propriétaire : il ne figure pas dans les notes. L’assistant doit reconnaître cette absence plutôt qu’inventer.
Fichiers de cette étape
Start hereFichiers de l’atelier
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Étape 2
Lancer le projet avec votre assistant de code
Téléchargez tout le projet, configurez vos valeurs privées et ouvrez l’adresse indiquée par le serveur.
Ouvrez les fichiers de l’atelier et enregistrez-les dans un dossier de projet en conservant les chemins indiqués. Ouvrez ce dossier dans votre assistant de programmation. public/index.html est la page destinée aux visiteurs ; netlify/functions/mini-chat.mjs s’exécute sur le serveur. Ce sont des fichiers d’implémentation fournis, pas des lectures obligatoires. Demandez à l’assistant de configurer le projet existant avec la demande ci-dessous.
Suivez run-locally.txt : npm install, npx netlify login puis npx netlify link vers votre projet d’essai seulement. Préparez .env avec server-env.example.txt : GEMINI_API_KEY pour votre clé, GEMINI_MODEL pour un modèle accessible, LAB_TOKEN pour un code d’accès distinct. Ce dernier n’est pas la clé Google.
Lancez npm run dev et ouvrez son adresse, normalement http://localhost:8888 pour cet atelier. Entrez LAB_TOKEN dans le formulaire et demandez les horaires. Une réponse avec source constitue le premier contrôle réel. Un aperçu HTML ne lance pas le serveur ; indiquez précisément tout blocage.
Copiez cette demande dans votre assistant de code
L’assistant prépare les fichiers ; vous entrez les secrets dans l’environnement privé et contrôlez le navigateur. Ne mettez pas la clé Google dans le champ du code d’accès.
Ouvre ce dossier du chatbot du café. Utilise les fichiers existants sans reconstruire le site. Guide-moi avec run-locally.txt, vérifie Node et explique les trois valeurs privées. Quand je les ai renseignées en privé, lance le projet localement. Montre l’adresse et aide-moi à tester horaires et source. Ne prétends pas avoir une réponse du fournisseur avant une requête réussie.Google AI Studio : créer et gérer les clés API · Netlify : développement local et liaison du projet
À vous de jouer
Lancez le projet et demandez les horaires. Notez l’adresse locale, l’arrivée ou non d’une vraie réponse et la source ouverte. Sinon, nommez le prérequis manquant ou l’erreur.
- Téléchargez le projet complet, pas un fichier isolé.
- Utilisez la demande et les noms de variables privées fournis.
- Ouvrez l’application locale et suivez sa source.
Travail à rendre Un court compte rendu ou le blocage exact, sans valeurs secrètes.
Discutez de votre réponse avec le tuteur
Afficher une solution détaillée
Un relevé utile indique si l’adresse du proxy s’est ouverte, si une réponse est arrivée et si Opening hours a ouvert la bonne note. Ce format ne prouve pas que votre service a été testé. En cas d’accès API, de modèle ou de serveur bloqué, notez cette étape et demandez son inspection.
- Distingue application et réponse réelle d’un aperçu de fichier.
- Note la source ou un résultat non exécuté sans exposer de secret.
Fichiers de cette étape
Start hereFichiers de l’atelier
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Étape 3
Vérifier la réponse en ouvrant sa source
Avant de modifier le projet, testez un fait connu, un fait absent et une instruction contradictoire.
Demandez les horaires du samedi et ouvrez la source : 09:00–17:00. Puis demandez le téléphone absent ; un numéro inventé échoue. Notez les résultats dans evaluation.txt.
Demandez d’ignorer les notes et d’annoncer une ouverture dimanche. La source indique une fermeture. Un lien réel ne rend pas correcte une affirmation contradictoire ; comparez le texte.
Le projet sélectionne une note par mots de la question, puis demande au modèle de répondre. Si une reformulation ne trouve rien, faites examiner la sélection et les mots-clés. Si la bonne note donne une mauvaise réponse, examinez la génération. La lecture complète du serveur reste facultative.
Diagnostiquer ce que vous observez
« Ouvert dimanche jusqu’à 17:00 » avec une source disant « fermé » est une mauvaise réponse sourcée. Une formulation sans note correspondante relève de la sélection ; une erreur réseau relève du service. Ne confondez pas ces trois états.
À vous de jouer
La réponse annonce une ouverture dimanche jusqu’à 17:00 ; sa source dit fermé. Est-elle acceptable ? Nommez la contradiction et le contrôle à demander.
- Comparez l’affirmation exacte au texte de la source.
- Décrivez la correction ; écrire le serveur n’est pas demandé.
Travail à rendre L’affirmation fausse, le fait source et un contrôle concret.
Discutez de votre réponse avec le tuteur
Afficher une solution détaillée
Rejetez : ouvert contredit fermé. Demandez à l’assistant de reproduire la question, d’inspecter la note hours et de corriger puis tester son utilisation. Gardez le lien, mais vérifiez les mots.
- Rejette l’ouverture dimanche malgré un lien réel.
- Demande de vérifier la fidélité à la note, pas l’apparence.
Fichiers de cette étape
Start hereFichiers de l’atelier
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Étape 4
Ajouter une règle et tester le changement
Ajoutez une règle sur les chiens dans un seul fichier, synchronisez et vérifiez le comportement.
Ajoutez à records.json cette règle fictive : chiens admis uniquement en terrasse, jamais à l’intérieur. L’assistant peut éditer le JSON. Utilisez dogs comme identifiant, un titre clair et les mots-clés de vos questions.
Lancez npm run sync:notes. sync-records.mjs met à jour serveur, sources et exercice local. Redémarrez, rechargez et retestez ; vous n’avez pas à éditer séparément HTML et données serveur.
Testez une question directe, une reformulation, une question hors sujet et une demande d’autoriser les chiens partout. Notez attendu et observé dans evaluation.txt. Le corrigé se consulte après votre tentative, sans devenir votre preuve de test.
Demander une modification délimitée
« Ajoute la règle terrasse seulement dans records.json avec dog, dogs, terrace et les mots de ma langue. Préserve les autres faits, synchronise, redémarre et aide-moi à tester la source et une question sans rapport. »
reference/records.json et reference/assignment-walkthrough.txt donnent une comparaison complète. Sans compte API, utilisez l’exercice local, en distinguant ses résultats de ceux du modèle.
Votre exercice pratique
Pour commencer
Les fichiers et contenus d’essai sont fournis. La vérification réelle exige votre propre compte, boîte de réception ou domaine, selon les prérequis. L’inspection locale reste possible ; notez les étapes réelles non exécutées comme non testées.
Ajoutez la règle terrasse avec l’assistant, synchronisez et testez. Envoyez la note et attendu/observé, en précisant exercice local, vraie IA ou non exécuté.
- Modifiez records.json ; laissez l’outil actualiser les copies.
- Redémarrez et testez une question sur les chiens et un fait absent.
- Vérifiez que terrasse seulement ne devient pas une permission à l’intérieur.
Travail à rendre La note et au moins deux contrôles attendu/observé ; précisez mode et blocages.
Discutez de votre réponse avec le tuteur
Afficher une solution détaillée
Une note valide comprend dogs, un titre clair, terrasse seulement et des mots-clés utiles. Après synchronisation, le lien doit ouvrir cette règle.
La réponse sur les chiens reste limitée à la terrasse ; une question sans rapport ne crée aucun fait. Une instruction ne change pas la règle. Rapportez vos observations et le mode testé ; un contrôle non lancé reste non exécuté.
- Conserve la règle précise et une source qui la contient.
- Sépare observations, prévisions, absence de correspondance et panne.
Fichiers de cette étape
Start hereFichiers de l’atelier
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- records.jsonTélécharger ce fichier
- sync-records.mjsTélécharger ce fichier
- practice/index.htmlTélécharger ce fichier
- evaluation.txtTélécharger ce fichier
- worksheet.htmlTélécharger ce fichier
- reference/records.jsonTélécharger ce fichier
- reference/assignment-walkthrough.txtTélécharger ce fichier
- reference/START-HERE.txtTélécharger ce fichier
Cette leçon vous a-t-elle été utile ?
Laissez un J’aime ou partagez-la avec quelqu’un qui pourrait en profiter.
Poursuivre votre apprentissage
- Comment créer votre premier site personnel
- Comment publier votre site depuis GitHub
- Comment relier un domaine personnalisé à votre site
- Comment configurer une messagerie sur votre domaine
- Comment rendre votre site utilisable sur téléphone
- Comment accélérer le chargement des images de votre site
- Comment recevoir les commentaires de votre site dans votre boîte mail
- Comment ajouter des abonnements par e-mail à votre site
- Comment envoyer des e-mails automatiques depuis votre site
- Comment enregistrer les formulaires dans une base de données
- Comment permettre aux utilisateurs de se connecter à votre site
- Comment garder une page privée
- Comment permettre aux utilisateurs de modifier leur profil
- Comment permettre aux utilisateurs de téléverser des images
- Comment garder les clés d’API hors de votre interface web
- Comment afficher les données d’une API externe sur votre site
- Comment ajouter un chatbot d’IA à votre site
- Comment ajouter un blog à votre site
- Comment ajouter une recherche à votre site
- Comment ajouter une autre langue à votre site
- Comment aider Google à trouver votre site
- Comment corriger l’aperçu de votre site lors du partage d’un lien
- Comment mesurer les visites et les actions utiles sur votre site
- Comment permettre aux visiteurs de prendre rendez-vous
- Comment accepter un paiement sur votre site
- Comment prévisualiser les changements du site avant publication
- Comment annuler un déploiement défectueux de votre site
- Comment sauvegarder et restaurer les données de votre site
- Comment trouver et corriger les erreurs de votre site en ligne