
Mini-Lektion · Deutsch
So ergänzt du deine Website um einen KI-Chatbot
Starte einen fertigen privaten Chatbot mit einem Programmierassistenten und prüfe, ob eine Nachfrage den Gesprächskontext nutzt und eine fehlgeschlagene Anfrage übersteht.
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.
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.
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.
Was du lernen wirst
- 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.
Schritt 1
Wähle ein kleines Testgespräch
Die zweite Nachricht soll von der ersten abhängen.
Ö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
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (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.
Extra implementation exercise
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.
Häufiger Fehler
Eine Folge unabhängiger vorgefertigter Antworten als Gespräch bezeichnen.
Schritt 2
Starte den bereitgestellten Chatbot
Lass den Assistenten die private Serverkonfiguration übernehmen.
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.
Gemini generateContent API · Gemini-API-Schlüssel · Gemini: aktuelle Modell-IDs und Fähigkeiten · Node.js: Status unterstützter Veröffentlichungen
Selbst ausprobieren
Hat die laufende App eine echte erste Antwort erzeugt, oder wo endete die Einrichtung?
Besprich deine Antwort mit dem Tutor
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.
- 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.
Dateien für diesen Schritt
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (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
Extra implementation exercise
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.
Häufiger Fehler
Clientseitigen Rollen vertrauen, weil die normale Oberfläche sie nicht zugänglich macht.
Schritt 3
Setze das Gespräch fort und teste einen Fehler
Bewahre die eingegebene Nachricht bei fehlgeschlagener Anfrage auf.
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.
Selbst ausprobieren
Was geschah bei der Nachfrage und beim Weg über fehlgeschlagenen Versand und Wiederholung?
Besprich deine Antwort mit dem Tutor
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.
- 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.
Dateien für diesen Schritt
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (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.
Extra implementation exercise
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.
Häufiger Fehler
Nur „hello“ testen und das ganze Gespräch für funktionsfähig erklären.
Schritt 4
Übergib das Gesprächsverhalten
Nutze mehrere Austausche statt einer einzelnen ansprechenden Antwort.
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.
Selbst ausprobieren
Material zum Einstieg
Dateien und Testinhalte sind vorhanden. Eine echte Dienstprüfung benötigt dein eigenes Konto, Postfach oder deine Domain gemäß den Voraussetzungen. Lokales Prüfen bleibt möglich; kennzeichne nicht ausgeführte Live-Schritte als ungetestet.
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.
Besprich deine Antwort mit dem Tutor
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.
- 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.
Dateien für diesen Schritt
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- netlify/functions/mini-chat.mjsDiese Datei herunterladen
- conversation-tests.txtDiese Datei herunterladen
- worksheet.htmlDiese Datei herunterladen
- reference/assignment-walkthrough.txtDiese Datei herunterladen
- reference/START-HERE.txtDiese Datei herunterladen
- reference/netlify/functions/mini-chat.mjsDiese Datei herunterladen
How it works (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.
Extra implementation exercise
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.
Häufiger Fehler
Eine KI-Anbindung allein nach HTTP-Erfolg bewerten.
War diese Lektion hilfreich?
Hinterlasse ein Like oder teile sie mit jemandem, dem sie helfen könnte.
Weiterlernen
- So erstellst du deine erste persönliche Website
- So veröffentlichst du deine Website über GitHub
- So verbindest du eine eigene Domain mit deiner Website
- So richtest du E-Mail auf deiner eigenen Domain ein
- So machst du deine Website auf Telefonen benutzbar
- So laden Bilder deiner Website schneller
- So erhältst du Website-Feedback in deinem Postfach
- So ergänzt du deine Website um E-Mail-Abonnements
- So sendest du automatisierte E-Mails von deiner Website
- So speicherst du Formulareingaben in einer Datenbank
- So können sich Menschen auf deiner Website anmelden
- So hältst du eine Seite privat
- So können Nutzer ihre Profilinformationen bearbeiten
- So können Nutzer Bilder hochladen
- So hältst du API-Schlüssel aus deinem Frontend heraus
- So zeigst du Daten einer externen API auf deiner Website
- So beantwortet ein Chatbot Fragen anhand deiner eigenen Inhalte
- So ergänzt du deine Website um einen Blog
- So ergänzt du deine Website um eine Suche
- So ergänzt du deine Website um eine weitere Sprache
- So hilfst du Google, deine Website zu finden
- So reparierst du die Vorschau deiner Website beim Teilen eines Links
- So misst du Besuche und nützliche Aktionen auf deiner Website
- So können Besucher einen Termin buchen
- So nimmst du eine Zahlung auf deiner Website an
- So prüfst du Website-Änderungen vor dem Veröffentlichen
- So machst du ein fehlerhaftes Website-Deployment rückgängig
- So sicherst du deine Website-Daten und stellst sie wieder her
- So findest und behebst du Fehler auf deiner veröffentlichten Website