> ## Documentation Index > Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt > Use this file to discover all available pages before exploring further. # VoiceAgent-Expertenmodus > Schalten Sie erweiterte VoiceAgent-Einstellungen für KI-Modell, Stimme und Anrufverhalten frei. Dieser Artikel erklärt, wie Sie den Expertenmodus nutzen, um die vollständige Konfiguration Ihres VoiceAgents über den Tab *Erweitert* anzuzeigen, zu bearbeiten und zu importieren. **Benutzerebene:** Admin *** Der **Expertenmodus** gibt Ihnen direkten Zugriff auf die vollständige Konfiguration Ihres VoiceAgents als JSON-Datei. Er schaltet den Tab *Erweitert* in den VoiceAgent-Einstellungen frei, in dem Sie Konfigurationen anzeigen, bearbeiten und importieren können – mit Zugriff auf Felder und Feinabstimmungsoptionen, die im Tab *Formular* nicht verfügbar sind.

Was Sie mit dem Expertenmodus tun können

Der Expertenmodus ist nützlich, wenn Sie eine Einstellung ändern möchten, die im Tab *Formular* nicht verfügbar ist – etwa um zu einem bestimmten KI-Modell zu wechseln, das Verhalten der Stimme anzupassen oder die Anrufabwicklung feinabzustimmen. Öffnen Sie dazu den Tab *Erweitert*, suchen Sie das entsprechende Feld, aktualisieren Sie den Wert und speichern Sie.

Wie der Expertenmodus mit dem Formular-Tab zusammenhängt

Der Tab Formular und der Tab *Erweitert* zeigen dieselbe Konfiguration auf zwei unterschiedliche Arten an. Jede Einstellung, die Sie im Tab *Formular* vornehmen, ist auch im JSON vorhanden, und Änderungen in einem Tab werden im anderen übernommen. Der Expertenmodus erweitert das, was der Tab *Formular* bietet. Der Tab *Erweitert* bietet zusätzliche Felder zur Feinabstimmung des KI-Modellverhaltens, der Sprachqualität und der Anrufabwicklung, die im Tab *Formular* nicht vorhanden sind.

Felder, die in beiden Tabs verfügbar sind

Die folgenden Felder können entweder im Tab *Formular* oder im Tab *Erweitert* konfiguriert werden. **Persönlichkeit** | ***Formular*-Tab-Bezeichnung** | **JSON-Feld** | **Was es festlegt** | | - | - | - | | Name | `agentName` | Der Anzeigename des VoiceAgents | | Anrufrichtung | `direction` | Ob der VoiceAgent eingehende oder ausgehende Anrufe bearbeitet. Zulässige Werte: `"inbound"` oder `"outbound"`. | | Sprache | `language` | Die Sprache, die der VoiceAgent spricht | | Zusätzliche Sprachen | `secondaryLanguages` | Zusätzliche Sprachen, die der VoiceAgent während eines Anrufs erkennen und zu denen er wechseln kann. Optional. | | Stimme | `voice` | Die vom VoiceAgent verwendete Stimme | | Begrüßung | `greeting` | Der genaue Eröffnungssatz, den der VoiceAgent zu Beginn eines Anrufs sagt. Bleibt das Feld leer, verwenden VoiceAgents für eingehende Anrufe eine generische Standardformulierung; VoiceAgents für ausgehende Anrufe beginnen mit Stille. | **Wissensquellen** | ***Formular*-Tab-Bezeichnung** | **JSON-Feld** | **Was es festlegt** | | - | - | - | | Wissensdatenbanken | `knowledgeBaseIds` | Wissensdatenbanken, auf die der VoiceAgent bei der Beantwortung von Fragen zurückgreifen kann | **Verhalten** | ***Formular*-Tab-Bezeichnung** | **JSON-Feld** | **Was es festlegt** | | - | - | - | | Ziel-Prompt | `goalPrompt` | Die grundlegenden Anweisungen, die das Verhalten des VoiceAgents während eines Anrufs festlegen | | Fähigkeiten | `skills` | Strukturierte Fähigkeiten: An Mitarbeiter weiterleiten, Nachricht aufnehmen, Informationen extrahieren, Fragen beantworten, Terminbuchung | | Szenarien | `scenarios` | Wie der VoiceAgent auf bestimmte Situationen reagiert, einschließlich der Beendigung von Anrufen | | Guardrails | `guardrails` | Feste Antworten für Situationen, in denen unabhängig vom Kontext eine einheitliche Antwort erforderlich ist |

