LektionenSo ergänzt du deine Website um einen KI-Chatbot

Mini-Lektion 17 von 30 · Daten und KI anbinden

Wähle ein kleines Testgespräch

Für wen ist das gedacht?

Für alle, die einer kleinen Website einen Gesprächsassistenten hinzufügen. Das Projekt wird bereitgestellt; du steuerst und testest sein Verhalten, statt Nachrichtenverarbeitungscode zu schreiben.

Die zweite Nachricht soll von der ersten abhängen.

Ziel dieser Lektion

  • Erzeuge eine erste echte KI-Antwort.
  • Prüfe eine Nachfrage, die von der vorherigen Nachricht abhängt.
  • Halte eine fehlgeschlagene Nachricht zum erneuten Senden verfügbar.
Erklärung, ausgearbeitetes Beispiel und Übung

Bevor du beginnst

Du brauchst eigenen Google-AI-Studio-API-Zugang und das mitgelieferte separate Server-Functions-Projekt. Die API-Schlüssel-Lektion erklärt bei Bedarf die private Einrichtung. Prüfe zuerst Modellzugang, Nutzungslimits und mögliche Gebühren. Verwende erfundene Nachrichten und einen Übungscode des Eigentümers. Vor öffentlichem Betrieb sind Authentifizierung, dauerhafte Nutzungslimits und Budgetüberwachung nötig.

Prüfe deine Vorkenntnisse

Diese Fähigkeiten sind hilfreich; ein Kursabschluss wird nicht erzwungen. Beherrschst du sie schon, starte hier. Sonst öffne die Vorbereitung. Eine eigene bestehende Website ist dank der Startdateien nicht nötig.

  1. So hältst du API-Schlüssel aus deinem Frontend heraus

    Hinterlege das Anbieter-Geheimnis nur in der privaten Serverumgebung.

Geschätzte Dauer: 20–32 Min.

Schätzungen für die mitgelieferten Startdateien bei bereits eingerichteten Konten und Werkzeugen. Einrichtung, Deployment-Warteschlangen sowie E-Mail- und DNS-Wartezeiten kommen hinzu. Echte Anfragen verwenden das Kontingent deines konfigurierten Kontos. Öffentliche Authentifizierung, dauerhafte Limits und Datenschutzprüfung sind eigene Aufgaben.

Die Idee verstehen

Öffne das fertige Chatbotprojekt mit deinem Assistenten. Wähle ein einfaches künstliches Thema und eine Nachfrage zur vorherigen Antwort, damit du beurteilen kannst, ob das Gespräch weitergeführt wird.

Eine einzelne gute Antwort belegt kein funktionierendes Gespräch. Plane, beide Nachrichten und ihren Zusammenhang zu prüfen.

Ein konkretes Beispiel

Bitte um eine kurze Erklärung und danach um eine einfachere Fassung genau dieser Erklärung.

Nutze das bereitgestellte Chatbotprojekt und führe durch die private Einrichtung in run-locally.txt. Halte Zugangsdaten und Modellanweisungen auf dem Server. Hilf mir, eine erste Frage und eine Nachfrage zum selben Thema zu stellen und eine fehlgeschlagene Anfrage zu testen, ohne den eingegebenen Text zu verlieren. Baue die Website nicht neu auf und behaupte kein funktionierendes Gespräch allein aufgrund der ersten Antwort.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Welche erste Frage und welche darauf aufbauende Nachfrage probierst du aus?

Ausgearbeitete Lösung anzeigen

Veranschaulichendes Testpaar: „Was macht ein Websiteserver?“ gefolgt von „Erkläre das einfacher für jemanden, der seine erste Website baut.“ Die zweite Antwort sollte dieselbe Aufgabe einfacher erklären und kein neues, unverbundenes Thema beginnen.

Das ist ein Testplan und kein Gesprächsprotokoll. Ich beurteile die Kontinuität nach der tatsächlichen ersten Antwort und passe die Folgefrage an, falls diese eine andere Klärung verlangt.

