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.

Interaktive Lektion startenLektionsnotizen lesen

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.

Workshop-Dateien

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

Start hereWorkshop-Dateien

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.

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

Dateien für diesen Schritt

Start hereWorkshop-Dateien

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.

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.

Dateien für diesen Schritt

Start hereWorkshop-Dateien

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.

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.

Dateien für diesen Schritt

Start hereWorkshop-Dateien

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

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.

War diese Lektion hilfreich?

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

Weiterlernen

Weitere Lektionen entdecken