Ambiente de áudio

Adicione um som de fundo e aplique um filtro de voz ao áudio de saída do agente.

Visão geral

O ambiente de áudio controla como o áudio de saída do agente soa para quem liga. Há duas configurações:

Som de fundo reproduz um som ambiente em loop durante a fala do agente.
Filtro de voz aplica um filtro no estilo de 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 chamada de ferramenta, que são reproduzidos apenas enquanto uma ferramenta é executada.

Som de fundo

O som de fundo mistura uma predefinição integrada durante a fala do agente ao longo da conversa. O som continua em loop quando o usuário interrompe; ele não para quando termina o turno do agente.

As predefinições incluem escritório, restaurante, cidade, digitação e música de elevador. No dashboard, você pode ouvir uma predefinição antes de salvar.

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

Configuração

Atualizar pelo dashboard

Atualizar pela CLI

Atualizar pela API

Abrir Ambiente de áudio

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

Ativar o 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 ouvi-la.

Definir volume e loop

Defina o Volume. Mantenha Loop com transição suave ativado para evitar um clique audível quando o som se repetir. Salve as alterações.

Em conexões WebSocket muito instáveis, a mixagem do som de fundo pode gerar á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`	Faz uma transição suave no limite do loop para que o som não estale ao se repetir.

Filtro de voz

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

O filtro de voz está disponível apenas no dashboard. Ele não faz parte da API pública de agentes nem do esquema da CLI e pode não estar disponível em todos os workspaces.

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

Limitações

Apenas predefinições integradas. Você não pode 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. As chamadas do WhatsApp ainda o incluem.
O som de fundo não pode ser definido por conversa por meio de substituições do cliente; conversation_config_override não inclui background_sound. Ainda é possível alterá-lo em um nó de workflow.

Relacionados

Sons de chamada de ferramenta

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

Personalização de voz

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