VoiceAgent-Expertenmodus

Dieser Artikel erklärt, wie Sie die vollständige Konfiguration Ihres VoiceAgents im Bereich Erweitert anzeigen und bearbeiten – einschließlich Einstellungen, die Sie nirgendwo sonst ändern können.

Benutzerebene: Admin

Der Expertenmodus zeigt Ihnen die vollständige Konfiguration Ihres VoiceAgents als JSON. Er zeigt jede Einstellung mit ihrem aktuellen Wert an, auch die, die Sie nie geändert haben. Sie können Einstellungen feinabstimmen, die in den anderen Bereichen nicht verfügbar sind, etwa das KI-Modell, das Verhalten der Stimme und die Anrufabwicklung.

Expertenmodus öffnen

Gehen Sie im Dashboard zu AI Voice Agents > Agenten und öffnen Sie Ihren VoiceAgent.
Klicken Sie im linken Menü unter Erstellen auf Erweitert.

Der Bereich Erweitert eines VoiceAgents mit dem Bereich Konfiguration, der das vollständige JSON zeigt, und der Statusleiste Keine Probleme

Der Bereich Konfiguration zeigt die vollständige Konfiguration. Darüber können Sie auch den AI Composer bitten, Änderungen in einfachen Worten für Sie vorzunehmen.

Was Sie sehen

Jede Einstellung mit ihrem Wert. Einstellungen, die Sie nicht geändert haben, zeigen ihren Standardwert an, sodass Sie alles sehen, was Sie anpassen können. Sie müssen nicht zuerst speichern, um sie zu sehen.
Einstellungen für jeden Sprachanbieter. elevenLabsSettings und deepgramSettings werden beide aufgeführt, unabhängig davon, welchen Anbieter Ihr VoiceAgent verwendet.
Eine Statusleiste über dem JSON. Sie zeigt Keine Probleme an, wenn die Konfiguration gültig ist. Wenn etwas nicht stimmt, zum Beispiel ein nicht unterstützter Wert, sagt sie Ihnen, was Sie korrigieren müssen, bevor Sie speichern können.

Konfiguration bearbeiten

Ändern Sie die gewünschten Werte im Bereich Konfiguration.
Prüfen Sie, ob die Statusleiste Keine Probleme anzeigt.
Klicken Sie auf Speichern.

Um nicht gespeicherte Änderungen rückgängig zu machen, klicken Sie auf Zurücksetzen. Die anderen Bereiche (Identität, Wissensdatenbank und Fähigkeiten & Szenarien) und der Bereich Erweitert zeigen dieselbe Konfiguration auf zwei unterschiedliche Arten an. Eine Änderung in einem wird im anderen übernommen.

Konfiguration in einen anderen VoiceAgent kopieren

Klicken Sie im Bereich Erweitert auf Kopieren, um die vollständige Konfiguration einschließlich der Standardwerte zu kopieren.
Öffnen Sie den Bereich Erweitert des anderen VoiceAgents, ersetzen Sie dessen Konfiguration durch die kopierte und klicken Sie auf Speichern.

Da die Kopie jede Einstellung enthält, verhält sich der andere VoiceAgent genau gleich.

Ändern Sie den agentName. Jeder VoiceAgent benötigt einen eindeutigen Namen.
Verbinden Sie kontospezifische Ressourcen erneut. Eine Konfiguration kann auf Elemente Ihres Kontos verweisen, etwa Wissensdatenbanken, benutzerdefinierte Tools, Telefonnummern oder eine Kalenderintegration. Wenn Sie eine Konfiguration in ein anderes Konto kopieren, richten Sie diese dort erneut ein.
Speichern Sie den VoiceAgent nach einem erfolgreichen Import zweimal. Eine bekannte Gruppe von Sonderfällen tritt erst nach dem zweiten Speichern auf.

Einstellungsreferenz

Identität

