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.

Commencer le cours interactifLire les notes du cours

À 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.

Fichiers de l’atelier

É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.

É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

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.

É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.

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.

É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.

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)

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.

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

Explorer les autres leçons