Ir para a navegação

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

1

Abrir Ambiente de áudio

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

2

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.

3

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.

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.

CampoTipoPadrãoDescrição
source_typestringnão definidoDeve ser preset quando um som estiver ativado. Defina junto com source_id.
source_idstringnão definidoIdentificador de uma predefinição integrada.
volumenumber0.15Nível em relação à fala do agente. Intervalo de 0.01 a 1.0.
crossfade_loopbooleantrueAplica 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.

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

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