For the complete documentation index, see llms.txt. This page is also available as Markdown.

Versionen & Bereitstellungsumgebungen

Versionen erfassen den exakten Entwicklungsstand deines AI Agents zu einem bestimmten Zeitpunkt. Sie bilden die Grundlage für jede Bereitstellung.

Wo finde ich Versionen?

Den Bereich für Versionen erreichst du über AI Agent → Versionen.

Dort findest du:

  • Umgebungskacheln (oben): Drei farbige Kacheln zeigen dir auf einen Blick, welche Version mit welchem zugrundeliegenden Modell derzeit in welcher Umgebung bereitgestellt ist und seit wann.

  • Versionsliste (unten): Eine Tabelle aller existierenden Versionen mit Versionsnummer, Name, Erstellungszeitpunkt, Modell, Bereitstellungsstatus und ID.


Erklärung – Was genau sind Versionen?

Eine Version ist ein Snapshot – also eine Momentaufnahme – deines AI Agents. Sie speichert den gesamten Entwicklungsstand genau so, wie er im Moment der Erstellung aussieht. Spätere Änderungen im Flow Builder fließen nicht in eine bereits erstellte Version ein.

Voraussetzung: Trainiertes Modell

Jeder Version liegt ein trainiertes Modell zugrunde. Bevor du eine Version erstellen kannst, muss mindestens ein Modell trainiert worden sein. Es wird automatisch das zuletzt trainierte Modell als Grundlage verwendet.

Warum brauche ich Versionen?

Um deinen AI Agent in einer Umgebung (Test oder Produktiv) bereitzustellen, muss eine Version erstellt worden sein.

Vergabe von Versionsnummern

Das System nutzt ein numerisches Format (z. B. 1.0, 2.2) und unterscheidet automatisch zwischen zwei Arten:

Typ

Beschreibung

Kriterium

Major Update

Die erste Ziffer erhöht sich (z. B. 2.0).

Ein neues Modell liegt der Version zugrunde.

Minor Update

Die zweite Ziffer erhöht sich (z. B. 1.1).

Änderungen am Flow/Inhalt ohne Modellwechsel.

Die Versionsnummer wird beim Erstellen automatisch zugewiesen und ist im Erstellungsdialog sichtbar.

Die drei Bereitstellungsumgebungen

Es existieren drei getrennte Umgebungen, um einen sicheren Release-Zyklus zu gewährleisten:

  • Entwicklungsumgebung (DEV): Wenn du ein neues Modell trainierst, wird dieses automatisch in der Entwicklungsumgebung bereitgestellt. Diese Umgebung dient der internen Entwicklung und dem Debugging.

  • Testumgebung (TEST): Stelle eine Version in der Testumgebung bereit, damit du und andere Benutzer den AI Agent auf einem realen Kanal testen können – z. B. über das Web-Widget oder eine intern bekannte Telefonnummer.

  • Produktivumgebung (PROD): Stelle eine Version in der Produktivumgebung bereit, damit alle Nutzer darauf zugreifen können. Diese Version ist über alle Kanäle erreichbar.

Entwicklung

Spiegelt den aktuellen Live-Stand im Flow Builder wider.

Test

Zur internen Qualitätssicherung von stabilen Versionen.

Produktiv

Die finale Instanz für Endbenutzer.

Kanäle können in jeder der Bereitstellungsumgebungen angelegt werden. Achte darauf, dass nur die Kanäle für Endkunden erreichbar gemacht werden, die in der Produktivumgebung operieren.


Verwendung – Was kann man mit Versionen machen?

Neue Version erstellen und bereitstellen

  1. Klicke oben rechts auf „Version erstellen".

  2. Name: Vergib einen aussagekräftigen Namen.

    • Beispiel: „Black Week 2026"

  3. Beschreibung (optional): Beschreibe die vorgenommenen Änderungen, um Transparenz und Nachvollziehbarkeit zu gewährleisten.

    • Beispiel: „Hinzufügen des Lieferverzögerungshinweises, Erweiterung der FAQs um Informationen zur Black Week."

  4. Vorgesehenes Modell: Es wird automatisch das aktuellste Modell als Grundlage genutzt. Eine manuelle Auswahl ist nicht möglich.

  5. Bereitstellung: Wähle die Zielumgebung aus (Test oder Produktiv). Wähle „Keine Bereitstellung", wenn die Version erst einmal nur gesichert werden soll.

  6. Bestätige mit „Version veröffentlichen".

Version nachträglich bereitstellen

Du kannst eine bereits erstellte Version auch nachträglich in einer Umgebung bereitstellen:

  1. Wähle die gewünschte Version aus der Liste aus.

  2. Klicke auf „Bereitstellen".

  3. Wähle die Zielumgebung: „Keine Bereitstellung" (Version nur erstellen), „Test" (zum Testen vor dem Go-Live) oder „Produktiv" (für alle Nutzer erreichbar).

  4. Bestätige mit „Bereitstellen".

