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

# Ambiente audio

## Panoramica

L'ambiente audio controlla il modo in cui l'audio in uscita dell'agente viene percepito dal chiamante. Si applicano due impostazioni:

* Il **suono di sottofondo** riproduce un suono ambientale in loop sotto il parlato dell'agente.
* Il **filtro vocale** applica un filtro stile telefono alla voce dell'agente prima del mixaggio.

Il chiamante sente il risultato. L'agente non sente il suono di sottofondo e questo non viene inviato al riconoscimento vocale.

Questa funzione è distinta dai [suoni delle chiamate agli strumenti](/docs/it/eleven-agents/customization/tools/tool-configuration/tool-call-sounds), che vengono riprodotti solo durante l'esecuzione di uno strumento.

## Suono di sottofondo

Il suono di sottofondo mixa un preset integrato sotto il parlato dell'agente per tutta la durata della conversazione. Il suono continua a ripetersi quando l'utente interrompe l'agente; non si interrompe alla fine del turno dell'agente.

I preset includono ufficio, ristorante, città, digitazione e musica da ascensore. Nella dashboard, puoi ascoltare l'anteprima di un preset prima di salvarlo.

Configura il suono di sottofondo con `conversation_config.conversation.background_sound`.

### Configurazione

#### Aggiorna dalla dashboard

#### Apri Ambiente audio

Apri il tuo agente. Nella pagina Agent, accanto a **Voices**, fai clic sul pulsante **Audio environment**.

#### Abilita il suono di sottofondo

Attiva **Enable background sound**. Scegli un preset da **Background sound**. Usa il controllo di riproduzione
accanto al menu a discesa per ascoltarne l'anteprima.

#### Imposta volume e loop

Imposta **Volume**. Mantieni abilitato **Crossfade loop** per evitare uno scatto udibile quando il suono
si ripete. Salva le modifiche.

#### Aggiorna tramite CLI

#### Recupera la configurazione dell'agente

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

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

Imposta `conversation_config.conversation.background_sound`. I valori `source_id` validi sono
`office1`, `office2`, `restaurant`, `city`, `typing` e da `elevator1` a `elevator4`.

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

Per disabilitare il suono di sottofondo, imposta `source_type` e `source_id` su `null`. Non omettere
`background_sound` né impostare l'oggetto su `null`; un aggiornamento manterrebbe l'impostazione esistente.

#### Invia la configurazione dell'agente

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

#### Aggiorna tramite 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,
      },
    },
  },
});
```

Per disabilitare, imposta `source_type` e `source_id` su `null`. Omettere `background_sound` durante un
aggiornamento non lo disabilita.

> **Warning**
>
> Su connessioni WebSocket molto instabili, il mixaggio del suono di sottofondo può produrre audio frammentato.

### Parametri

I valori `source_id` validi sono `office1`, `office2`, `restaurant`, `city`, `typing` e da `elevator1` a `elevator4`.

| Campo            | Tipo    | Predefinito   | Descrizione                                                                                    |
| ---------------- | ------- | ------------- | ---------------------------------------------------------------------------------------------- |
| `source_type`    | string  | non impostato | Deve essere `preset` quando un suono è abilitato. Impostalo insieme a `source_id`.             |
| `source_id`      | string  | non impostato | Identificatore di un preset integrato.                                                         |
| `volume`         | number  | `0.15`        | Livello relativo al parlato dell'agente. Intervallo `0.01`–`1.0`.                              |
| `crossfade_loop` | boolean | `true`        | Dissolvenza incrociata al confine del loop, così il suono non produce scatti quando si ripete. |

## Filtro vocale

Il filtro vocale modifica la voce generata dall'agente. Non equalizza né riduce il rumore del suono di sottofondo. Il filtro viene applicato per primo; il suono di sottofondo viene mixato sotto il parlato filtrato.

> **Note**
>
> Il filtro vocale è disponibile solo nella dashboard. Non fa parte dell'API pubblica dell'agente né dello schema CLI e potrebbe
> non essere disponibile in tutti i workspace.

Nello stesso pannello **Audio environment**, imposta **Voice filter** su **Off** o su un preset telefonico, quindi salva.

## Limitazioni

* Sono disponibili solo preset integrati. Non puoi caricare un file personalizzato né indicare un URL qualsiasi.
* I controlli dell'ambiente audio sono nascosti quando l'agente è **solo testo**.
* Il suono di sottofondo non viene mixato nelle risposte ai messaggi vocali di [WhatsApp](/docs/it/eleven-agents/whatsapp). Nelle chiamate WhatsApp è comunque incluso.
* Il suono di sottofondo non può essere impostato per singola conversazione tramite gli [override](/docs/it/eleven-agents/customization/personalization/overrides) client; `conversation_config_override` non include `background_sound`. Puoi comunque modificarlo in un nodo di [workflow](/docs/it/eleven-agents/customization/agent-workflows).

## Contenuti correlati

#### [Suoni delle chiamate agli strumenti](/docs/it/eleven-agents/customization/tools/tool-configuration/tool-call-sounds)

Riproduci audio ambientale solo durante l'esecuzione di uno strumento.

#### [Personalizzazione della voce](/docs/it/eleven-agents/customization/voice)

Scegli una voce, la velocità e altre impostazioni vocali per l'agente.