Was eine gute Antwort enthält

  • Liefert eine konkrete erste Frage und eine Folgefrage, die sich auf ihre Antwort bezieht.
  • Erklärt, woran Gesprächskontinuität erkennbar wäre, statt eine gute Einzelantwort als ausreichend zu behandeln.
So funktioniert es (optional)

Ergänze einen Chatbot, der ein Gespräch fortsetzen kann

Eine nützliche Chatanbindung muss die neueste Nachricht des Lernenden und ihren Kontext lesen.

Diese Lektion erstellt einen kleinen Website-Tutor. Besucher können eine Frage stellen, die Antwort lesen und nachfragen. Der Browser sendet den akzeptierten Gesprächsverlauf mit jeder neuen Nachricht; der Server ruft Gemini auf und gibt eine echte Modellantwort zurück.

Ein Modell erinnert sich nicht automatisch an deine vorherige HTTP-Anfrage. Wir halten in diesem Tab einen kurzen Verlauf im Arbeitsspeicher. Neuladen löscht ihn; der Workshop endet nach vier erfolgreichen Frage-Antwort-Paaren, um die Übung zu begrenzen.

Ausgearbeitetes Beispiel

Frage „What is DNS?“ und dann „Explain that using a street-address example.“ — was DNS ist und wie es sich anhand einer Straßenadresse erklären lässt. Die zweite Anfrage braucht frühere Frage und Antwort, um zu klären, worauf „that“ verweist.

Zusätzliche technische Übung

Warum kann eine Antwort auf die zweite Nachricht unpassend klingen, obwohl der API-Aufruf gelingt?

Ausgearbeitete Lösung anzeigen

Die Anbindung hat möglicherweise nur einen allgemeinen Prompt gesendet oder den Verlauf ausgelassen. Untersuche das ausgehende messages-Array und prüfe, ob es frühere akzeptierte Gesprächsschritte und die neue Frage in der richtigen Reihenfolge enthält.

  • Prüft, ob frühere Nachrichten enthalten waren.
  • Prüft, ob die neueste Nutzernachricht erhalten blieb.

Schritt 1 · So ergänzt du deine Website um einen KI-Chatbot

Starte den bereitgestellten Chatbot

Lass den Assistenten die private Serverkonfiguration übernehmen.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

Folge run-locally.txt mit deinem Assistenten. Prüfe Konto, Modell und Nutzungsbedingungen, richte die privaten Serverwerte aus server-env.example.txt ein und öffne dann die vom lokalen Proxy ausgegebene App-URL. Ins Formular gehört der separate Übungscode, niemals der Anbieterschlüssel. Diese Einrichtung ist erforderlich; Servercode zu schreiben ist optional.

Anbieterschlüssel und maßgebliche Anweisungen bleiben auf dem Server. Sind dein Konto oder Modell nicht verfügbar, melde genau diese Stufe, statt eine erfundene Antwort einzufügen.

Ein konkretes Beispiel

Ein Websitefeld darf Besucher nicht deine privaten Anbieterzugangsdaten auswählen lassen.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Hat die laufende App eine echte erste Antwort erzeugt, oder wo endete die Einrichtung?

Ausgearbeitete Lösung anzeigen

Veranschaulichendes Erstaufrufprotokoll: „Die vollständige App öffnete unter der Proxy-URL. Ich gab den separaten Übungscode ein und erhielt eine Erklärung vom eingerichteten Anbietermodell. Der Google-Schlüssel blieb in der privaten Serverumgebung.“

Ein blockiertes Beispiel lautet: „Die lokale Seite öffnete, aber der Server konnte keine Modellantwort erhalten.“ Halte die tatsächliche Konfigurations-, Zugangs- oder Kontingentstufe fest und prüfe vor erneutem Versuchen die Kontokosten. Eine statische Dateivorschau belegt keine Live-Antwort.

Was eine gute Antwort enthält

  • Benennt die lokale Proxy-App und eine tatsächliche erste Anbieterantwort oder das genaue Hindernis.
  • Unterscheidet Übungscode und privaten Anbieterschlüssel und prüft Konto- und Modelllimits.
So funktioniert es (optional)

Verbinde den Browser mit einer begrenzten Serverfunktion

