> 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. # Środowisko audio ## Omówienie Środowisko audio określa, jak brzmi audio wysyłane przez agenta do rozmówcy. Obejmuje dwa ustawienia: * **Dźwięk w tle** odtwarza zapętlony dźwięk otoczenia pod mową agenta. * **Filtr głosu** stosuje filtr w stylu telefonu do głosu agenta przed tym miksowaniem. Rozmówca słyszy wynik. Agent nie słyszy dźwięku w tle i nie jest on wysyłany do rozpoznawania mowy. To osobne ustawienie od [dźwięków wywołań narzędzi](/docs/pl/eleven-agents/customization/tools/tool-configuration/tool-call-sounds), które są odtwarzane tylko podczas działania narzędzia. ## Dźwięk w tle Dźwięk w tle miksuje wbudowany preset pod mową agenta przez cały czas rozmowy. Dźwięk nadal się zapętla, gdy użytkownik przerwie wypowiedź; nie zatrzymuje się wraz z turą agenta. Presety obejmują biuro, restaurację, miasto, pisanie na klawiaturze i muzykę w windzie. W panelu możesz odsłuchać preset przed zapisaniem. Skonfiguruj dźwięk w tle za pomocą `conversation_config.conversation.background_sound`. ### Konfiguracja #### Aktualizacja w panelu #### Otwórz Środowisko audio Otwórz swojego agenta. Na stronie Agenta obok **Głosy** kliknij przycisk **Środowisko audio**. #### Włącz dźwięk w tle Włącz **Włącz dźwięk w tle**. Wybierz preset w **Dźwięk w tle**. Użyj przycisku odtwarzania obok listy rozwijanej, aby go odsłuchać. #### Ustaw głośność i zapętlanie Ustaw **Głośność**. Pozostaw włączone **Płynne zapętlanie**, aby uniknąć słyszalnego kliknięcia, gdy dźwięk się powtarza. Zapisz zmiany. #### Aktualizacja przez CLI #### Pobierz konfigurację agenta ```bash elevenlabs agents pull --agent agent_7101k5zvyjhmfg983brhmhkd98n6 ``` #### Edytuj \`agent_configs/\.json\` Ustaw `conversation_config.conversation.background_sound`. Prawidłowe wartości `source_id` to `office1`, `office2`, `restaurant`, `city`, `typing` oraz `elevator1`–`elevator4`. ```json { "conversation_config": { "conversation": { "background_sound": { "source_type": "preset", "source_id": "office2", "volume": 0.15, "crossfade_loop": true } } } } ``` Aby wyłączyć dźwięk w tle, ustaw `source_type` i `source_id` na `null`. Nie pomijaj `background_sound` ani nie ustawiaj obiektu na `null`; aktualizacja zachowa obecne ustawienie. #### Prześlij konfigurację agenta ```bash elevenlabs agents push --agent agent_7101k5zvyjhmfg983brhmhkd98n6 ``` #### Aktualizacja przez API ```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, }, }, }, }); ``` Aby wyłączyć, ustaw `source_type` i `source_id` na `null`. Pominięcie `background_sound` podczas aktualizacji go nie wyłącza. > **Warning** > > Przy bardzo słabym połączeniu WebSocket miksowanie dźwięku w tle może powodować przerywanie audio. ### Parametry Prawidłowe wartości `source_id` to `office1`, `office2`, `restaurant`, `city`, `typing` oraz `elevator1`–`elevator4`. | Pole | Typ | Domyślnie | Opis | | ---------------- | ------- | ------------ | -------------------------------------------------------------------------------- | | `source_type` | string | nieustawione | Gdy dźwięk jest włączony, musi mieć wartość `preset`. Ustaw razem z `source_id`. | | `source_id` | string | nieustawione | Identyfikator wbudowanego presetu. | | `volume` | number | `0.15` | Poziom względem mowy agenta. Zakres: `0.01`–`1.0`. | | `crossfade_loop` | boolean | `true` | Płynne przejście przy końcu pętli, aby dźwięk nie klikał przy powtórzeniu. | ## Filtr głosu Filtr głosu zmienia wygenerowany głos agenta. Nie wyrównuje ani nie odszumia dźwięku w tle. Filtr działa najpierw, a dźwięk w tle jest miksowany pod przefiltrowaną mową. Skonfiguruj filtr głosu za pomocą `conversation_config.tts.audio_effects.filter_preset_id`. Panel oferuje presety telefonu; przez CLI lub API możesz ustawić dowolny preset filtra z [katalogu efektów audio](/docs/pl/api-reference/audio-effects/get-catalog). #### Aktualizacja w panelu W tym samym panelu **Środowisko audio** ustaw **Filtr głosu** na **Wył.** lub preset telefonu, a następnie zapisz. #### Aktualizacja przez CLI W `agent_configs/.json` ustaw `conversation_config.tts.audio_effects`, a potem prześlij konfigurację agenta: ```json { "conversation_config": { "tts": { "audio_effects": { "filter_preset_id": "phone" } } } } ``` Aby usunąć filtr, ustaw `filter_preset_id` na `null`. #### Aktualizacja przez API ```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", }, }, }, }); ``` Aby usunąć filtr, ustaw `filter_preset_id` na `null`. > **Note** > > Audio agenta jest monofoniczne. `pan` nie działa dla agentów, a pogłos z `environment_id` jest miksowany > do mono. ## Ograniczenia * Tylko wbudowane presety. Nie możesz przesłać własnego pliku ani wskazać dowolnego adresu URL. * Elementy sterujące środowiskiem audio są ukryte, gdy agent działa **tylko w trybie tekstowym**. * Dźwięk w tle nie jest miksowany do odpowiedzi w wiadomościach głosowych [WhatsApp](/docs/pl/eleven-agents/whatsapp). Nadal jest uwzględniany w połączeniach WhatsApp. * Dźwięku w tle nie można ustawiać dla pojedynczej rozmowy przez klienckie [nadpisania](/docs/pl/eleven-agents/customization/personalization/overrides); `conversation_config_override` nie zawiera `background_sound`. Nadal możesz go zmienić w węźle [workflow](/docs/pl/eleven-agents/customization/agent-workflows). ## Powiązane #### [Dźwięki wywołań narzędzi](/docs/pl/eleven-agents/customization/tools/tool-configuration/tool-call-sounds) Odtwarzaj dźwięk otoczenia tylko podczas działania narzędzia. #### [Dostosowanie głosu](/docs/pl/eleven-agents/customization/voice) Wybierz głos, szybkość i inne ustawienia mowy dla agenta.