JSON-Feld	Was es festlegt
`agentName`	Der Name des VoiceAgents. Muss in Ihrem Konto eindeutig sein.
`direction`	Ob der VoiceAgent eingehende oder ausgehende Anrufe bearbeitet: `"inbound"` oder `"outbound"`.
`language`	Die Sprache, die der VoiceAgent spricht.
`secondaryLanguages`	Zusätzliche Sprachen, die der VoiceAgent während eines Anrufs erkennen und zu denen er wechseln kann. Optional.
`voice`	Die vom VoiceAgent verwendete Stimme.
`greeting`	Der genaue Eröffnungssatz, den der VoiceAgent zu Beginn eines Anrufs sagt. Ist das Feld leer, verwenden VoiceAgents für eingehende Anrufe eine generische Standardformulierung; VoiceAgents für ausgehende Anrufe beginnen mit Stille.
`startSpeakingFirst`	Ob der VoiceAgent zuerst spricht, wenn der Anruf verbunden wird (`true`), oder auf den Anrufer wartet (`false`).
`defaultOutboundNumberId`	Die Telefonnummer, von der aus der VoiceAgent anruft.
`failoverOutboundNumberId`	Eine Ersatznummer für Anrufe, falls die Standardnummer nicht verwendet werden kann.

Wissen und Verhalten

JSON-Feld	Was es festlegt
`knowledgeBaseIds`	Die Wissensdatenbanken, auf die der VoiceAgent bei der Beantwortung von Fragen zurückgreifen kann.
`goalPrompt`	Die grundlegenden Anweisungen, die das Verhalten des VoiceAgents während eines Anrufs festlegen.
`skills`	Strukturierte Fähigkeiten, zum Beispiel `takeMessage` und `extractData`. Jede Fähigkeit hat `enabled` und eigene Einstellungen.
`scenarios`	Wie der VoiceAgent auf bestimmte Situationen reagiert. Jedes Szenario hat `when`, `reply` und optional eine `action` wie `"hangup"`.
`guardrails`	Feste Antworten für Situationen, in denen unabhängig vom Kontext eine einheitliche Antwort erforderlich ist.

In skills.extractData.properties benötigt jede Eigenschaft einen eindeutigen name. Wenn zwei Eigenschaften denselben Namen haben, wird die Konfiguration nicht gespeichert.

Gesprächsstil

Diese beiden Felder bestimmen, wie der VoiceAgent spricht.

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, und Freitextwerte werden nicht akzeptiert.	`"professional"`, `"friendly"`, `"casual"`, `"calm"`, `"empathetic"`, `"direct"`. 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"`. 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.

KI-Modell

Feld	Was es festlegt
`llm`	Das KI-Modell, das der VoiceAgent verwendet. Die Liste der unterstützten Modelle finden Sie weiter unten.
`provider`	Der Sprachanbieter: `"elevenlabs"` oder `"deepgram"`. In den meisten Fällen bestimmt die Sprache den Anbieter automatisch.
`temperature`	Wie variantenreich die Antworten des VoiceAgents sind, von `0.0` bis `1.0`. Für professionelle oder strukturierte VoiceAgents wird `0.1` bis `0.3` empfohlen.

