
Mini-leçon · Français
Comment ajouter un chatbot d’IA à votre site
Exécutez le chatbot privé prêt avec un assistant et testez si une relance utilise la conversation et résiste à une requête ratée.
À 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.
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.
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.
Ce que vous apprendrez
- 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.
Étape 1
Choisissez une petite conversation à tester
Le second message doit dépendre du premier.
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
Start hereFichiers de l’atelier
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
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 ».
Extra implementation exercise
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.
Erreur fréquente
Appeler conversation une suite de réponses prédéfinies sans rapport.
Étape 2
Démarrez le chatbot fourni
Faites gérer la configuration serveur privée par l’assistant.
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.
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
À 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 ?
Discutez de votre réponse avec le tuteur
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.
- 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.
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.
How it works (optional)
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
Extra implementation exercise
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.
Erreur fréquente
Faire confiance aux rôles fournis par le client parce que l’interface normale ne les expose pas.
Étape 3
Poursuivez la conversation et essayez un échec
Préservez le message saisi quand la requête échoue.
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.
À vous de jouer
Que s’est-il passé pour la relance et le parcours échec/réessai ?
Discutez de votre réponse avec le tuteur
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.
- 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.
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.
How it works (optional)
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.
Extra implementation exercise
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.
Erreur fréquente
Tester seulement « bonjour » et déclarer toute la conversation fonctionnelle.
Étape 4
Livrez le comportement conversationnel
Utilisez plusieurs échanges plutôt qu’une seule réponse séduisante.
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.
À vous de jouer
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.
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.
Discutez de votre réponse avec le tuteur
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.
- 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é.
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.
- 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
How it works (optional)
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.
Extra implementation exercise
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.
Erreur fréquente
Évaluer une intégration d’IA d’après la seule réussite HTTP.
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 faire répondre un chatbot à partir de votre contenu
- 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