Ambiente audio

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

Panoramica

L’ambiente audio controlla il modo in cui l’audio in uscita dell’agente viene percepito dal chiamante. Si applicano due impostazioni:

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

Il chiamante sente 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 durante l’esecuzione di uno strumento.

Suono di sottofondo

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

Aggiorna tramite API

Apri Ambiente audio

Apri il tuo agente. Nella pagina Agent, accanto a Voices, fai clic sul pulsante Audio environment.

Abilita il suono di sottofondo

Attiva Enable background sound. Scegli un preset da Background sound. Usa il controllo di riproduzione accanto al menu a discesa per ascoltarne l’anteprima.

Imposta volume e loop

Imposta Volume. Mantieni abilitato Crossfade loop per evitare uno scatto udibile quando il suono si ripete. Salva le modifiche.

Su connessioni WebSocket molto instabili, il mixaggio del suono di sottofondo può produrre audio frammentato.

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 relativo al parlato dell’agente. Intervallo `0.01`–`1.0`.
`crossfade_loop`	boolean	`true`	Dissolvenza incrociata al confine del loop, così il suono non produce scatti quando si ripete.

Filtro vocale

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

Il filtro vocale è disponibile solo nella dashboard. Non fa parte dell’API pubblica dell’agente né dello schema CLI e potrebbe non essere disponibile in tutti i workspace.

Nello stesso pannello Audio environment, imposta Voice filter su Off o su un preset telefonico, quindi salva.

Limitazioni

Sono disponibili solo preset integrati. Non puoi caricare un file personalizzato né indicare un URL qualsiasi.
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. Nelle chiamate WhatsApp è comunque incluso.
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.

Contenuti correlati

Suoni delle chiamate agli strumenti

Riproduci audio ambientale solo durante l’esecuzione di uno strumento.

Personalizzazione della voce

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