Was sind Stages?

Stell dir Stages wie Kapitel in einem Buch vor. Jedes Kapitel hat eigene Inhalte, und du kannst gezielt zwischen ihnen navigieren. Für den Nutzer wechselt sich dabei der Kontext – der Bot reagiert je nach Stage anders.

Wann brauche ich Stages?

  • Der Bot soll verschiedene Themen nacheinander abarbeiten (z. B. Onboarding: Begrüßung → IT-Setup → Hausordnung)
  • Verschiedene Wissensbereiche sollen getrennt bleiben
  • Du möchtest Nutzer durch einen strukturierten Prozess führen
  • Der Bot soll je nach Stage ein anderes Dokument oder andere Skills nutzen
📸
Screenshot
Stage-Manager-Übersicht: Liste der Stages mit Titel, Reihenfolge und Status-Badges

Eine Stage erstellen

Öffne den Tab „Stage-Manager" im Bot-Editor und klicke auf „Stage hinzufügen".

FeldBeschreibungBeispiel
Titel Name der Stage (erscheint im Browser-Tab und in der Navigation) „Willkommen"
Identifikator Eindeutige ID für Blockly-Steuerung (nur Buchstaben, Zahlen, Bindestriche) „willkommen"
Reihenfolge Nummer für „Nächste Stage" / „Vorherige Stage" Navigation 1, 2, 3…
Stage verbergen Stage aus der automatischen Navigation ausschließen z. B. für Fehler-Stages
Fußzeile anzeigen Chat-Eingabe und Footer in dieser Stage sichtbar? Deaktivieren für reine Info-Stages
📸
Screenshot
Stage bearbeiten: Formular mit Titel, Identifikator, Reihenfolge und Fußzeile-Toggle

Skills pro Stage zuweisen

Im Stage-Manager kannst du festlegen, welche Skills beim Betreten einer Stage automatisch aktiviert werden – alle anderen werden deaktiviert.

💡
Praxisbeispiel

Stage „IT-Setup": Nur das Dokument „IT-Handbuch.pdf" ist aktiv.
Stage „Kantinenpläne": Nur das Dokument „Kantine.pdf" ist aktiv.
So antwortet der Bot immer kontextgenau.

Stage-Einstieg und -Ausstieg mit Blockly

Für jede Stage kannst du optional Blockly-Code hinterlegen, der beim Betreten oder Verlassen ausgeführt wird.

HookWann ausgeführt?Typische Nutzung
Stage-Einstieg Genau einmal, wenn die Stage betreten wird Begrüßungsnachricht, Buttons anzeigen, Variable setzen
Stage-Ausstieg Genau einmal, wenn die Stage verlassen wird Score auswerten, Zusammenfassung senden, Overlay schließen

Zwischen Stages navigieren (Blockly)

Die Stage-Navigation erfolgt über Blockly-Blöcke der Kategorie „Stages":

BlockFunktion
Gehe zu Stage: [ID]Navigiert zu einer bestimmten Stage per Identifikator
Nächste StageGeht zur Stage mit der nächsthöheren Reihenfolge
Vorherige StageGeht zur Stage mit der nächstniedrigeren Reihenfolge
Erste StageSpringt zur Stage mit der niedrigsten Reihenfolge
Letzte StageSpringt zur Stage mit der höchsten Reihenfolge
📸
Screenshot
Blockly-Workspace: Button-Block mit „Bei Klick: Gehe zu Stage willkommen"-Logik

Praxisbeispiel: Onboarding-Ablauf mit 3 Stages

Hier siehst du ein vollständiges Beispiel, wie ein strukturierter Onboarding-Bot aufgebaut werden kann:

StageTitelInhaltSkillsNavigation
1 Willkommen Begrüßungstext + Erklärung des Ablaufs + „Weiter"-Button Keine Button → Stage 2
2 IT-Setup Fragen zum IT-Setup beantwortet der Bot aus dem Handbuch IT-Handbuch.pdf Button „Weiter zu Hausordnung" → Stage 3
3 Hausordnung Wichtigste Regeln werden erklärt, Quizfrage am Ende Hausordnung.pdf Nach Quiz: Stage 1 (Neustart) oder Ende
💡
Tipp: Ablaufdiagramm zuerst

Bevor du mit Stages in der KI-Toolbox beginnst, zeichne den Gesprächsfluss auf einem Blatt Papier oder in einem Diagramm-Tool. Bestimme: Wie viele Stages? Welche Übergänge? Welche Skills pro Stage?

Vorbedingungen für Stages

Du kannst eine Stage mit einer Vorbedingung versehen. Sie verhindert, dass Nutzer direkt in eine Stage springen können, wenn eine bestimmte Bedingung nicht erfüllt ist (z. B. Quiz noch nicht abgeschlossen). Die Vorbedingung ist ein einfacher JavaScript-Vergleich, der true oder false zurückgibt.

⚠️
Fortgeschrittenes Feature

Vorbedingungen erfordern grundlegende JavaScript-Kenntnisse. Lass dieses Feature zunächst weg und aktiviere es erst, wenn du mit den Grundlagen vertraut bist.

✏️ Übung

Lege 2 Stages an

  1. Öffne den Stage-Manager deines Bots.
  2. Erstelle Stage 1: Titel „Begrüßung", ID „begruessing", Reihenfolge 1.
  3. Erstelle Stage 2: Titel „Hauptthema", ID „hauptthema", Reihenfolge 2.
  4. Öffne Blockly und füge im Stage-1-Einstieg einen Bot-Nachricht-Block mit einem Willkommenstext hinzu.
  5. Füge einen Button-Block ein: „Los geht's" → Gehe zu Stage „hauptthema".
  6. Teste den Bot: Erscheint der Button? Funktioniert der Wechsel?