Halte Zugangsdaten und Tutorrolle unter Serverkontrolle.

Veröffentliche die mitgelieferten Ordner und konfiguriere die Variablen aus START-HERE.txt. public/app.js sendet user-/assistant-Nachrichten an deine eigene mini-chat-Funktion. Diese akzeptiert nur abwechselnde Rollen, begrenzten Text und einen kurzen Verlauf.

Der Server bildet assistant auf Geminis Rolle model ab und liefert eine separate Systemanweisung. Ein Aufrufer kann weder die Anbieter-URL wählen noch die Anweisung durch eine clientseitige system-Rolle ersetzen. Der Eigentümercode beschränkt diese Übung; er ersetzt keine öffentliche Authentifizierung und dauerhafte Ausgabenkontrolle.

Die Funktion generate ist ein lokaler Helfer in netlify/functions/mini-chat.mjs und kein weiterer bereitgestellter Dienst. Bearbeite für die Aufgabe die an generate übergebene Anweisungszeichenkette in dieser Serverdatei, um die Tutorrolle zu ändern. Eine Frontend-.env-Variable ist keine Alternative: Ein im Browsercode eingesetzter Wert wird öffentlich.

Öffne für die vollständige lokale Reihenfolge run-locally.txt: Bereite die private Umgebung im Stamm vor, verknüpfe ausschließlich das Übungsprojekt und starte den Netlify-Funktionsproxy. server-env.example.txt führt Variablennamen ohne echte Geheimnisse auf. Nur das HTML zu öffnen kann den Server nicht ausführen.

Nutze die aktuelle Modellanleitung unten oder führe list-text-models.mjs mit deiner eigenen Umgebung im privaten Workshop-Stamm aus. Es listet für das Konto sichtbare generateContent-Kandidaten auf, ohne den Schlüssel auszugeben. Wähle ein unterstütztes Textmodell, prüfe Bedingungen und Kontingent und trage seine genaue API-ID serverseitig als GEMINI_MODEL ein.

Ausgearbeitetes Beispiel

Der Verlaufsvalidator weist eine eingeschleuste system-Nachricht vor dem Anbieteraufruf ab. Er macht Modellausgaben nicht unfehlbar, hält aber Anfragestruktur und privilegierte Konfiguration unter deiner Kontrolle.

Gemini generateContent API · Gemini-API-Schlüssel · Gemini: aktuelle Modell-IDs und Fähigkeiten · Node.js: Status unterstützter Veröffentlichungen

Zusätzliche technische Übung

Sollte der Browser GEMINI_API_KEY wählen oder eine system-Nachricht senden, um den Tutor zu überschreiben?

Ausgearbeitete Lösung anzeigen

Keines von beidem. Konfiguriere Schlüssel und Rolle auf dem Server. Prüfe Clientrollen und Größen; Modellantworten müssen weiterhin auf Richtigkeit bewertet werden.

  • Hält Anbieter-Geheimnisse auf dem Server.
  • Behandelt Clientnachrichten als nicht vertrauenswürdige Gesprächseingaben.

Schritt 2 · So ergänzt du deine Website um einen KI-Chatbot

Setze das Gespräch fort und teste einen Fehler

Bewahre die eingegebene Nachricht bei fehlgeschlagener Anfrage auf.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

Sende die abhängige Nachfrage und vergleiche ihre Antwort mit dem vorherigen Austausch. Bitte deinen Assistenten, im entbehrlichen Projekt eine fehlgeschlagene Anfrage zu simulieren oder zu reproduzieren.

Die Nachfrage soll beim Gesprächsthema bleiben, und ein fehlgeschlagener Versand soll Entwurf und bisherige Nachrichten für einen neuen Versuch erhalten.

Ein konkretes Beispiel

Ein Fehler im zweiten Gesprächsschritt darf die gerade eingegebene Frage nicht löschen.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Was geschah bei der Nachfrage und beim Weg über fehlgeschlagenen Versand und Wiederholung?

Ausgearbeitete Lösung anzeigen

