> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Gesprächsablauf ## Übersicht Die Einstellungen für den Gesprächsverlauf bestimmen, wie Ihr Assistent mit Phasen der Stille, Unterbrechungen während des Sprechens und dem Sprecherwechsel umgeht. Diese Einstellungen sorgen für natürlichere Gespräche und lassen sich an Ihren Anwendungsfall anpassen. #### [Maximale Gesprächsdauer](#maximum-conversation-duration) Begrenzen Sie die Gesamtdauer jedes Gesprächs #### [Sprecherwechsel nach Stille](#turn-timeout) Legen Sie fest, wie lange Ihr Assistent in Phasen der Stille wartet #### [Weiches Timeout](#soft-timeout) Geben Sie natürliches Audiofeedback, wenn Ihr Agent Zeit zum Nachdenken braucht #### [Unterbrechungen](#interruptions) Legen Sie fest, ob Nutzer Ihren Assistenten beim Sprechen unterbrechen können #### [Sprecherwechsel-Bereitschaft](#turn-eagerness) Passen Sie an, wie schnell Ihr Assistent auf Nutzereingaben reagiert ## Maximale Gesprächsdauer Die Einstellung **Max conversation duration** begrenzt die Gesamtzeit, während der ein Gespräch aktiv bleiben kann. Dieses globale Limit beginnt mit dem Gesprächsbeginn und gilt unabhängig von Timeouts auf Sprecherwechsel-Ebene. Standardmäßig sind es 600 Sekunden (10 Minuten). Sie können einen Wert von 60 bis 7.200 Sekunden festlegen. ### Konfiguration Konfigurieren Sie diese Einstellung in der CLI und API mit dem Feld `conversation_config.conversation.max_duration_seconds`. #### Über das Dashboard aktualisieren Öffnen Sie Ihren Agenten im Dashboard, wechseln Sie zum Tab **Advanced** und passen Sie unter **Call limits** die **Max conversation duration** an. Speichern Sie Ihre Änderungen. #### Über die CLI aktualisieren #### Agentenkonfiguration abrufen ```bash elevenlabs agents pull --agent agent_7101k5zvyjhmfg983brhmhkd98n6 ``` #### Agentenkonfiguration bearbeiten Legen Sie `conversation_config.conversation.max_duration_seconds` fest: ```json { "conversation_config": { "conversation": { "max_duration_seconds": 1200 } } } ``` #### Agentenkonfiguration übertragen ```bash elevenlabs agents push --agent agent_7101k5zvyjhmfg983brhmhkd98n6 ``` #### Über die API aktualisieren ```python from elevenlabs import ElevenLabs elevenlabs = ElevenLabs() elevenlabs.conversational_ai.agents.update( agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6", conversation_config={ "conversation": {"max_duration_seconds": 1200}, }, ) ``` ```typescript import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; const elevenlabs = new ElevenLabsClient(); await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", { conversationConfig: { conversation: { maxDurationSeconds: 1200 }, }, }); ``` > **Warning** > > WhatsApp-Nachrichtengespräche haben standardmäßig ein Inaktivitäts-Timeout von 15 Minuten, gemessen ab der > letzten Antwort des Agenten. Dieses Timeout kann ein Nachrichtengespräch vor der konfigurierten > maximalen Dauer beenden. Enterprise-Kunden, deren Anwendungsfall ein anderes Timeout erfordert, sollten den > Support unter [support@elevenlabs.io](mailto:support@elevenlabs.io) kontaktieren. ## Sprecherwechsel nach Stille Die Einstellung **Take turn after silence** legt fest, wie lange Ihr Assistent bei Stille des Nutzers wartet, bevor er den nächsten Sprecherwechsel übernimmt und zu einer Antwort auffordert. ### Konfiguration Der Wert wird in Sekunden angegeben und muss zwischen 1 und 30 Sekunden liegen. Konfigurieren Sie diese Einstellung in der CLI und API mit dem Feld `conversation_config.turn.turn_timeout`. #### Über das Dashboard aktualisieren Öffnen Sie Ihren Agenten im Dashboard, wechseln Sie zum Tab **Advanced** und passen Sie den Wert für **Take turn after silence** an. Speichern Sie Ihre Änderungen. ![Einstellung für Sprecherwechsel nach Stille](/docs/_fern-img/9de7653a0940ae3441b3470c2af53f4a72294ad3680946d4c3fa3b91df69c566.webp) #### Über die CLI aktualisieren #### Agentenkonfiguration abrufen ```bash elevenlabs agents pull --agent "" ``` #### \`agent_configs/\.json\` bearbeiten Legen Sie `conversation_config.turn.turn_timeout` fest: ```json { "conversation_config": { "turn": { "turn_timeout": 7 } } } ``` #### Änderungen übertragen ```bash elevenlabs agents push --agent "" ``` #### Über die API aktualisieren ```python from elevenlabs import ElevenLabs elevenlabs = ElevenLabs() elevenlabs.conversational_ai.agents.update( agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6", conversation_config={ "turn": {"turn_timeout": 7}, }, ) ``` ```typescript import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; const elevenlabs = new ElevenLabsClient(); await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", { conversationConfig: { turn: { turnTimeout: 7 }, }, }); ``` > **Note** > > Wählen Sie eine passende Timeout-Dauer für Ihren Anwendungsfall. Kürzere Timeouts sorgen für > reaktionsschnellere Gespräche, können aber Nutzer unterbrechen, die mehr Zeit zum Antworten brauchen. Das führt zu weniger > natürlichen Gesprächen. ### Best Practices * Legen Sie kürzere Timeouts (5–10 Sekunden) für lockere Gespräche fest, bei denen ein schneller Austausch erwartet wird * Nutzen Sie längere Timeouts (10–30 Sekunden), wenn Nutzer mehr Zeit zum Nachdenken oder Formulieren komplexer Antworten brauchen * Berücksichtigen Sie den Nutzungskontext: Der Kundenservice profitiert möglicherweise von kürzeren Timeouts, während der technische Support längere benötigt ## Weiches Timeout Das weiche Timeout liefert sofortiges Audiofeedback, wenn das LLM länger als erwartet für die Generierung einer Antwort braucht. Statt einer unangenehmen Stille während des Wartens spricht Ihr Agent eine kurze Überbrückungsphrase wie „Hmm ...“ oder „Lassen Sie mich nachdenken ...“, um einen natürlichen Gesprächsfluss aufrechtzuerhalten. Diese Funktion eignet sich für: * Komplexe Anfragen, die eine längere LLM-Verarbeitung erfordern * Variable Latenz von LLM-Anbietern * Menschlichere Gespräche mit natürlichen Denkpausen ### Funktionsweise 1. Wenn der Nutzer aufhört zu sprechen, beginnt das System mit der Generierung einer LLM-Antwort 2. Ein Timer startet basierend auf der konfigurierten Timeout-Dauer 3. Trifft die LLM-Antwort **vor** dem Timeout ein, wird keine Überbrückungsphrase gesprochen 4. Wird das Timeout **vor** der LLM-Antwort erreicht: * Die konfigurierte Überbrückungsnachricht wird sofort gesprochen * Der Agent wartet weiter auf die tatsächliche Antwort * Sobald sie bereit ist, spricht der Agent die vollständige LLM-Antwort Das weiche Timeout wird pro Sprecherwechsel nur einmal ausgelöst, um mehrere Überbrückungsphrasen hintereinander zu verhindern. ### Konfiguration #### Über das Dashboard aktualisieren Öffnen Sie Ihren Agenten im Dashboard, wechseln Sie zum Tab **Advanced** und passen Sie die Einstellungen für **Soft timeout** an. Speichern Sie Ihre Änderungen. ![Einstellungen für weiches Timeout](/docs/_fern-img/7fdaca49ad50e6bc1f09f5eac46e36f0f4b071c5477e061a62791df9e100be75.webp) #### Über die CLI aktualisieren #### Agentenkonfiguration abrufen ```bash elevenlabs agents pull --agent "" ``` #### \`agent_configs/\.json\` bearbeiten Legen Sie `conversation_config.turn.soft_timeout_config` fest: ```json { "conversation_config": { "turn": { "soft_timeout_config": { "timeout_seconds": 3.0, "message": "Hhmmmm...yeah.", "use_llm_generated_message": false } } } } ``` #### Änderungen übertragen ```bash elevenlabs agents push --agent "" ``` #### Über die API aktualisieren ```python from elevenlabs import ElevenLabs elevenlabs = ElevenLabs() elevenlabs.conversational_ai.agents.update( agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6", conversation_config={ "turn": { "soft_timeout_config": { "timeout_seconds": 3.0, "message": "Hhmmmm...yeah.", "use_llm_generated_message": False, }, }, }, ) ``` ```typescript import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; const elevenlabs = new ElevenLabsClient(); await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", { conversationConfig: { turn: { softTimeoutConfig: { timeoutSeconds: 3.0, message: "Hhmmmm...yeah.", useLlmGeneratedMessage: false, }, }, }, }); ``` #### Timeout-Dauer Die Zeit in Sekunden, bevor die Überbrückungsnachricht gesprochen wird, während auf die LLM-Antwort gewartet wird. | Einstellung | Beschreibung | | ------------- | ------------------------ | | **Standard** | `-1` (deaktiviert) | | **Bereich** | `0.5` bis `8.0` Sekunden | | **Empfohlen** | `3.0` Sekunden | > **Tip** > > Beginnen Sie mit 3,0 Sekunden – lang genug, um bei schnellen Antworten unnötige Überbrückungsphrasen zu vermeiden, kurz genug, um > unangenehme Stille zu verhindern. #### Statische Nachricht Eine vordefinierte Überbrückungsphrase, die gesprochen wird, wenn das weiche Timeout ausgelöst wird. | Einstellung | Beschreibung | | ------------ | ------------------ | | **Standard** | `"Hhmmmm...yeah."` | | **Länge** | 1–200 Zeichen | Diese Nachricht unterstützt: * **Sprachüberschreibungen**: Wird automatisch in zusätzliche für Ihren Agenten konfigurierte Sprachen übersetzt * **Client-Überschreibungen**: Kann über das SDK pro Anruf angepasst werden #### LLM-generierte Nachricht Wenn aktiviert, erzeugt ein schlankes LLM dynamisch eine kontextgerechte Überbrückungsphrase, statt die statische Nachricht zu verwenden. | Einstellung | Beschreibung | | ------------ | ------------------------------------------------------------------ | | **Standard** | `false` | | **Fallback** | Verwendet bei fehlgeschlagener Generierung die statische Nachricht | Das System verwendet den aktuellen Gesprächskontext (bis zu 4 Nachrichten, 1.000 Zeichen), um relevante Überbrückungsphrasen wie „Hmm ...“, „Ich verstehe ...“, „Verstanden ...“, „Alles klar ...“ oder „In Ordnung ...“ zu generieren. > **Note** > > Bei der Verwendung LLM-generierter Nachrichten ist weiterhin eine statische Fallback-Nachricht erforderlich. ### Best Practices * Vermeiden Sie Zeitangaben in Überbrückungsnachrichten (z. B. „Eine Sekunde ...“), da die tatsächlichen Antwortzeiten nicht vorhersehbar sind * Deaktivieren Sie das weiche Timeout für schnelle FAQ-Bots, deren Antworten durchgängig schnell sind ## Unterbrechungen Die Unterbrechungsbehandlung bestimmt, ob Nutzer Ihren Assistenten beim Sprechen unterbrechen können. ### Konfiguration Die Unterbrechungseinstellungen können im Tab **Advanced** des Agenten unter **Client Events** konfiguriert werden. Um Unterbrechungen zu aktivieren, stellen Sie sicher, dass interruption als Client-Ereignis ausgewählt ist. #### Unterbrechungen aktiviert ![Unterbrechung erlaubt](/docs/_fern-img/1da794be8ea3bfed45d06241ce5db390480cd45d27c0f886943518bd52d76157.webp) #### Unterbrechungen deaktiviert ![Unterbrechung ignoriert](/docs/_fern-img/847a2ebcdfff9498501502ab4b568fc498b6995f860a5552177a7883942197ff.webp) > **Note** > > Deaktivieren Sie Unterbrechungen, wenn die vollständige Übermittlung von Informationen entscheidend ist, etwa bei rechtlichen > Hinweisen oder Sicherheitsanweisungen. ### Best Practices für Unterbrechungen * Aktivieren Sie Unterbrechungen für natürliche Gesprächsabläufe, bei denen Dialoge mit wechselseitigen Beiträgen erwartet werden * Deaktivieren Sie Unterbrechungen, wenn die vollständige Übermittlung einer Nachricht entscheidend ist (z. B. Bedingungen oder Sicherheitsinformationen) * Berücksichtigen Sie Ihren Anwendungsfall: Der Kundenservice profitiert möglicherweise von Unterbrechungen, die Informationsvermittlung eher nicht ## Sprecherwechsel-Bereitschaft Die Sprecherwechsel-Bereitschaft steuert, wie schnell Ihr Assistent während eines Gesprächs auf Nutzereingaben reagiert. Diese Einstellung bestimmt, wie bereit der Assistent ist, anhand erkannter Sprachmuster den Sprecherwechsel zu übernehmen und zu sprechen. ### Funktionsweise Der Assistent enthält jetzt zwei wichtige Verbesserungen für natürlichere Sprecherwechsel: 1. **Schnellere Antwortgenerierung** – Der Assistent beginnt zu sprechen, nachdem er genügend Wörter und ein Komma vom Sprachmodell erhalten hat, statt auf vollständige Sätze zu warten. Das reduziert die Latenz und sorgt für reaktionsschnellere Gespräche, besonders bei längeren Antworten des Assistenten. 2. **Konfigurierbare Sprecherwechsel-Bereitschaft** – Steuern Sie, wie schnell der Assistent Pausen oder Sprachmuster als Gelegenheit zum Antworten interpretiert. ### Konfiguration Drei Modi sind verfügbar: * **Eager** – Der Assistent reagiert schnell auf Nutzereingaben und schaltet sich bei der frühestmöglichen Gelegenheit ein. Optimal für dynamische Gespräche, bei denen sofortige Antworten wichtig sind. * **Normal** – Ausgewogener Sprecherwechsel, der für die meisten Gesprächsszenarien gut geeignet ist. Der Assistent wartet vor der Antwort auf natürliche Gesprächspausen. * **Patient** – Der Assistent wartet länger, bevor er an der Reihe ist, und gibt Nutzern mehr Zeit, ihre Gedanken zu Ende zu formulieren. Ideal zum Erfassen detaillierter Informationen oder wenn Nutzer Zeit für Antworten brauchen. #### Über das Dashboard aktualisieren Öffnen Sie Ihren Agenten im Dashboard, wechseln Sie zu den Einstellungen **Agent** und wählen Sie den gewünschten Modus für die Sprecherwechsel-Bereitschaft. Speichern Sie Ihre Änderungen. #### Über die CLI aktualisieren #### Agentenkonfiguration abrufen ```bash elevenlabs agents pull --agent "" ``` #### \`agent_configs/\.json\` bearbeiten Setzen Sie `conversation_config.turn.turn_eagerness` auf `"patient"`, `"normal"` oder `"eager"`: ```json { "conversation_config": { "turn": { "turn_eagerness": "normal" } } } ``` #### Änderungen übertragen ```bash elevenlabs agents push --agent "" ``` #### Über die API aktualisieren ```python from elevenlabs import ElevenLabs elevenlabs = ElevenLabs() elevenlabs.conversational_ai.agents.update( agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6", conversation_config={ "turn": {"turn_eagerness": "normal"}, }, ) ``` ```typescript import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; const elevenlabs = new ElevenLabsClient(); await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", { conversationConfig: { turn: { turnEagerness: "normal" }, }, }); ``` > **Note** > > Die Sprecherwechsel-Bereitschaft ist besonders wirkungsvoll in Kombination mit Workflows. Sie können die > Reaktionsfähigkeit des Assistenten dynamisch an den Kontext anpassen – sodass er sich in lockeren Gesprächen schneller einschaltet > oder länger wartet, wenn sensible Informationen wie Telefonnummern oder E-Mail-Adressen erfasst werden. ### Best Practices für die Sprecherwechsel-Bereitschaft * Verwenden Sie den Modus **Eager** für Kundenservice-Szenarien, in denen schnelle Antworten die Nutzererfahrung verbessern * Verwenden Sie den Modus **Patient**, wenn Sie strukturierte Informationen wie Telefonnummern, Adressen oder E-Mail-Adressen erfassen * Verwenden Sie den Modus **Normal** als Standard für allgemeine Gesprächsabläufe * Kombinieren Sie ihn mit Workflows, um die Sprecherwechsel-Bereitschaft anhand des Gesprächskontexts dynamisch anzupassen * Testen Sie verschiedene Einstellungen für Ihren spezifischen Anwendungsfall, um die optimale Balance zu finden ## Empfohlene Konfigurationen #### Kundenservice * Kürzere Timeouts (5–10 Sekunden) für reaktionsschnelle Interaktionen – Aktivieren Sie Unterbrechungen, damit Kunden Fragen einwerfen können – **Eager** Sprecherwechsel-Bereitschaft für schnelle, reaktionsschnelle Gespräche #### Informationserfassung * Moderate Timeouts (10–15 Sekunden), damit Nutzer Zeit zum Zusammentragen von Informationen haben – Aktivieren Sie Unterbrechungen für einen natürlichen Gesprächsfluss – **Patient** Sprecherwechsel-Bereitschaft beim Erfassen von Telefon- nummern, Adressen oder E-Mail-Adressen #### Rechtliche Hinweise * Längere Timeouts (15–30 Sekunden) für komplexe Antworten – Deaktivieren Sie Unterbrechungen, um die vollständige Übermittlung rechtlicher Informationen sicherzustellen – **Normal** Sprecherwechsel-Bereitschaft für ein gleichmäßiges Tempo #### Konversationsbasiertes EdTech * Längere Timeouts (10–30 Sekunden), um Zeit zum Nachdenken und Formulieren von Antworten zu geben – Aktivieren Sie Unterbrechungen, damit Schüler Fragen einwerfen können – **Patient** Sprecherwechsel-Bereitschaft, um Schülern ausreichend Zeit zum Antworten zu geben