Passer à la navigation

Environnement audio

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

Vue d’ensemble

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

  • Son d’ambiance diffuse un son ambiant en boucle sous la parole de l’agent.
  • Filtre vocal applique un filtre de type téléphone à 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 conversation. Le son continue de tourner 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 incluent des sons de bureau, de restaurant, de ville, de frappe au clavier et de 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

1

Ouvrir Environnement audio

Ouvrez votre agent. Sur la page de l’agent, à côté de Voix, cliquez sur le bouton Environnement audio.

2

Activer le son d’ambiance

Activez Activer le son d’ambiance. Choisissez un préréglage dans Son d’ambiance. Utilisez le bouton de lecture à côté de la liste déroulante pour le préécouter.

3

Définir le volume et la boucle

Définissez le Volume. Laissez Boucle avec fondu enchaîné activé afin d’éviter un clic audible lorsque le son se répète. Enregistrez vos modifications.

Sur les connexions WebSocket de très mauvaise qualité, le mixage du son d’ambiance peut produire un audio saccadé.

Paramètres

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

ChampTypeValeur par défautDescription
source_typestringnon définiDoit être preset lorsqu’un son est activé. À définir avec source_id.
source_idstringnon définiIdentifiant d’un préréglage intégré.
volumenumber0.15Niveau relatif à la parole de l’agent. Plage : 0.01–1.0.
crossfade_loopbooleantrueFondu enchaîné à la fin de la boucle afin d’éviter un clic à la répétition.

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 ; le son d’ambiance est mixé sous la parole filtrée.

Configurez le filtre vocal avec conversation_config.tts.audio_effects.filter_preset_id. Le Dashboard propose les préréglages téléphone ; via la CLI ou l’API, vous pouvez définir n’importe quel préréglage de filtre répertorié dans le catalogue des effets audio.

Dans le même panneau Environnement audio, définissez Filtre vocal sur Désactivé ou sur un préréglage téléphone, puis enregistrez.

L’audio de l’agent est mono. pan n’a aucun effet sur les agents, et la réverbération d’un environment_id est mixée en mono.

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 uniquement textuel.
  • Le son d’ambiance n’est pas mixé dans les réponses aux messages vocaux 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.

Associé