Environnement audio

Ajoutez un son d’ambiance et appliquez un filtre vocal à l’audio sortant de l’agent.

Présentation

L’environnement audio contrôle le rendu de l’audio sortant de l’agent pour l’appelant. Deux paramètres s’appliquent :

Le son d’ambiance diffuse un son ambiant en boucle sous la parole de l’agent.
Le filtre vocal applique un filtre téléphonique à la voix de l’agent avant ce mixage.

L’appelant entend le résultat. L’agent n’entend pas le son d’ambiance, qui n’est pas envoyé à la reconnaissance vocale.

Cette fonctionnalité est distincte des sons d’appel d’outil, qui ne sont diffusés que pendant l’exécution d’un outil.

Son d’ambiance

Le son d’ambiance mixe un préréglage intégré sous la parole de l’agent pendant toute la durée de la conversation. Le son continue en boucle lorsque l’utilisateur interrompt l’agent, il ne s’arrête pas à la fin du tour de parole de l’agent.

Les préréglages comprennent un bureau, un restaurant, une ville, des frappes au clavier et une musique d’ascenseur. Dans le Dashboard, vous pouvez préécouter un préréglage avant de l’enregistrer.

Configurez le son d’ambiance avec conversation_config.conversation.background_sound.

Configuration

Mettre à jour via le Dashboard

Mettre à jour via la CLI

Mettre à jour via l'API

Ouvrir Environnement audio

Ouvrez votre agent. Sur la page Agent, à côté de Voices, cliquez sur le bouton Audio environment.

Activer le son d'ambiance

Activez Enable background sound. Choisissez un préréglage dans Background sound. Utilisez le bouton de lecture à côté de la liste déroulante pour le préécouter.

Définir le volume et la boucle

Définissez Volume. Laissez Crossfade loop activé pour éviter un clic audible lorsque le son se répète. Enregistrez vos modifications.

Avec des connexions WebSocket de très mauvaise qualité, le mixage du son d’ambiance peut produire un audio haché.

Paramètres

Les valeurs source_id valides sont office1, office2, restaurant, city, typing et elevator1 à elevator4.

Champ	Type	Par défaut	Description
`source_type`	string	non défini	Doit être `preset` lorsqu’un son est activé. À définir avec `source_id`.
`source_id`	string	non défini	Identifiant d’un préréglage intégré.
`volume`	number	`0.15`	Niveau relatif à la parole de l’agent. Plage : `0.01` à `1.0`.
`crossfade_loop`	boolean	`true`	Fondu enchaîné à la fin de la boucle afin d’éviter un clic lorsque le son se répète.

Filtre vocal

Le filtre vocal modifie la voix générée de l’agent. Il n’égalise ni ne réduit le bruit du son d’ambiance. Le filtre est appliqué en premier, puis le son d’ambiance est mixé sous la parole filtrée.

Le filtre vocal est uniquement disponible dans le Dashboard. Il ne fait pas partie du schéma public de l’API ou de la CLI des agents, et il peut ne pas être disponible dans tous les Workspaces.

Dans le même panneau Audio environment, définissez Voice filter sur Off ou sur un préréglage téléphonique, puis enregistrez.

Limites

Préréglages intégrés uniquement. Vous ne pouvez pas importer de fichier personnalisé ni indiquer une URL arbitraire.
Les contrôles de l’environnement audio sont masqués lorsque l’agent est text-only.
Le son d’ambiance n’est pas mixé aux réponses par message vocal WhatsApp. Les appels WhatsApp l’incluent toujours.
Le son d’ambiance ne peut pas être défini pour chaque conversation via les remplacements client ; conversation_config_override n’inclut pas background_sound. Vous pouvez toujours le modifier sur un nœud de workflow.

Liens associés

Sons d'appel d'outil

Diffusez un son d’ambiance uniquement pendant l’exécution d’un outil.

Personnalisation de la voix

Choisissez une voix, une vitesse et d’autres paramètres de parole pour l’agent.