> For the complete documentation index, see [llms.txt](https://docs.epic-ai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.epic-ai.com/epic-ai-platform/epic-ai-platform/ai-agent/versionen-and-bereitstellungsumgebungen.md). # Versionen & Bereitstellungsumgebungen Versionen erfassen den exakten Entwicklungsstand deines AI Agents zu einem bestimmten Zeitpunkt. Sie bilden die Grundlage für jede Bereitstellung. ## Versionen & Bereitstellungsumgebungen ### Wo finde ich Versionen? Den Bereich für Versionen erreichst du in der linken Navigation über *Versionen*. Dort findest du: * **Umgebungskacheln (oben):** Drei farbige Kacheln zeigen dir auf einen Blick, welche Version mit welchem zugrundeliegenden [Modell](/epic-ai-platform/epic-ai-platform/ai-agent/daten/modelle.md) derzeit in welcher Umgebung bereitgestellt ist – und seit wann. * **Versionsliste (unten):** Eine Tabelle aller Versionen mit Versionsnummer, Name, Erstellungszeitpunkt, Modell, Bereitstellungsstatus und ID. ### Was ist eine Version? Eine Version ist ein Snapshot – eine Momentaufnahme – deines space.vars.TERM\_AI\_AGENTs. Sie speichert den gesamten Entwicklungsstand genau so, wie er im Moment der Erstellung aussieht. Spätere Änderungen im [space.vars.TERM\_FLOW\_BUILDER](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder.md) 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 – automatisch wird das zuletzt trainierte Modell als Grundlage verwendet. #### Warum brauche ich Versionen? Um deinen space.vars.TERM\_AI\_AGENT in einer Umgebung (Test oder Produktiv) bereitzustellen, muss eine Version erstellt worden sein. #### Wie Versionsnummern vergeben werden Das System nutzt ein numerisches Format (z. B. 1.0, 2.2) und unterscheidet automatisch zwischen zwei Arten: | Typ | Kriterium | Beispiel | | ------------ | -------------------------------------------------- | -------------------------------------- | | Major Update | Ein neues Modell liegt der Version zugrunde. | Die erste Ziffer erhöht sich (`2.0`). | | Minor Update | Änderungen am Flow oder Inhalt ohne Modellwechsel. | Die zweite Ziffer erhöht sich (`1.1`). | Die Versionsnummer wird beim Erstellen automatisch zugewiesen und ist im Erstellungsdialog sichtbar. ### Bereitstellungsumgebungen Es gibt drei getrennte Umgebungen, die einen sicheren Release-Zyklus ermöglichen: * **Entwicklung (DEV):** Trainierst du ein neues Modell, wird es automatisch hier bereitgestellt. Die Umgebung spiegelt deinen aktuellen Stand im space.vars.TERM\_FLOW\_BUILDER wider und dient der internen Entwicklung und dem [Debugging](/epic-ai-platform/epic-ai-platform/ai-agent/debugging.md). * **Test (TEST):** Stelle eine Version hier bereit, damit du und andere Benutzer den space.vars.TERM\_AI\_AGENT auf einem realen [Kanal](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale.md) testen können – z. B. über das Web-Widget oder eine intern bekannte Telefonnummer. * **Produktiv (PROD):** Stelle eine Version hier bereit, damit alle Nutzer darauf zugreifen können. Diese Version ist über alle Kanäle erreichbar. {% hint style="info" %} Kanäle lassen sich in jeder Umgebung anlegen. Achte darauf, dass nur die Kanäle für Endkunden erreichbar sind, die in der Produktivumgebung operieren. {% endhint %} ### Mit Versionen arbeiten #### Neue Version erstellen und bereitstellen {% stepper %} {% step %} Klicke oben rechts auf *Version erstellen*. {% endstep %} {% step %} **Name:** Vergib einen aussagekräftigen Namen – z. B. „Black Week 2026". {% endstep %} {% step %} **Beschreibung (optional):** Beschreibe die vorgenommenen Änderungen für mehr Transparenz und Nachvollziehbarkeit – z. B. „Hinzufügen des Lieferverzögerungshinweises, Erweiterung der FAQs um Informationen zur Black Week." {% endstep %} {% step %} **Vorgesehenes Modell:** Es wird automatisch das aktuellste Modell als Grundlage genutzt. Eine manuelle Auswahl ist nicht möglich. {% endstep %} {% step %} **Bereitstellung:** Wähle die Zielumgebung *Test* oder *Produktiv*. Mit *Keine Bereitstellung* wird die Version zunächst nur gesichert. {% endstep %} {% step %} Bestätige mit *Version veröffentlichen*. {% endstep %} {% endstepper %} #### Version nachträglich bereitstellen Du kannst eine bereits erstellte Version auch nachträglich in einer Umgebung bereitstellen: {% stepper %} {% step %} Wähle die gewünschte Version aus der Liste. {% endstep %} {% step %} Klicke auf *Bereitstellen*. {% endstep %} {% step %} Wähle die Zielumgebung: *Keine Bereitstellung* (nur sichern), *Test* (zum Testen vor dem Go-live) oder *Produktiv* (für alle Nutzer erreichbar). {% endstep %} {% step %} Bestätige mit *Bereitstellen*. {% endstep %} {% endstepper %} In der Übersicht erscheint kurz der Status *In Bereitstellung*. Der Zeitstempel wird gesetzt, sobald die Version erfolgreich bereitgestellt wurde. {% hint style="info" %} Es kann einige Minuten dauern, bis eine Version bereitgestellt und das Umgebungslabel aktualisiert ist. {% endhint %} #### Versionsdetails einsehen Ein Klick auf eine Version in der Liste öffnet die Detailansicht. Sie ist in zwei Bereiche unterteilt: * **Details:** Name, Versionsnummer, zugrundeliegende Modell-ID, aktueller Bereitstellungsstatus und Versions-ID. Eine beim Erstellen hinterlegte Beschreibung wird 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* setzt du den space.vars.TERM\_FLOW\_BUILDER auf den Entwicklungsstand der gewählten Version zurück. Im Bestätigungsdialog legst du per Schalter *Einstellungen ebenfalls zurücksetzen* fest, ob auch die allgemeinen Einstellungen deines space.vars.TERM\_AI\_AGENTs auf den Stand dieser Version zurückgesetzt werden. Ist der Schalter deaktiviert, bleiben deine aktuellen Einstellungen erhalten und nur der Flow-Stand wird zurückgesetzt. {% hint style="danger" %} Nicht gespeicherte Änderungen im space.vars.TERM\_FLOW\_BUILDER gehen beim Zurücksetzen verloren. Erstelle bei Bedarf vorher eine neue Version, um den aktuellen Stand zu sichern. {% endhint %} ### Versionen löschen #### Einzelne Version löschen {% stepper %} {% step %} Öffne die Detailansicht der gewünschten Version. {% endstep %} {% step %} Klicke auf *Löschen* (roter Button unten rechts). {% endstep %} {% step %} Bestätige den Löschvorgang im Bestätigungsdialog. {% endstep %} {% endstepper %} #### Mehrere Versionen löschen {% stepper %} {% step %} Markiere die gewünschten Versionen per Checkbox in der Versionsliste. {% endstep %} {% step %} Klicke oben rechts auf den Mülleimer-Button. {% endstep %} {% step %} Bestätige den Löschvorgang. {% endstep %} {% endstepper %} {% hint style="danger" %} Löschst du eine Version, die aktuell bereitgestellt ist, wird die Bereitstellung sofort abgebrochen. Dein space.vars.TERM\_AI\_AGENT ist für Benutzer auf dem entsprechenden Kanal dann vorübergehend nicht mehr erreichbar. Der Löschvorgang kann **nicht** rückgängig gemacht werden. {% endhint %} ### 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. {% stepper %} {% step %} **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. {% endstep %} {% step %} **Im Debug testen:** Prüfe die Änderungen direkt in der Plattform über die Entwicklungsumgebung. {% endstep %} {% step %} **Version erstellen:** Gehe in der Navigation zu *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*. {% endstep %} {% step %} **Intern testen:** Teste die Version auf einem realen Kanal in der Testumgebung – z. B. über das Web-Widget oder eine intern bekannte Telefonnummer. {% endstep %} {% step %} **Live stellen:** Nach erfolgreicher Abnahme öffnest du die Detailansicht der Version und stellst sie in der *Produktivumgebung* bereit. {% endstep %} {% step %} **Iterieren:** Bei weiteren Änderungen beginnst du den Prozess wieder bei Schritt 1. {% endstep %} {% endstepper %} ### 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 space.vars.TERM\_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 space.vars.TERM\_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 [Kanäle](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale.md)).