In der Übersicht erscheint kurz der Status „In Bereitstellung". Der Zeitstempel wird gesetzt, sobald die Version erfolgreich bereitgestellt wurde. Es kann einige Minuten dauern, bis eine Version erfolgreich bereitgestellt und das Umgebungslabel aktualisiert wird.

Es kann einige Minuten dauern, bis eine Version erfolgreich bereitgestellt und das Umgebungslabel aktualisiert wird.

Versionsdetails einsehen

Durch Klick auf eine beliebige Version in der Liste öffnest du die Detailansicht. Diese ist in zwei Bereiche unterteilt:

Details: Name der Version, Versionsnummer, zugrundeliegende Modell-ID, aktueller Bereitstellungsstatus und Versions-ID. Wurde beim Erstellen eine Beschreibung hinterlegt, wird sie hier ebenfalls angezeigt.

Bereitstellung: Zeitstempel für Erstellung und (falls bereitgestellt) Bereitstellung sowie die zugehörige Deployment-ID.

Auf eine Version zurücksetzen

Über den Button „Zurücksetzen" im Bereich „Auf Version zurücksetzen" kannst du den Flow Builder auf den Entwicklungsstand der gewählten Version zurücksetzen.

Im Bestätigungsdialog kannst du zusätzlich per Schalter „Einstellungen ebenfalls zurücksetzen" festlegen, ob auch die allgemeinen Einstellungen deines AI Agents auf den Stand dieser Version zurückgesetzt werden sollen. Ist der Schalter deaktiviert, bleiben deine aktuellen Einstellungen erhalten und nur der Flow-Stand wird zurückgesetzt.


Verwaltung – Löschen von Versionen

Einzelne Version löschen

  1. Öffne die Detailansicht der gewünschten Version.

  2. Klicke auf „Löschen" (roter Button unten rechts).

  3. Bestätige den Löschvorgang im Bestätigungsdialog.

Mehrere Versionen löschen

  1. Markiere die gewünschten Versionen per Checkbox in der Versionsliste.

  2. Klicke auf den Mülleimer-Button oben rechts.

  3. Bestätige den Löschvorgang.


Beispiel: Version erstellen, testen und live stellen

Das folgende Beispiel zeigt den empfohlenen Ablauf von der Entwicklung bis zur Live-Schaltung:

Szenario: Du hast neue FAQs zur Black Week hinzugefügt und einen Hinweis auf Lieferverzögerungen ergänzt.

  1. Modell trainieren: Trainiere ein neues Modell, um die Änderungen an Intentionen und Entitäten zu übernehmen. Das neue Modell wird automatisch in der Entwicklungsumgebung (DEV) bereitgestellt.

  2. Testen im Debug: Teste die Änderungen direkt in der Plattform über die Entwicklungsumgebung.

  3. Version erstellen: Gehe zu Hauptnavigation → Versionen und klicke auf „Version erstellen". Vergib den Namen „Black Week 2026" und die Beschreibung „Hinzufügen des Lieferverzögerungshinweises, Erweiterung der FAQs um Informationen zur Black Week." Wähle als Bereitstellung die Testumgebung aus.

  4. Interner Test: Teste die Version auf einem realen Kanal in der Testumgebung – z. B. über das Web-Widget oder eine intern bekannte Telefonnummer.

  5. Live stellen: Nach erfolgreicher Abnahme öffnest du die Detailansicht der Version und stellst sie in der Produktivumgebung bereit.

  6. Iteration: Bei weiteren Änderungen beginnst du den Prozess wieder bei Schritt 1.


Best Practices

  • Immer zuerst testen: Stelle neue Versionen zunächst in der Testumgebung bereit und prüfe sie auf einem realen Kanal, bevor du sie in der Produktivumgebung live schaltest.

  • Aussagekräftige Namen und Beschreibungen verwenden: Benenne Versionen so, dass du auch nach Wochen noch weißt, welche Änderungen sie enthalten. Nutze die Beschreibung, um konkrete Änderungen zu dokumentieren.

  • Vor dem Zurücksetzen absichern: Erstelle eine neue Version, bevor du den Flow Builder auf einen älteren Stand zurücksetzt. So geht kein aktueller Entwicklungsstand verloren.

  • Bereitgestellte Versionen nicht leichtfertig löschen: Prüfe vor dem Löschen, ob eine Version aktuell bereitgestellt ist. Das Löschen einer bereitgestellten Version macht deinen AI Agent für Endnutzer unerreichbar.

  • Kanäle bewusst zuordnen: Achte darauf, dass nur Kanäle, die in der Produktivumgebung operieren, für Endkunden erreichbar sind (siehe Artikel „Kanäle").

Last updated