Nur im Expertenmodus verfügbare Felder

Die folgenden Felder sind nur über den Tab *Erweitert* zugänglich.

Gesprächsstil

Diese beiden Felder bestimmen, wie der VoiceAgent spricht. Sie sind optional: Wenn Sie sie nicht festlegen, wendet CloudTalk Standardwerte an, die dem bisherigen Verhalten des VoiceAgents entsprechen. Nach dem nächsten Speichern erscheinen beide Felder automatisch mit ihren Standardwerten im JSON. Das ist normal.
**Feld** **Was es festlegt** **Werte**
`tone` Wie der VoiceAgent klingt. Eine Liste von Stil-Presets; sie können kombiniert werden, aber ein oder zwei funktionieren am besten (jedes zusätzliche Preset schwächt die anderen ab). Die Reihenfolge spielt keine Rolle, Duplikate werden automatisch entfernt, Freitextwerte werden nicht akzeptiert. `"professional"`, `"friendly"`, `"casual"`, `"calm"`, `"empathetic"`, `"direct"`. Optional; Standardwert `["friendly", "direct"]`.
`verbosity` Wie viel der VoiceAgent pro Antwort sagt. `"concise"` = die kürzeste hilfreiche Antwort. `"standard"` = ein bis zwei Sätze, mit der Möglichkeit, bei Bedarf mehr zu sagen. `"thorough"` = ausführlichere Antworten mit hilfreichem Kontext (weiterhin kurz gehalten; schließlich handelt es sich um ein Telefongespräch). `"concise"` / `"standard"` / `"thorough"`. Optional; Standardwert `"standard"`.
**Erklärung der Tonfall-Presets:** | **Preset** | **Wirkung** | | - | - | | `professional` | Bedacht, präzise und respektvoll | | `friendly` | Warmherzig und sympathisch | | `casual` | Entspannt und locker, wie ein hilfsbereiter Kollege | | `calm` | Ruhig, gelassen und geduldig | | `empathetic` | Geht zunächst auf die Gefühle des Anrufers ein, bevor Lösungen angeboten werden | | `direct` | Kommt direkt zur Antwort und hält Höflichkeitsfloskeln auf ein Minimum | Unabhängig von Tonfall und Ausführlichkeit bleibt der VoiceAgent bei operativen Momenten immer kurz: Bestätigungen, Wiederholungen zur Kontrolle, Verabschiedungen sowie Weiterleitungs- oder Buchungsschritte. Wird ein nicht unterstützter Wert eingegeben, erscheint eine Validierungsmeldung mit den zulässigen Werten, und die Konfiguration wird nicht gespeichert.

KI-Modell