Unterstützte Modelle für llm

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`	Wie gleichbleibend die Stimme des VoiceAgents während des gesamten Anrufs klingt. Höhere Werte erzeugen eine stabilere Stimme.	`0.0`–`1.0`
`similarity`	Wie stark die Stimme dem ursprünglichen Stimmmodell entspricht.	`0.0`–`1.0`
`optimizeStreamingLatency`	Tauscht Sprachqualität gegen geringere Antwortlatenz. Höhere Werte reduzieren die Latenz, können aber die Qualität beeinträchtigen. Setzen Sie den Wert nicht auf `4`: Dadurch wird die Textnormalisierung deaktiviert, sodass Zahlen und Daten falsch ausgesprochen werden.	`0`–`4`

Anrufverhalten

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

ElevenLabs-Einstellungen

Diese Einstellungen gelten, wenn Ihr VoiceAgent ElevenLabs verwendet, die Standardeinstellung für die meisten Sprachen. Sie befinden sich im Objekt elevenLabsSettings, nicht auf der obersten Ebene der Konfiguration.

Feld	Was es festlegt	Werte
`speculativeTurn`	Der VoiceAgent beginnt bereits mit der Formulierung seiner Antwort, bevor der Anrufer zu Ende gesprochen hat, wodurch die Antwortzeit sinkt.	`true` / `false`
`turnEagerness`	Wie bereitwillig der VoiceAgent das Wort übernimmt, wenn der Anrufer eine Pause macht.	`"patient"` / `"normal"` / `"eager"`
`turnModel`	Die Version des Modells zur Sprecherwechsel-Erkennung.	`"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, etwa Produktnamen oder Fachbegriffe.	Liste von Zeichenketten
`interruptionIgnoreTerms`	Kurze Bestätigungslaute des Anrufers (zum Beispiel Zustimmungslaute), die nicht als Unterbrechung gewertet werden sollen, sodass der VoiceAgent währenddessen weiterspricht. In der Sprache des Anrufers verfasst.	Liste von Zeichenketten
`interruptionIgnoreTermLanguages`	Die Sprachen, in denen die Ignorierbegriffe abgeglichen werden.	Liste von Sprachcodes
`backgroundSound`	Ein Umgebungsgeräusch unter der Sprache des VoiceAgents. `null` bedeutet keines.	`null` oder ein Objekt: `preset` (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)

Beispiel:

"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
  }
}

Beim Speichern ersetzt das gesendete Objekt elevenLabsSettings das gespeicherte. Um eine einzelne Einstellung zu löschen, entfernen Sie sie aus dem Objekt.

Deepgram-Einstellungen

deepgramSettings enthält die Einstellungen für VoiceAgents, die Deepgram verwenden. Das Objekt ist leer, wenn nichts festzulegen ist.

Von CloudTalk verwaltet

minorVersion und hashes werden von CloudTalk verwaltet. Lassen Sie sie unverändert.

Brauchen Sie Hilfe oder haben Sie eine Frage? Wenden Sie sich einfach über unser Support-Portal an uns. Wir sind für Sie da.

Erste Schritte

Nummern & Portierung

KI

AI Sales Dialer

CloudTalk Phone & Go

Nachrichten

Dashboard

Integrationen

Abrechnung & Abonnement

Tech-News & Updates

Altes Dashboard

Expertenmodus öffnen

Was Sie sehen

Konfiguration bearbeiten

Konfiguration in einen anderen VoiceAgent kopieren

Einstellungsreferenz

Identität

Wissen und Verhalten

Gesprächsstil

KI-Modell

Feinabstimmung der Stimme

Anrufverhalten

ElevenLabs-Einstellungen

Deepgram-Einstellungen

Von CloudTalk verwaltet

​Expertenmodus öffnen

​Was Sie sehen

​Konfiguration bearbeiten

​Konfiguration in einen anderen VoiceAgent kopieren

​Einstellungsreferenz

​Identität

​Wissen und Verhalten

​Gesprächsstil

​KI-Modell

​Feinabstimmung der Stimme

​Anrufverhalten

​ElevenLabs-Einstellungen

​Deepgram-Einstellungen

​Von CloudTalk verwaltet

Expertenmodus öffnen

Was Sie sehen

Konfiguration bearbeiten

Konfiguration in einen anderen VoiceAgent kopieren

Einstellungsreferenz

Identität

Wissen und Verhalten

Gesprächsstil

KI-Modell

Feinabstimmung der Stimme

Anrufverhalten

ElevenLabs-Einstellungen

Deepgram-Einstellungen

Von CloudTalk verwaltet