Saltar a la navegación

Entorno de audio

Añade un sonido de fondo y aplica un filtro de voz al audio saliente del agente.

Resumen

El entorno de audio controla cómo suena para quien llama el audio saliente del agente. Se aplican dos ajustes:

  • Sonido de fondo reproduce un sonido ambiental en bucle bajo la voz del agente.
  • Filtro de voz aplica un filtro de estilo telefónico a la voz del agente antes de esa mezcla.

Quien llama escucha el resultado. El agente no escucha el sonido de fondo y este no se envía al reconocimiento de voz.

Esto es independiente de los sonidos de llamadas a herramientas, que solo se reproducen mientras se ejecuta una herramienta.

Sonido de fondo

El sonido de fondo mezcla un preajuste integrado bajo la voz del agente durante toda la conversación. El sonido sigue repitiéndose cuando el usuario interrumpe; no se detiene al terminar el turno del agente.

Los preajustes incluyen oficina, restaurante, ciudad, escritura y música de ascensor. En el panel, puedes previsualizar un preajuste antes de guardarlo.

Configura el sonido de fondo con conversation_config.conversation.background_sound.

Configuración

1

Abre Entorno de audio

Abre tu agente. En la página del agente, junto a Voces, haz clic en el botón Entorno de audio.

2

Activa el sonido de fondo

Activa Activar sonido de fondo. Elige un preajuste en Sonido de fondo. Usa el control de reproducción junto al menú desplegable para previsualizarlo.

3

Ajusta el volumen y el bucle

Ajusta el Volumen. Mantén activado Bucle con fundido cruzado para evitar un clic audible cuando el sonido se repita. Guarda los cambios.

En conexiones WebSocket de muy baja calidad, mezclar sonido de fondo puede producir audio entrecortado.

Parámetros

Los valores válidos de source_id son office1, office2, restaurant, city, typing y del elevator1 al elevator4.

CampoTipoPredeterminadoDescripción
source_typestringsin configurarDebe ser preset cuando hay un sonido activado. Configúralo junto con source_id.
source_idstringsin configurarIdentificador de un preajuste integrado.
volumenumber0.15Nivel relativo a la voz del agente. Intervalo: 0.01–1.0.
crossfade_loopbooleantrueAplica un fundido cruzado al final del bucle para que el sonido no haga clic al repetirse.

Filtro de voz

El filtro de voz modifica la voz generada del agente. No ecualiza ni elimina el ruido del sonido de fondo. El filtro se aplica primero; el sonido de fondo se mezcla bajo la voz filtrada.

Configura el filtro de voz con conversation_config.tts.audio_effects.filter_preset_id. El panel ofrece los preajustes de teléfono; mediante la CLI o la API puedes configurar cualquier preajuste de filtro incluido en el catálogo de efectos de audio.

En el mismo panel de Entorno de audio, configura Filtro de voz como Desactivado o como un preajuste de teléfono y, a continuación, guarda los cambios.

El audio del agente es mono. pan no tiene efecto en los agentes y la reverberación de un environment_id se mezcla en mono.

Limitaciones

  • Solo hay preajustes integrados. No puedes subir un archivo personalizado ni indicar una URL arbitraria.
  • Los controles del entorno de audio están ocultos cuando el agente es solo texto.
  • El sonido de fondo no se mezcla en las respuestas de mensajes de voz de WhatsApp. Las llamadas de WhatsApp sí lo incluyen.
  • El sonido de fondo no se puede configurar por conversación mediante las anulaciones del cliente; conversation_config_override no incluye background_sound. Aun así, puedes cambiarlo en un nodo de workflow.

Relacionado