| **Feld** | **Was es festlegt** | | - | - | | `llmOverride` | Legt ein bestimmtes KI-Modell fest, anstatt die automatische Auswahl zu verwenden. Die Liste der unterstützten Modelle finden Sie weiter unten. | | `providerOverride` | Erzwingt einen bestimmten Sprachanbieter (`"elevenlabs"` oder `"deepgram"`). In den meisten Fällen muss dies nicht manuell festgelegt werden, da die Sprache den Anbieter automatisch bestimmt. | | `temperature` | Steuert, wie variantenreich die Antworten des VoiceAgents sind. Akzeptiert Werte von `0.0` bis `1.0`. Für professionelle oder strukturierte VoiceAgents wird ein Wert zwischen `0.1` und `0.3` empfohlen. Erforderlich. | **Unterstützte Modelle für `llmOverride`** | **Modell** | **Wert** | | - | - | | GPT-4o Mini | `openai - gpt-4o-mini` | | GPT-4o | `openai - gpt-4o` | | GPT-4.1 | `openai - gpt-4.1` | | GPT-4.1 Mini | `openai - gpt-4.1-mini` | | GPT-4.1 Nano | `openai - gpt-4.1-nano` | | GPT-5 | `openai - gpt-5` | | GPT-5 Mini | `openai - gpt-5-mini` | | GPT-5 Nano | `openai - gpt-5-nano` | | GPT-5.1 | `openai - gpt-5.1` | | Claude 3 Haiku | `anthropic - claude-3-haiku` | | Claude Haiku 4.5 | `anthropic - claude-haiku-4-5` | | Claude 3.7 Sonnet | `anthropic - claude-3-7-sonnet` | | Gemini 2.0 Flash Lite | `google - gemini-2.0-flash-lite` | | Gemini 1.5 Pro | `google - gemini-1.5-pro` |

Feinabstimmung der Stimme

| **Feld** | **Was es festlegt** | **Werte** | | - | - | - | | `stability` | Steuert, wie gleichbleibend die Stimme des VoiceAgents während des gesamten Anrufs klingt. Höhere Werte erzeugen eine stabilere Stimme. | `0.0`–`1.0`. Erforderlich. | | `similarity` | Steuert, wie stark die Stimme dem ursprünglichen Stimmmodell entspricht. | `0.0`–`1.0`. Erforderlich. | | `optimizeStreamingLatency` | Tauscht Sprachqualität gegen geringere Antwortlatenz. Höhere Werte reduzieren die Latenz, können aber die Qualität beeinträchtigen. Setzen Sie diesen Wert nicht auf `4`, da dies die Textnormalisierung deaktiviert, wodurch Zahlen und Daten falsch ausgesprochen werden. | `0`–`4`. Erforderlich. |

Anrufverhalten

| **Feld** | **Was es festlegt** | **Werte** | | - | - | - | | `maxCallDuration` | Legt eine feste Obergrenze für die Anruflänge in Minuten fest. | Empfohlen: 3–5 für ausgehende Anrufe, 15–30 für eingehende Anrufe. Erforderlich. | | `dialTime` | Wie lange der VoiceAgent bei ausgehenden Anrufen auf eine Antwort wartet, bevor er abbricht. | `5`–`120` Sekunden. Optional. |

Erweiterte ElevenLabs-Feinabstimmung

