Ambiente audio

Aggiungi un suono di sottofondo e applica un filtro vocale all'audio in uscita dell'agente.

Panoramica

L’ambiente audio controlla come suona l’audio in uscita dell’agente per chi chiama. Si applicano due impostazioni:

Suono di sottofondo riproduce in loop un suono ambientale sotto il parlato dell’agente.
Filtro vocale applica un filtro in stile telefonico alla voce dell’agente prima del mixaggio.

Chi chiama ascolta 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, che vengono riprodotti solo mentre è in esecuzione uno strumento.

Suono di sottofondo

Il suono di sottofondo mixa un preset integrato sotto il parlato dell’agente per la durata della conversazione. Il suono continua a ripetersi quando l’utente interrompe l’agente; non si interrompe con il 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

Aggiorna tramite la CLI

Aggiorna tramite l'API

Apri Ambiente audio

Apri il tuo agente. Nella pagina dell’agente, accanto a Voci, fai clic sul pulsante Ambiente audio.

Abilita il suono di sottofondo

Attiva Abilita suono di sottofondo. Scegli un preset da Suono di sottofondo. Usa il controllo di riproduzione accanto al menu a discesa per ascoltarne l’anteprima.

Imposta volume e ripetizione

Imposta il Volume. Mantieni abilitata l’opzione Ripetizione con dissolvenza incrociata per evitare un clic udibile quando il suono si ripete. Salva le modifiche.

Con connessioni WebSocket molto scarse, il mixaggio del suono di sottofondo può produrre audio a scatti.

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 rispetto al parlato dell’agente. Intervallo `0.01`–`1.0`.
`crossfade_loop`	boolean	`true`	Dissolvenza incrociata al limite del loop, per evitare clic quando il suono si ripete.

Filtro vocale

Il filtro vocale modifica la voce generata dell’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.

Configura il filtro vocale con conversation_config.tts.audio_effects.filter_preset_id. La dashboard offre i preset telefonici; tramite CLI o API puoi impostare qualsiasi preset di filtro elencato nel catalogo degli effetti audio.

Aggiorna dalla dashboard

Aggiorna tramite la CLI

Aggiorna tramite l'API

Nello stesso pannello Ambiente audio, imposta Filtro vocale su Disattivato o su un preset telefonico, quindi salva.

L’audio dell’agente è mono. pan non ha effetto sugli agenti e il riverbero di un environment_id viene mixato in mono.

Limitazioni

Solo preset integrati. Non puoi caricare un file personalizzato né indicare un URL arbitrario.
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. Le chiamate WhatsApp lo includono comunque.
Il suono di sottofondo non può essere impostato per singola conversazione tramite gli override client; conversation_config_override non include background_sound. Puoi comunque modificarlo in un nodo di workflow.

Correlati

Suoni delle chiamate agli strumenti

Riproduci audio ambientale solo mentre è in esecuzione uno strumento.

Personalizzazione della voce

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