# Versionen und Entwürfe

Den Agenten vor einer Änderung sichern, im Entwurf experimentieren und mit einem Klick zurücksetzen

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Eine **Version** ist eine Momentaufnahme des Agenten — Prompt, Einstellungen, Modell, Tools, Wissensdatenbank und Auditor —, zu der Sie zurückkehren können. Ein **Entwurf** ist eine versteckte Kopie des Agenten für Experimente: Sie testen ihn und übernehmen ihn anschließend in die Hauptversion.

Beides finden Sie im Panel **Versionen** in der oberen Leiste des Agenten; **Gesamten Verlauf öffnen** zeigt jede Version mit ihrem Diff.

<VersionsPageDemo />

## Versionen [#versions]

**Speichern** übernimmt nur den aktuellen Stand des Agenten in den Live-Betrieb — eine Version entsteht dabei nicht. So legen Sie einen Stand an, zu dem Sie zurückkehren können:

1. **Versionen** > **Version erstellen**. Die Schaltfläche zeigt die ausstehende Änderung (`+N −M`) und ist deaktiviert, wenn sich seit der letzten Version nichts geändert hat.
2. Beschreiben Sie **Was hat sich geändert** — z. B. „Abschnitt zur Lieferung im Prompt neu geschrieben“ — und klicken Sie auf **Version erstellen**.

Happ legt Versionen auch automatisch an: wenn ein Agent oder Entwurf erstellt wird, vor einer Wiederherstellung oder Veröffentlichung (**Auto-Speichern**) und wenn ein externer KI-Agent ihn über den [MCP-Server](/docs/settings/mcp) bearbeitet (**KI-Bearbeitung**).

### Verlauf [#history]

**Gesamten Verlauf öffnen** zeigt die letzten 50 Versionen mit ihrer Herkunft — **gespeichert**, **Auto-Speichern**, **Rücksetzung**, **veröffentlicht**, **KI-Bearbeitung** —, Autor und Notiz. Wählen Sie eine aus, um den Diff zur vorherigen Version zu sehen, gruppiert nach Abschnitt: Prompt, Einstellungen, Modell und Anbieter, Tools, Wissensdatenbank, Auditor. **Diese Version anrufen** startet einen Testanruf mit der Stimme dieser Version, ohne den Live-Agenten zu verändern.

### Wiederherstellen [#restore]

**Wiederherstellen** ersetzt die Konfiguration des Agenten durch die gewählte Version. Der aktuelle Stand wird vorher automatisch gesichert, und die Wiederherstellung wird als neue Version vom Typ **Rücksetzung** oben angefügt — der Verlauf wächst nur weiter, nichts geht verloren. Der Sprachagent wird neu synchronisiert, und geänderte Wissensdokumente werden automatisch neu indexiert.

## Entwürfe [#drafts]

Ein Entwurf funktioniert im Playground und in [Tests](/docs/agents/tests), ist aber **nicht mit Kanälen oder Telefonnummern verbunden** — Kunden erreichen ihn nie.

1. **Versionen** > Zweig-Menü > **Neuer Entwurf von hier**, geben Sie einen Namen ein (Standard „Dev“).
2. Bearbeiten Sie den Entwurf auf denselben Seiten wie den Agenten. Stimmeinstellungen sind im Entwurf schreibgeschützt; das Textmodell ist bearbeitbar.
3. Testen Sie ihn: **Test** in der oberen Leiste oder **Tests** > **Ausführen auf** > Entwurf auswählen.
4. **Diesen Entwurf live schalten** zeigt den Diff zur Hauptversion und veröffentlicht ihn: Prompt, Einstellungen, Tools und Auditor des Entwurfs überschreiben die Hauptversion, eine Version vom Typ **veröffentlicht** wird angelegt, und der Entwurf wird gelöscht.

Um einen Entwurf aus einer älteren Version zu starten, öffnen Sie sie im Verlauf und wählen Sie &#x2A;*⋯** > **Entwurf von hier**.

Limits: bis zu **3 Entwürfe** pro Agent; von einem Entwurf lässt sich kein weiterer Entwurf anlegen. Die Wissensdatenbank wird mit der Hauptversion geteilt und ist im Entwurf schreibgeschützt. Tools, die Bestellungen oder Leads in Ihrem CRM anlegen, werden nicht in einen Entwurf kopiert, sodass Experimente keine echten Datensätze erzeugen können. Wurde die Hauptversion nach dem Erstellen des Entwurfs geändert, erhalten Sie beim Veröffentlichen eine Warnung — diese Änderungen werden überschrieben.

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Weiter [#next]

* [Tests](/docs/agents/tests) — belegen, dass der Entwurf besser ist, bevor Sie ihn veröffentlichen
* [Agenten](/docs/agents) — welche Einstellungen der Agent hat
* [MCP](/docs/settings/mcp) — Claude oder Cursor den Agenten bearbeiten lassen, jede Änderung wird versioniert