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

# Environnement audio

## Vue d’ensemble

L’environnement audio contrôle le rendu de l’audio sortant de l’agent pour l’appelant. Deux paramètres s’appliquent :

* **Son d’ambiance** diffuse un son ambiant en boucle sous la parole de l’agent.
* **Filtre vocal** applique un filtre de type téléphone à la voix de l’agent avant ce mixage.

L’appelant entend le résultat. L’agent n’entend pas le son d’ambiance, qui n’est pas envoyé à la reconnaissance vocale.

Cette fonctionnalité est distincte des [sons d’appel d’outil](/docs/fr/eleven-agents/customization/tools/tool-configuration/tool-call-sounds), qui ne sont diffusés que pendant l’exécution d’un outil.

## Son d’ambiance

Le son d’ambiance mixe un préréglage intégré sous la parole de l’agent pendant toute la conversation. Le son continue de tourner en boucle lorsque l’utilisateur interrompt l’agent ; il ne s’arrête pas à la fin du tour de parole de l’agent.

Les préréglages incluent des sons de bureau, de restaurant, de ville, de frappe au clavier et de musique d’ascenseur. Dans le Dashboard, vous pouvez préécouter un préréglage avant de l’enregistrer.

Configurez le son d’ambiance avec `conversation_config.conversation.background_sound`.

### Configuration

#### Mise à jour via le Dashboard

#### Ouvrir Environnement audio

Ouvrez votre agent. Sur la page de l’agent, à côté de **Voix**, cliquez sur le bouton
**Environnement audio**.

#### Activer le son d’ambiance

Activez **Activer le son d’ambiance**. Choisissez un préréglage dans **Son d’ambiance**. Utilisez le bouton de lecture
à côté de la liste déroulante pour le préécouter.

#### Définir le volume et la boucle

Définissez le **Volume**. Laissez **Boucle avec fondu enchaîné** activé afin d’éviter un clic audible lorsque le son
se répète. Enregistrez vos modifications.

#### Mise à jour via la CLI

#### Récupérer la configuration de l’agent

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

#### Modifier \`agent_configs/\<agent-name>.json\`

Définissez `conversation_config.conversation.background_sound`. Les valeurs `source_id` valides sont
`office1`, `office2`, `restaurant`, `city`, `typing` et `elevator1` à `elevator4`.

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

Pour désactiver le son d’ambiance, définissez `source_type` et `source_id` sur `null`. N’omettez pas
`background_sound` et ne définissez pas l’objet sur `null` ; une mise à jour conserve le paramètre existant.

#### Envoyer la configuration de l’agent

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

#### Mise à jour via l’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,
      },
    },
  },
});
```

Pour désactiver cette fonctionnalité, définissez `source_type` et `source_id` sur `null`. Omettre `background_sound` lors d’une
mise à jour ne la désactive pas.

> **Warning**
>
> Sur les connexions WebSocket de très mauvaise qualité, le mixage du son d’ambiance peut produire un audio saccadé.

### Paramètres

Les valeurs `source_id` valides sont `office1`, `office2`, `restaurant`, `city`, `typing` et `elevator1` à `elevator4`.

| Champ            | Type    | Valeur par défaut | Description                                                                 |
| ---------------- | ------- | ----------------- | --------------------------------------------------------------------------- |
| `source_type`    | string  | non défini        | Doit être `preset` lorsqu’un son est activé. À définir avec `source_id`.    |
| `source_id`      | string  | non défini        | Identifiant d’un préréglage intégré.                                        |
| `volume`         | number  | `0.15`            | Niveau relatif à la parole de l’agent. Plage : `0.01`–`1.0`.                |
| `crossfade_loop` | boolean | `true`            | Fondu enchaîné à la fin de la boucle afin d’éviter un clic à la répétition. |

## Filtre vocal

Le filtre vocal modifie la voix générée de l’agent. Il n’égalise ni ne réduit le bruit du son d’ambiance. Le filtre est appliqué en premier ; le son d’ambiance est mixé sous la parole filtrée.

Configurez le filtre vocal avec `conversation_config.tts.audio_effects.filter_preset_id`. Le Dashboard propose les préréglages téléphone ; via la CLI ou l’API, vous pouvez définir n’importe quel préréglage de filtre répertorié dans le [catalogue des effets audio](/docs/fr/api-reference/audio-effects/get-catalog).

#### Mise à jour via le Dashboard

Dans le même panneau **Environnement audio**, définissez **Filtre vocal** sur **Désactivé** ou sur un préréglage téléphone, puis
enregistrez.

#### Mise à jour via la CLI

Dans `agent_configs/<agent-name>.json`, définissez `conversation_config.tts.audio_effects`, puis envoyez la
configuration de l’agent :

```json
{
  "conversation_config": {
    "tts": {
      "audio_effects": {
        "filter_preset_id": "phone"
      }
    }
  }
}
```

Pour supprimer le filtre, définissez `filter_preset_id` sur `null`.

#### Mise à jour via l’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",
      },
    },
  },
});
```

Pour supprimer le filtre, définissez `filter_preset_id` sur `null`.

> **Note**
>
> L’audio de l’agent est mono. `pan` n’a aucun effet sur les agents, et la réverbération d’un `environment_id` est mixée
> en mono.

## Limites

* Préréglages intégrés uniquement. Vous ne pouvez pas importer de fichier personnalisé ni indiquer une URL arbitraire.
* Les contrôles de l’environnement audio sont masqués lorsque l’agent est **uniquement textuel**.
* Le son d’ambiance n’est pas mixé dans les réponses aux messages vocaux [WhatsApp](/docs/fr/eleven-agents/whatsapp). Les appels WhatsApp l’incluent toujours.
* Le son d’ambiance ne peut pas être défini pour chaque conversation via les [remplacements](/docs/fr/eleven-agents/customization/personalization/overrides) client ; `conversation_config_override` n’inclut pas `background_sound`. Vous pouvez toujours le modifier sur un nœud de [workflow](/docs/fr/eleven-agents/customization/agent-workflows).

## Associé

#### [Sons d’appel d’outil](/docs/fr/eleven-agents/customization/tools/tool-configuration/tool-call-sounds)

Diffusez un son ambiant uniquement pendant l’exécution d’un outil.

#### [Personnalisation de la voix](/docs/fr/eleven-agents/customization/voice)

Choisissez une voix, une vitesse et d’autres paramètres de parole pour l’agent.