# Agenten als Datei exportieren und importieren

> Sichere die Einstellungen eines Agenten als JSON-Datei und übertrage sie auf einen anderen Agenten. Was in der Datei steht und was beim Import passiert.

Quelle: https://docs.qutee.ai/agenten/agent-exportieren-importieren/

Du kannst die Einstellungen eines Agenten als Datei herunterladen und in einen anderen Agenten hochladen. Das hilft, wenn du einen gut eingerichteten Agenten als Vorlage für einen weiteren Standort nutzen oder vor größeren Änderungen einen Stand sichern willst.

Die Datei ist eine JSON-Datei. Du brauchst sie nicht zu bearbeiten. Wer sich mit JSON auskennt, kann Texte darin aber auch direkt ändern.

## Bevor du loslegst

- Du brauchst die Rolle **Unternehmensadmin**. Mit der Rolle **Benutzer** siehst du den Bereich **Agenten** nicht.
- Für den Import brauchst du einen vorhandenen Agenten, in den du die Datei lädst. Einen neuen Agenten legt der Import nicht an. Neue Agenten und Rufnummern richten wir für dich ein, schreib uns dafür an [hey@qutee.ai](mailto:hey@qutee.ai).

## Was in der Datei steht

| In der Datei | Nicht in der Datei |
| --- | --- |
| Aus dem Reiter **Persönlichkeit**: Name, interne Notiz, Rolle, Aufgabe, Persona, **Standard-Begrüßung**, **Geplante Begrüßungen**, Organisation, Organisationsbeschreibung, zusätzliche Anweisungen und die **Stimme** | **Rufnummer** |
| Ob der Agent aktiv ist | Aus dem Reiter **Verfügbarkeit**: Zeitzone, **Aktivitätszeitplan**, Verhalten außerhalb der Aktivitätszeit und die Einstellungen zu Benachrichtigungen |
| Alle Aktionen vom Typ **Weiterleitung**, **Auskunft** und **Informationserfassung**, mit ihren Zeitplänen und den E-Mail-Empfänger:innen der Informationserfassung | Aktionen vom Typ **Terminbuchung** |
| | **Stille-Erkennung**, Tempo der Begrüßung und die Einstellungen für mehrere Sprachen |

Die Datei enthält Telefonnummern aus deinen Weiterleitungen und E-Mail-Adressen deiner Empfänger:innen. Gib sie nur an Personen weiter, die diese Daten sehen dürfen.

## Agent exportieren

1. Öffne **Agenten** und wähle oben den Agenten aus.
2. Klicke rechts neben den Reitern auf das Download-Symbol (**Agent herunterladen**).

Dein Browser lädt eine Datei mit einem Namen wie `qutee-ai_agent_Empfang_2026-11-11_14-30-00.json` herunter. Die App zeigt zum Beispiel **Agent "Empfang" erfolgreich heruntergeladen.**

## Agent importieren

Der Import zeigt dir vorher, was er am Agenten ändern würde. Du entscheidest pro Änderung, ob sie übernommen wird.

1. Öffne **Agenten** und wähle oben den Agenten aus, in den du die Datei laden willst.
2. Klicke rechts neben den Reitern auf das Upload-Symbol (**Agent hochladen**).
3. Wähle die JSON-Datei aus.
4. Das Fenster **Import prüfen** listet jede Änderung mit **Bisher** und **Neu**. Alles ist angehakt. Entferne den Haken bei allem, was nicht übernommen werden soll.
5. Klicke auf **Änderungen übernehmen** (die Schaltfläche nennt die Zahl, zum Beispiel **3 Änderungen übernehmen**).

Die App zeigt **Agent erfolgreich hochgeladen. Die Daten werden aktualisiert.** und lädt die Seite neu. Entspricht die Datei schon dem Agenten, zeigt die App „Die Datei entspricht dem aktuellen Agenten. Es gibt nichts zu ändern.“, und nichts passiert.

> **Tipp:** Vor dem Import speichert qutee den aktuellen Stand. Gefällt dir das Ergebnis nicht, stellst du den alten Stand im [Verlauf des Agenten](https://docs.qutee.ai/agenten/verlauf-und-wiederherstellen/) wieder her.

### Was beim Import passiert

- Die Felder aus dem Reiter **Persönlichkeit** bekommen die Werte aus der Datei, soweit du sie angehakt lässt.
- Auch ob der Agent aktiv ist, kann aus der Datei kommen. Steht das in der Liste, prüfe nach dem Import im Reiter **Verfügbarkeit** den Schalter **Agent aktiv**.
- Weiterleitungen, Auskünfte und Informationserfassungen werden über ihren Namen zugeordnet: Eine Aktion mit demselben Namen wird aktualisiert, neue kommen dazu. Aktionen dieser drei Arten, die nicht in der Datei stehen, erscheinen in der Liste als **Entfernt** und sind angehakt. Entferne den Haken, wenn sie bleiben sollen.
- Rufnummer, die übrigen Einstellungen im Reiter **Verfügbarkeit**, **Terminbuchungen** und die gewählten **E-Mail-Vorlagen** bleiben, wie sie sind.
- Steht in der Datei eine Stimme, die für dein Unternehmen nicht freigeschaltet ist, schlägt der Import die Standardstimme vor. Prüfe die **Stimme** nach dem Import.

## Wenn der Import abgelehnt wird

Erfüllt die Datei die Regeln des Agenten-Editors nicht, zeigt die App das Fenster **Import nicht möglich** mit dem Dateinamen und einer Liste der Stellen, die nicht passen. Zu jeder Stelle steht, wo sie liegt, was falsch ist und der Pfad in der JSON-Datei. Am Agenten wurde dann nichts geändert.

Häufige Gründe:

- **Die Datei ist keine gültige JSON-Datei.**: Die Datei wurde beim Bearbeiten beschädigt, zum Beispiel fehlt ein Komma oder eine Klammer. Exportiere den Agenten neu oder prüfe die genannte Stelle.
- **Zu lang**: Ein Text überschreitet die erlaubte Länge. Die Meldung sagt, um wie viele Zeichen du kürzen musst.
- **Keine gültige Telefonnummer**: Erlaubt sind Nummern aus Deutschland, Österreich oder der Schweiz im Format +491711234567.
- **Diese Dateiversion wird nicht unterstützt.**: Die Datei stammt nicht aus dem Export oder ist veraltet. Exportiere den Agenten erneut.

Korrigiere die Datei, schließe das Fenster mit **Schließen** und lade sie erneut hoch.

## Prüfen, ob alles klappt

1. Geh die Reiter **Persönlichkeit** und **Aktion** durch und prüfe, ob Texte und Aktionen stimmen.
2. Prüfe im Reiter **Verfügbarkeit** den Schalter **Agent aktiv**.
3. Ruf die Nummer des Agenten an und mach einen kurzen Testanruf.

## Weiter geht's

- [Deinen Agenten prüfen und testen](https://docs.qutee.ai/erste-schritte/agenten-pruefen-und-testen/)
- [Änderungen am Agenten zurücknehmen](https://docs.qutee.ai/agenten/verlauf-und-wiederherstellen/)
- [Stimme und Sprechtempo deines Agenten einstellen](https://docs.qutee.ai/agenten/stimme-und-sprechtempo/)