Veranschaulichendes Gesprächsprotokoll: „Nach der Servererklärung blieb meine Bitte um eine einfachere Fassung bei derselben Erklärung. Dann verwendete ich für einen Versand absichtlich einen falschen Übungscode; Entwurf und frühere Nachrichten blieben sichtbar. Nach Wiederherstellung des gültigen Codes konnte ich erneut senden.“

Die Ablehnung des falschen Codes ist ein absichtlicher lokaler Test und kein Anbieterausfall. Verschwindet der Entwurf oder wird beim erneuten Senden ein erfolgreicher Austausch verdoppelt, ist das Gespräch noch nicht bereit.

Was eine gute Antwort enthält

  • Vergleicht die Folgeantwort mit dem bisherigen Austausch auf thematische Kontinuität.
  • Testet einen deutlich gekennzeichneten Fehler und prüft, dass Entwurf und frühere Nachrichten für einen neuen Versuch erhalten bleiben.
So funktioniert es (optional)

Teste Fortsetzung und Fehler

Nimm die zweite Nachricht in deinen Abschlusstest auf.

Frage das DNS-Beispiel und dann eine darauf verweisende Nachfrage. Untersuche den Anfrageinhalt in den Browserwerkzeugen und vergleiche die Antwort mit der tatsächlichen letzten Frage. Eine lange flüssige Antwort belegt keine Relevanz.

Probiere für die nächste Übermittlung einen falschen Zugangscode. Der Entwurf bleibt im Textfeld, und kein fehlgeschlagener Austausch wird dem akzeptierten Verlauf angehängt. Korrigiere den Zugang und versuche erneut. Enter sendet; Shift+Enter erzeugt eine neue Zeile. Während des Wartens ist die Schaltfläche deaktiviert.

Ausgearbeitetes Beispiel

Ein Zeitlimit oder eine unvollständige Anbieterantwort erzeugt einen sichtbaren Fehler. Der Browser ergänzt keine leere assistant-Nachricht und täuscht keine Gesprächsfortsetzung vor.

Zusätzliche technische Übung

Die erste Antwort ist gut, aber die zweite Anfrage scheitert. Was sollte mit eingegebener Nachricht und Verlauf passieren?

Ausgearbeitete Lösung anzeigen

Behalte Entwurf und vorherige akzeptierte Gesprächsschritte. Zeige den Fehler ehrlich, aktiviere die Sendesteuerung wieder und ergänze das neue Paar erst nach einer gültigen Antwort.

  • Bewahrt den Entwurf für einen erneuten Versuch.
  • Speichert keine erfundene Assistentenantwort.

Schritt 3 · So ergänzt du deine Website um einen KI-Chatbot

Übergib das Gesprächsverhalten

Nutze mehrere Austausche statt einer einzelnen ansprechenden Antwort.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

Führe mit deinem künstlichen Thema einen Test mit drei Austauschen durch und bewahre ein um vertrauliche Angaben bereinigtes Protokoll auf. Wiederhole nach jeder Korrektur die Wiederaufnahme nach fehlgeschlagenem Versand.

Prüfe, dass erneutes Senden weder einen Entwurf verliert noch einen erfolgreichen Austausch verdoppelt. Kennzeichne nicht verfügbare Tests als nicht ausgeführt. Dieses Beispiel ruft keine vertrauenswürdigen Websitenotizen ab und garantiert keine sachlich richtigen Antworten. Die nächste Lektion content-chatbot ergänzt eine mitgelieferte Quellen- und Prüfaufgabe.

Ein konkretes Beispiel

Deine Nachweise sollen zeigen, was Besucher gefragt haben, was zurückkam und wie eine fehlgeschlagene Anfrage wiederholt wurde.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Lege das Protokoll und die tatsächliche Fehler- und Wiederholungsbeobachtung vor.

Dein Ergebnis: Ein kurzes Gesprächsprotokoll über mehrere Schritte und ein beobachtetes Fehler- und Wiederholungsergebnis ohne Geheimnisse.

Ausgearbeitete Lösung anzeigen

