> 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.

# Audioomgeving

## Overzicht

De audioomgeving bepaalt hoe de uitgaande audio van de agent voor de beller klinkt. Er zijn twee instellingen:

* **Achtergrondgeluid** speelt een herhalend omgevingsgeluid af onder de spraak van de agent.
* **Stemfilter** past vóór die mix een telefoonachtig filter toe op de stem van de agent.

De beller hoort het resultaat. De agent hoort het achtergrondgeluid niet en het wordt niet naar spraakherkenning gestuurd.

Dit staat los van [geluiden bij toolaanroepen](/docs/nl/eleven-agents/customization/tools/tool-configuration/tool-call-sounds), die alleen worden afgespeeld terwijl een tool wordt uitgevoerd.

## Achtergrondgeluid

Achtergrondgeluid mixt tijdens het gesprek een ingebouwde preset onder de spraak van de agent. Het geluid blijft zich herhalen wanneer de gebruiker onderbreekt; het stopt niet wanneer de beurt van de agent eindigt.

Presets zijn onder meer kantoor, restaurant, stad, typen en liftmuziek. In het dashboard kun je een preset beluisteren voordat je deze opslaat.

Configureer achtergrondgeluid met `conversation_config.conversation.background_sound`.

### Configuratie

#### Bijwerken via het dashboard

#### Open Audioomgeving

Open je agent. Klik op de Agent-pagina naast **Voices** op de knop **Audio environment**.

#### Schakel achtergrondgeluid in

Schakel **Enable background sound** in. Kies een preset in **Background sound**. Gebruik de afspeelknop
naast de dropdown om deze te beluisteren.

#### Stel volume en looping in

Stel **Volume** in. Laat **Crossfade loop** ingeschakeld om een hoorbare klik te voorkomen wanneer het geluid
wordt herhaald. Sla je wijzigingen op.

#### Bijwerken via de CLI

#### Haal de agentconfiguratie op

```bash
elevenlabs agents pull --agent agent_7101k5zvyjhmfg983brhmhkd98n6
```

#### Bewerk \`agent\_configs/\<agent-name>.json\`

Stel `conversation_config.conversation.background_sound` in. Geldige waarden voor `source_id` zijn
`office1`, `office2`, `restaurant`, `city`, `typing` en `elevator1` tot en met `elevator4`.

```json
{
  "conversation_config": {
    "conversation": {
      "background_sound": {
        "source_type": "preset",
        "source_id": "office2",
        "volume": 0.15,
        "crossfade_loop": true
      }
    }
  }
}
```

Om achtergrondgeluid uit te schakelen, stel je `source_type` en `source_id` in op `null`. Laat
`background_sound` niet weg en stel het object niet in op `null`; een update behoudt de bestaande instelling.

#### Push de agentconfiguratie

```bash
elevenlabs agents push --agent agent_7101k5zvyjhmfg983brhmhkd98n6
```

#### Bijwerken via de 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,
      },
    },
  },
});
```

Om uit te schakelen, stel je `source_type` en `source_id` in op `null`. Als je `background_sound` weglaat bij een
update, wordt het niet uitgeschakeld.

> **Warning**
>
> Bij zeer slechte WebSocket-verbindingen kan het mixen van achtergrondgeluid haperende audio veroorzaken.

### Parameters

Geldige waarden voor `source_id` zijn `office1`, `office2`, `restaurant`, `city`, `typing` en `elevator1` tot en met `elevator4`.

| Veld             | Type    | Standaard      | Beschrijving                                                                          |
| ---------------- | ------- | -------------- | ------------------------------------------------------------------------------------- |
| `source_type`    | string  | niet ingesteld | Moet `preset` zijn wanneer een geluid is ingeschakeld. Stel samen met `source_id` in. |
| `source_id`      | string  | niet ingesteld | Identificatie voor een ingebouwde preset.                                             |
| `volume`         | number  | `0.15`         | Niveau ten opzichte van de spraak van de agent. Bereik `0.01`–`1.0`.                  |
| `crossfade_loop` | boolean | `true`         | Crossfade bij de overgang in de loop, zodat het geluid niet klikt bij herhaling.      |

## Stemfilter

Het stemfilter verandert de gegenereerde stem van de agent. Het egaliseert of onderdrukt geen ruis in het achtergrondgeluid. Het filter wordt eerst toegepast; achtergrondgeluid wordt onder de gefilterde spraak gemixt.

> **Note**
>
> Het stemfilter is alleen beschikbaar in het dashboard. Het maakt geen deel uit van de openbare agent-API of het CLI-schema en is mogelijk
> niet beschikbaar in alle workspaces.

Stel in hetzelfde paneel **Audio environment** **Voice filter** in op **Off** of een telefoonpreset en sla vervolgens op.

## Beperkingen

* Alleen ingebouwde presets. Je kunt geen aangepast bestand uploaden of naar een willekeurige URL verwijzen.
* Bediening voor de audioomgeving is verborgen wanneer de agent **alleen tekst** gebruikt.
* Achtergrondgeluid wordt niet gemixt in antwoorden op WhatsApp-spraakberichten via [WhatsApp](/docs/nl/eleven-agents/whatsapp). WhatsApp-gesprekken bevatten het wel.
* Achtergrondgeluid kan niet per gesprek worden ingesteld via client-[overrides](/docs/nl/eleven-agents/customization/personalization/overrides); `conversation_config_override` bevat geen `background_sound`. Je kunt het nog steeds wijzigen in een node van een [workflow](/docs/nl/eleven-agents/customization/agent-workflows).

## Gerelateerd

#### [Geluiden bij toolaanroepen](/docs/nl/eleven-agents/customization/tools/tool-configuration/tool-call-sounds)

Speel alleen omgevingsaudio af terwijl een tool wordt uitgevoerd.

#### [Stemmaatwerk](/docs/nl/eleven-agents/customization/voice)

Kies een stem, snelheid en andere spraakinstellingen voor de agent.