> 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 de áudio

## Visão geral

O ambiente de áudio controla como o áudio de saída do agente soa para quem liga. Duas configurações são aplicadas:

* **Som de fundo** reproduz um som ambiente em loop sob a fala do agente.
* **Filtro de voz** aplica um filtro estilo telefone à voz do agente antes dessa mixagem.

Quem liga ouve o resultado. O agente não ouve o som de fundo, e ele não é enviado para o reconhecimento de fala.

Isso é separado dos [sons de chamadas de ferramenta](/docs/pt/eleven-agents/customization/tools/tool-configuration/tool-call-sounds), que são reproduzidos apenas enquanto uma ferramenta é executada.

## Som de fundo

O som de fundo mistura uma predefinição integrada sob a fala do agente durante toda a conversa. O som continua em loop quando o usuário interrompe; ele não para junto com o turno do agente.

As predefinições incluem escritório, restaurante, cidade, digitação e música de elevador. No painel, você pode visualizar uma predefinição antes de salvá-la.

Configure o som de fundo com `conversation_config.conversation.background_sound`.

### Configuração

#### Atualizar pelo painel

#### Abrir Ambiente de áudio

Abra seu agente. Na página do agente, ao lado de **Vozes**, clique no botão **Ambiente de áudio**.

#### Ativar som de fundo

Ative **Ativar som de fundo**. Escolha uma predefinição em **Som de fundo**. Use o controle de reprodução
ao lado do menu suspenso para visualizá-la.

#### Definir volume e loop

Defina o **Volume**. Mantenha **Loop com crossfade** ativado para evitar um clique audível quando o som
se repetir. Salve suas alterações.

#### Atualizar pela CLI

#### Obter a configuração do agente

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

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

Defina `conversation_config.conversation.background_sound`. Os valores válidos de `source_id` são
`office1`, `office2`, `restaurant`, `city`, `typing` e de `elevator1` a `elevator4`.

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

Para desativar o som de fundo, defina `source_type` e `source_id` como `null`. Não omita
`background_sound` nem defina o objeto como `null`; uma atualização mantém a configuração existente.

#### Enviar a configuração do agente

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

#### Atualizar pela 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,
      },
    },
  },
});
```

Para desativar, defina `source_type` e `source_id` como `null`. Omitir `background_sound` em uma
atualização não o desativa.

> **Warning**
>
> Em conexões WebSocket muito instáveis, a mixagem do som de fundo pode produzir áudio entrecortado.

### Parâmetros

Os valores válidos de `source_id` são `office1`, `office2`, `restaurant`, `city`, `typing` e de `elevator1` a `elevator4`.

| Campo            | Tipo    | Padrão       | Descrição                                                                      |
| ---------------- | ------- | ------------ | ------------------------------------------------------------------------------ |
| `source_type`    | string  | não definido | Deve ser `preset` quando um som estiver ativado. Defina junto com `source_id`. |
| `source_id`      | string  | não definido | Identificador de uma predefinição integrada.                                   |
| `volume`         | number  | `0.15`       | Nível em relação à fala do agente. Intervalo de `0.01` a `1.0`.                |
| `crossfade_loop` | boolean | `true`       | Aplica crossfade na transição do loop para que o som não clique ao repetir.    |

## Filtro de voz

O filtro de voz remodela a voz gerada do agente. Ele não equaliza nem remove ruído do som de fundo. O filtro é aplicado primeiro; o som de fundo é mixado sob a fala filtrada.

Configure o filtro de voz com `conversation_config.tts.audio_effects.filter_preset_id`. O painel oferece as predefinições de telefone; pela CLI ou API, você pode definir qualquer predefinição de filtro listada pelo [catálogo de efeitos de áudio](/docs/pt/api-reference/audio-effects/get-catalog).

#### Atualizar pelo painel

No mesmo painel **Ambiente de áudio**, defina **Filtro de voz** como **Desativado** ou uma predefinição de telefone e
salve.

#### Atualizar pela CLI

Em `agent_configs/<agent-name>.json`, defina `conversation_config.tts.audio_effects` e envie a
configuração do agente:

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

Para remover o filtro, defina `filter_preset_id` como `null`.

#### Atualizar pela 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",
      },
    },
  },
});
```

Para remover o filtro, defina `filter_preset_id` como `null`.

> **Note**
>
> O áudio do agente é mono. `pan` não tem efeito nos agentes, e a reverberação de um `environment_id` é mixada
> em mono.

## Limitações

* Somente predefinições integradas. Não é possível enviar um arquivo personalizado nem indicar uma URL arbitrária.
* Os controles de ambiente de áudio ficam ocultos quando o agente é **somente texto**.
* O som de fundo não é mixado nas respostas de mensagem de voz do [WhatsApp](/docs/pt/eleven-agents/whatsapp). As chamadas do WhatsApp ainda o incluem.
* O som de fundo não pode ser definido por conversa por meio de [substituições](/docs/pt/eleven-agents/customization/personalization/overrides) do cliente; `conversation_config_override` não inclui `background_sound`. Ainda é possível alterá-lo em um nó de [workflow](/docs/pt/eleven-agents/customization/agent-workflows).

## Relacionados

#### [Sons de chamadas de ferramenta](/docs/pt/eleven-agents/customization/tools/tool-configuration/tool-call-sounds)

Reproduza áudio ambiente apenas enquanto uma ferramenta estiver em execução.

#### [Personalização de voz](/docs/pt/eleven-agents/customization/voice)

Escolha uma voz, velocidade e outras configurações de fala para o agente.