Veranschaulichender Ablauf mit drei Austauschen: „1. Erkläre einen Websiteserver. 2. Erkläre diese Antwort einfacher. 3. Gib ein Beispiel, wie dieser Server der Website hilft.“ Ein vollständiges Protokoll würde neben diesen Fragen die tatsächlichen Antworten enthalten, damit ihre Beziehung beurteilbar ist.

Veranschaulichende Wiederholungsnotiz: „Ein absichtlich abgelehnter Versand behielt seinen Entwurf; erneutes Senden ergänzte einen erfolgreichen Austausch, nicht zwei.“ Vor öffentlicher Nutzung braucht dieses eigentümerbeschränkte Beispiel noch Authentifizierung, dauerhafte Nutzungskontrollen und Kostenüberwachung. Es ist kein quellengebundenes Antwortsystem.

Was eine gute Antwort enthält

  • Enthält drei zusammenhängende Austausche und genug Kontext, um die Antworten zu beurteilen.
  • Dokumentiert die Erholung nach fehlgeschlagenem Senden ohne verlorenen Entwurf oder doppelten erfolgreichen Austausch.
So funktioniert es (optional)

Deine Aufgabe: erstelle einen Tutor, bei dem sich Nachfragen lohnen

Bewerte Relevanz, statt nur erfolgreiche Anfragen zu zählen.

Ändere die Serveranweisung zu einem knappen HTML-/CSS-Tutor. Führe drei Frage-Antwort-Paare durch: Frage nach einem defekten Anker, schlage ein falsches href-/id-Paar vor und frage, warum es scheitert. Nutze synthetischen Code und keine privaten Quellen.

Bewahre ein bereinigtes Gesprächsprotokoll auf und kommentiere, ob jede Antwort auf die jeweils neueste Nachricht eingeht. Wiederhole eine fehlgeschlagene Übermittlung und zeige, dass der erneute Versuch den Zusammenhang erhält. Plane vor öffentlichem Zugriff echte Authentifizierung, dauerhafte Kontingente pro Nutzer und eine Erklärung zum Übermittlungsziel der Nachrichten.

Ausgearbeitetes Beispiel

Ein nützlicher Tutor benennt, welche href/id nicht übereinstimmen. Allgemeine Hinweise zu Variablennamen würden die konkrete Lernantwort verfehlen, auch wenn sie technisch richtig sind.

Die vollständige exemplarische Anleitung findest du in reference/assignment-walkthrough.txt. Vergleiche ihre Schritte mit deinem Ergebnis und fülle das Testprotokoll mit Beobachtungen aus deinem eigenen Projekt aus.

Zusätzliche technische Übung

Erstelle ein Protokoll mit drei Frage-Antwort-Paaren und eine Fehler-/Wiederholungsbeobachtung.

Ausgearbeitete Lösung anzeigen

Ändere die Anweisungszeichenkette in der Serverfunktion zu einem knappen HTML-/CSS-Tutor. Ändere keine Frontendvariable und verschiebe generate nicht in den öffentlichen Ordner. Die Referenzfunktion ist eine vollständige Version mit geänderter Anweisung.

Beispielbewertung: Ein Nutzer fragt, warum <a href='#work'> nicht <section id='projects'> erreicht. Eine relevante Antwort benennt diese href-/id-Abweichung. Als Nächstes schlägt der Nutzer href='#projects' vor; eine relevante Nachfrageantwort prüft genau diese Korrektur. Allgemeine Variablennamenhinweise würden den Test selbst bei HTTP-Status 200 nicht bestehen.

Sende in einem späteren Schritt mit falschem Übungscode. Das akzeptierte Gespräch muss intakt bleiben, und das Textfeld muss den ungesendeten Entwurf behalten. Korrigiere den Zugang und wiederhole; ergänze ein neues user-/assistant-Paar erst nach einer gültigen Antwort. Dieses Beispielprotokoll ist eine Bewertungsanleitung und behauptet kein live generiertes Ergebnis.

  • Nachfragen werden anhand der tatsächlichen vorherigen Nachrichten beantwortet.
  • Fehler erhalten Entwurf und Verlauf; der Anbieterschlüssel bleibt privat.

War diese Lektion hilfreich?

Hinterlasse ein Like oder teile sie mit jemandem, dem sie helfen könnte.