> 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. # Audio-Umgebung ## Überblick Die Audio-Umgebung steuert, wie das ausgehende Audio des Agenten für den Anrufer klingt. Dabei gelten zwei Einstellungen: * **Hintergrundsound** spielt einen sich wiederholenden Umgebungssound unter der Agentensprache ab. * **Sprachfilter** wendet vor dieser Mischung einen telefonähnlichen Filter auf die Stimme des Agenten an. Der Anrufer hört das Ergebnis. Der Agent hört den Hintergrundsound nicht, und er wird nicht an die Spracherkennung gesendet. Dies ist getrennt von [Tool-Aufruf-Sounds](/docs/de/eleven-agents/customization/tools/tool-configuration/tool-call-sounds), die nur abgespielt werden, während ein Tool ausgeführt wird. ## Hintergrundsound Der Hintergrundsound mischt für die Dauer der Unterhaltung ein integriertes Preset unter die Agentensprache. Der Sound läuft weiter, wenn der Nutzer unterbricht; er stoppt nicht mit dem Zug des Agenten. Zu den Presets gehören Büro, Restaurant, Stadt, Tippen und Fahrstuhlmusik. Im Dashboard können Sie ein Preset vor dem Speichern vorhören. Konfigurieren Sie den Hintergrundsound mit `conversation_config.conversation.background_sound`. ### Konfiguration #### Über das Dashboard aktualisieren #### Audio-Umgebung öffnen Öffnen Sie Ihren Agenten. Klicken Sie auf der Agentenseite neben **Stimmen** auf die Schaltfläche **Audio-Umgebung**. #### Hintergrundsound aktivieren Aktivieren Sie **Hintergrundsound aktivieren**. Wählen Sie ein Preset unter **Hintergrundsound**. Verwenden Sie die Wiedergabesteuerung neben dem Dropdown-Menü, um es vorzuhören. #### Lautstärke und Wiederholung festlegen Legen Sie die **Lautstärke** fest. Lassen Sie **Crossfade-Schleife** aktiviert, um ein hörbares Klicken zu vermeiden, wenn der Sound wiederholt wird. Speichern Sie Ihre Änderungen. #### Über die CLI aktualisieren #### Agentenkonfiguration abrufen ```bash elevenlabs agents pull --agent agent_7101k5zvyjhmfg983brhmhkd98n6 ``` #### \`agent_configs/\.json\` bearbeiten Legen Sie `conversation_config.conversation.background_sound` fest. Gültige `source_id`-Werte sind `office1`, `office2`, `restaurant`, `city`, `typing` und `elevator1` bis `elevator4`. ```json { "conversation_config": { "conversation": { "background_sound": { "source_type": "preset", "source_id": "office2", "volume": 0.15, "crossfade_loop": true } } } } ``` Um den Hintergrundsound zu deaktivieren, setzen Sie `source_type` und `source_id` auf `null`. Lassen Sie `background_sound` nicht weg und setzen Sie das Objekt nicht auf `null`; bei einer Aktualisierung bleibt die vorhandene Einstellung erhalten. #### 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": { "background_sound": { "source_type": "preset", "source_id": "office2", "volume": 0.15, "crossfade_loop": True, } } }, ) ``` ```typescript import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; const elevenlabs = new ElevenLabsClient(); await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", { conversationConfig: { conversation: { backgroundSound: { sourceType: "preset", sourceId: "office2", volume: 0.15, crossfadeLoop: true, }, }, }, }); ``` Um die Funktion zu deaktivieren, setzen Sie `source_type` und `source_id` auf `null`. Wenn Sie bei einer Aktualisierung `background_sound` weglassen, wird die Funktion nicht deaktiviert. > **Warning** > > Bei sehr schlechten WebSocket-Verbindungen kann das Mischen von Hintergrundsound zu abgehacktem Audio führen. ### Parameter Gültige `source_id`-Werte sind `office1`, `office2`, `restaurant`, `city`, `typing` und `elevator1` bis `elevator4`. | Feld | Typ | Standard | Beschreibung | | ---------------- | ------- | ------------- | ------------------------------------------------------------------------------------- | | `source_type` | string | nicht gesetzt | Muss `preset` sein, wenn ein Sound aktiviert ist. Zusammen mit `source_id` festlegen. | | `source_id` | string | nicht gesetzt | Kennung für ein integriertes Preset. | | `volume` | number | `0.15` | Pegel relativ zur Agentensprache. Bereich `0.01`–`1.0`. | | `crossfade_loop` | boolean | `true` | Crossfade am Schleifenübergang, damit der Sound bei Wiederholung nicht klickt. | ## Sprachfilter Der Sprachfilter verändert die generierte Stimme des Agenten. Er entzerrt oder entrauscht den Hintergrundsound nicht. Der Filter wird zuerst angewendet; der Hintergrundsound wird unter die gefilterte Sprache gemischt. Konfigurieren Sie den Sprachfilter mit `conversation_config.tts.audio_effects.filter_preset_id`. Das Dashboard bietet Telefon-Presets; über die CLI oder API können Sie jedes Filter-Preset festlegen, das im [Audioeffektkatalog](/docs/de/api-reference/audio-effects/get-catalog) aufgeführt ist. #### Über das Dashboard aktualisieren Legen Sie im selben Bereich **Audio-Umgebung** für **Sprachfilter** die Option **Aus** oder ein Telefon-Preset fest und speichern Sie. #### Über die CLI aktualisieren Legen Sie in `agent_configs/.json` `conversation_config.tts.audio_effects` fest und übertragen Sie dann die Agentenkonfiguration: ```json { "conversation_config": { "tts": { "audio_effects": { "filter_preset_id": "phone" } } } } ``` Um den Filter zu entfernen, setzen Sie `filter_preset_id` auf `null`. #### Über die API aktualisieren ```python from elevenlabs import ElevenLabs elevenlabs = ElevenLabs() elevenlabs.conversational_ai.agents.update( agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6", conversation_config={ "tts": { "audio_effects": { "filter_preset_id": "phone", } } }, ) ``` ```typescript import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; const elevenlabs = new ElevenLabsClient(); await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", { conversationConfig: { tts: { audioEffects: { filterPresetId: "phone", }, }, }, }); ``` Um den Filter zu entfernen, setzen Sie `filter_preset_id` auf `null`. > **Note** > > Agenten-Audio ist Mono. `pan` hat bei Agenten keine Wirkung, und Hall von einer `environment_id` wird > auf Mono abgemischt. ## Einschränkungen * Nur integrierte Presets. Sie können keine benutzerdefinierte Datei hochladen oder auf eine beliebige URL verweisen. * Die Steuerelemente für die Audio-Umgebung sind ausgeblendet, wenn der Agent **nur Text** verwendet. * Hintergrundsound wird nicht in Sprachmitteilungsantworten über [WhatsApp](/docs/de/eleven-agents/whatsapp) gemischt. WhatsApp-Anrufe enthalten ihn weiterhin. * Hintergrundsound kann nicht pro Unterhaltung über clientseitige [Überschreibungen](/docs/de/eleven-agents/customization/personalization/overrides) festgelegt werden; `conversation_config_override` enthält kein `background_sound`. Sie können ihn weiterhin in einem [Workflow](/docs/de/eleven-agents/customization/agent-workflows)-Knoten ändern. ## Verwandte Inhalte #### [Tool-Aufruf-Sounds](/docs/de/eleven-agents/customization/tools/tool-configuration/tool-call-sounds) Spielen Sie Umgebungs-Audio nur ab, während ein Tool ausgeführt wird. #### [Stimmenanpassung](/docs/de/eleven-agents/customization/voice) Wählen Sie eine Stimme, Geschwindigkeit und weitere Spracheinstellungen für den Agenten.