Diese Einstellungen gelten nur, wenn Ihr VoiceAgent ElevenLabs verwendet, was für die meisten Sprachkonfigurationen die Standardeinstellung ist. | **Feld** | **Was es festlegt** | **Werte** | | - | - | - | | `speculativeTurn` | Der VoiceAgent beginnt bereits mit der Formulierung seiner Antwort, bevor der Anrufer zu Ende gesprochen hat, wodurch die gefühlte Antwortlatenz sinkt. | `true` / `false` | | `turnEagerness` | Steuert, wie bereitwillig der VoiceAgent das Wort übernimmt, wenn der Anrufer eine Pause macht. | `"patient"` / `"normal"` / `"eager"` | | `turnModel` | Legt die verwendete Version des Modells zur Sprecherwechsel-Erkennung fest. | `"turn_v2"` / `"turn_v3"` | | `vad` | Filtert Hintergrundgeräusche heraus, damit sie keine unbeabsichtigte Antwort auslösen. | `true` / `false` | | `asrKeywords` | Wörter oder Phrasen, die bei der Spracherkennung priorisiert werden sollen. Nützlich für Produktnamen oder Fachbegriffe. | Liste von Zeichenketten | | `interruptionIgnoreTerms` | Kurze Bestätigungslaute des Anrufers (z. B. Zustimmungslaute), die nicht als Unterbrechung gewertet werden sollen, sodass der VoiceAgent währenddessen weiterspricht. In der Sprache des Anrufers verfasst. | Liste von Zeichenketten. Optional. | | `interruptionIgnoreTermLanguages` | Die Sprachen, in denen die Ignorierbegriffe abgeglichen werden. | Liste von Sprachcodes. Optional. | | `backgroundSound` | Spielt eine Umgebungsgeräuschkulisse unter der Sprache des VoiceAgents ab. | Objekt: `preset` (erforderlich, wenn backgroundSound gesetzt ist; einer von `"office"`, `"office2"`, `"restaurant"`, `"city"`, `"typing"`, `"elevator"`, `"elevator2"`, `"elevator3"`, `"elevator4"`), `volume` (`0.0`–`1.0`, optional), `crossfadeLoop` (`true`/`false`, optional; lässt den Sound nahtlos in Schleife laufen). | Im Tab *Erweitert* müssen diese Felder innerhalb eines `elevenLabsSettings`-Objekts platziert werden. Sie gehören nicht auf die oberste Ebene der Konfiguration. Hier ist ein Beispiel, das zeigt, wie sie verschachtelt werden: ```json theme={"system"} { "agentName": "Clinic Reception", "direction": "inbound", "language": "es", "temperature": 0.2, "elevenLabsSettings": { "speculativeTurn": true, "turnEagerness": "patient", "turnModel": "turn_v3", "vad": true, "asrKeywords": ["Capil Clinic", "injerto capilar", "Barcelona"], "interruptionIgnoreTerms": ["vale", "sí", "ajá"], "interruptionIgnoreTermLanguages": ["es"], "backgroundSound": { "preset": "office", "volume": 0.3, "crossfadeLoop": true } } } ``` Wenn eine gespeicherte Konfiguration `elevenLabsSettings` enthält, ersetzt das gesendete Objekt das gespeicherte. Um ein einzelnes Unterfeld zu löschen, lassen Sie es im gesendeten Objekt weg. Wenn Sie `elevenLabsSettings` vollständig weglassen, bleiben die gespeicherten Einstellungen erhalten. Diese Felder müssen innerhalb von `elevenLabsSettings` platziert werden; auf der obersten Ebene werden sie nicht erkannt, und das Speichern schlägt mit einem Validierungsfehler fehl.

Konfigurationen importieren und exportieren

Sie können eine Konfiguration aus dem Tab *Erweitert* exportieren und in einen anderen VoiceAgent importieren oder sie mit einem anderen Benutzer teilen, damit dieser sie in sein Konto importiert. Die meisten Konfigurationen werden sofort importiert, ohne dass eine zusätzliche Einrichtung erforderlich ist. Eine Ausnahme besteht, wenn eine Konfiguration auf kontospezifische Ressourcen verweist, etwa eine Wissensdatenbank, ein benutzerdefiniertes Tool, eine Telefonnummer oder eine Kalenderintegration. Diese Verbindungen müssen nach dem Import manuell eingerichtet werden. Speichern Sie den VoiceAgent nach jedem erfolgreichen Import zweimal. Eine bekannte Gruppe von Sonderfällen tritt erst nach dem zweiten Speichern auf. Exportierte Konfigurationen enthalten jetzt `tone` und `verbosity`. Wenn eine importierte Konfiguration für diese (oder andere) Felder einen nicht unterstützten Wert enthält, wird der Import mit einer Meldung abgelehnt, die das Feld und die zulässigen Werte nennt. *** *Brauchen Sie Hilfe oder haben Sie eine Frage?* Wenden Sie sich einfach über unser [Support-Portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — wir sind für Sie da. ## Related topics - [VoiceAgent-Fähigkeiten](/de/articles/14072758-voiceagent-skills.md) - [VoiceAgent-Anrufweiterleitungen](/de/articles/11393590-voiceagent-call-transfers.md) - [Wissensdatenbank für VoiceAgents](/de/articles/11204159-knowledge-base-for-voiceagents.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.