Mode Expert du VoiceAgent

Cet article explique comment afficher et modifier la configuration complète de votre VoiceAgent dans la section Avancé, y compris des paramètres que vous ne pouvez modifier nulle part ailleurs.

Niveau utilisateur : Admin

Le Mode Expert vous donne la configuration complète de votre VoiceAgent au format JSON. Il affiche tous les paramètres, y compris ceux que vous n’avez jamais modifiés, avec leurs valeurs actuelles. Vous pouvez affiner des paramètres qui ne sont pas disponibles dans les autres sections, comme le modèle d’IA, le comportement de la voix et la gestion des appels.

Ouvrir le Mode Expert

Dans le Dashboard, accédez à AI Voice Agents > Agents et ouvrez votre VoiceAgent.
Dans le menu de gauche, sous Création, cliquez sur Avancé.

La section Avancé d'un VoiceAgent, avec le panneau Configuration affichant le JSON complet et la barre d'état Aucun problème

Le panneau Configuration affiche la configuration complète. Au-dessus, vous pouvez aussi demander à AI Composer d’effectuer des modifications pour vous, en langage courant.

Ce que vous voyez

Tous les paramètres, avec leur valeur. Les paramètres que vous n’avez pas modifiés affichent leur valeur par défaut : vous voyez ainsi tout ce que vous pouvez ajuster. Vous n’avez pas besoin d’enregistrer au préalable pour les voir.
Les paramètres de chaque fournisseur vocal. elevenLabsSettings et deepgramSettings sont tous deux affichés, quel que soit le fournisseur utilisé par votre VoiceAgent.
Une barre d’état au-dessus du JSON. Elle indique Aucun problème lorsque la configuration est valide. En cas d’erreur, par exemple une valeur non prise en charge, elle vous indique ce qu’il faut corriger avant de pouvoir enregistrer.

Modifier la configuration

Modifiez les valeurs souhaitées dans le panneau Configuration.
Vérifiez que la barre d’état indique Aucun problème.
Cliquez sur Enregistrer.

Pour annuler vos modifications non enregistrées, cliquez sur Rétablir. Les autres sections (Identité, Base de connaissances et Compétences et scénarios) et la section Avancé affichent la même configuration sous deux formes différentes. Une modification effectuée dans l’une se répercute dans l’autre.

Copier une configuration vers un autre VoiceAgent

Dans la section Avancé, cliquez sur Copier pour copier la configuration complète, y compris les valeurs par défaut.
Ouvrez la section Avancé de l’autre VoiceAgent, remplacez sa configuration par celle que vous avez copiée, puis cliquez sur Enregistrer.

Comme la copie inclut tous les paramètres, l’autre VoiceAgent se comporte exactement de la même manière.

Modifiez le agentName. Chaque VoiceAgent doit avoir un nom unique.
Reconnectez les ressources propres au compte. Une configuration peut faire référence à des éléments qui appartiennent à votre compte, comme des bases de connaissances, des outils personnalisés, des numéros de téléphone ou une intégration de calendrier. Lorsque vous copiez une configuration vers un autre compte, configurez à nouveau ces éléments dans ce compte.
Après une importation réussie, enregistrez le VoiceAgent deux fois. Un ensemble connu de cas particuliers n’apparaît qu’après le second enregistrement.

Référence des paramètres

Identité

Champ JSON	Ce que cela définit
`agentName`	Le nom du VoiceAgent. Il doit être unique dans votre compte.
`direction`	Indique si l’agent gère les appels entrants ou sortants : `"inbound"` ou `"outbound"`.
`language`	La langue parlée par le VoiceAgent.
`secondaryLanguages`	Langues supplémentaires que le VoiceAgent peut détecter et vers lesquelles il peut basculer pendant un appel. Facultatif.
`voice`	La voix utilisée par le VoiceAgent.
`greeting`	La phrase d’ouverture exacte que le VoiceAgent prononce au début de l’appel. Si ce champ est vide, les agents pour les appels entrants utilisent une valeur par défaut générique ; les agents pour les appels sortants commencent par un silence.
`startSpeakingFirst`	Indique si le VoiceAgent parle en premier lorsque l’appel est connecté (`true`) ou s’il attend l’appelant (`false`).
`defaultOutboundNumberId`	Le numéro de téléphone depuis lequel le VoiceAgent appelle.
`failoverOutboundNumberId`	Un numéro de secours depuis lequel appeler si le numéro par défaut ne peut pas être utilisé.

Connaissances et comportement

Champ JSON	Ce que cela définit
`knowledgeBaseIds`	Les bases de connaissances sur lesquelles le VoiceAgent peut s’appuyer pour répondre aux questions.
`goalPrompt`	Les instructions principales qui définissent le comportement du VoiceAgent pendant un appel.
`skills`	Fonctionnalités structurées, par exemple `takeMessage` et `extractData`. Chaque compétence possède `enabled` et ses propres paramètres.
`scenarios`	Comment le VoiceAgent réagit à des situations spécifiques. Chaque scénario possède `when`, `reply` et, éventuellement, une `action` comme `"hangup"`.
`guardrails`	Réponses fixes pour les situations qui nécessitent une réponse cohérente quel que soit le contexte.

Dans skills.extractData.properties, chaque propriété doit avoir un name unique. Si deux propriétés portent le même nom, la configuration n’est pas enregistrée.

Style de conversation

Ces deux champs contrôlent la manière dont le VoiceAgent s’exprime.

Champ	Ce que cela définit	Valeurs
`tone`	La manière dont le VoiceAgent sonne. Une liste de préréglages de style ; ils peuvent être combinés, mais un ou deux fonctionnent mieux (chaque préréglage supplémentaire dilue les autres). L’ordre n’a pas d’importance, les doublons sont supprimés automatiquement et les valeurs en texte libre ne sont pas acceptées.	`"professional"`, `"friendly"`, `"casual"`, `"calm"`, `"empathetic"`, `"direct"`. Valeur par défaut `["friendly", "direct"]`.
`verbosity`	La quantité de contenu que le VoiceAgent dit à chaque réponse. `"concise"` = la réponse utile la plus courte. `"standard"` = une à deux phrases, avec davantage de détails si nécessaire. `"thorough"` = des réponses plus complètes avec du contexte utile (toujours brèves ; il s’agit d’un appel téléphonique).	`"concise"` / `"standard"` / `"thorough"`. Valeur par défaut `"standard"`.

Guide des préréglages de ton :

Préréglage	Effet
`professional`	Mesuré, précis et respectueux
`friendly`	Chaleureux et sympathique
`casual`	Détendu et informel, comme un collègue serviable
`calm`	Posé, sans précipitation et patient
`empathetic`	Reconnaît les sentiments de l’appelant avant de passer aux solutions
`direct`	Va droit à la réponse et limite les formules de politesse au minimum

Quel que soit le ton ou le niveau de détail, le VoiceAgent reste toujours bref pendant les moments opérationnels : confirmations, relectures, formules de fin d’appel, et étapes de transfert ou de prise de rendez-vous.

Modèle d’IA

Champ	Ce que cela définit
`llm`	Le modèle d’IA utilisé par le VoiceAgent. Consultez la liste des modèles pris en charge ci-dessous.
`provider`	Le fournisseur vocal : `"elevenlabs"` ou `"deepgram"`. Dans la plupart des cas, la langue détermine automatiquement le fournisseur.
`temperature`	La variabilité des réponses du VoiceAgent, de `0.0` à `1.0`. Pour les agents professionnels ou structurés, une valeur de `0.1` à `0.3` est recommandée.

Modèles pris en charge pour llm

Modèle	Valeur
GPT-4o Mini	`openai - gpt-4o-mini`
GPT-4o	`openai - gpt-4o`
GPT-4.1	`openai - gpt-4.1`
GPT-4.1 Mini	`openai - gpt-4.1-mini`
GPT-4.1 Nano	`openai - gpt-4.1-nano`
GPT-5	`openai - gpt-5`
GPT-5 Mini	`openai - gpt-5-mini`
GPT-5 Nano	`openai - gpt-5-nano`
GPT-5.1	`openai - gpt-5.1`
Claude 3 Haiku	`anthropic - claude-3-haiku`
Claude Haiku 4.5	`anthropic - claude-haiku-4-5`
Claude 3.7 Sonnet	`anthropic - claude-3-7-sonnet`
Gemini 2.0 Flash Lite	`google - gemini-2.0-flash-lite`
Gemini 1.5 Pro	`google - gemini-1.5-pro`

Réglage de la voix

Champ	Ce que cela définit	Valeurs
`stability`	La constance de la voix du VoiceAgent tout au long de l’appel. Des valeurs plus élevées produisent une voix plus stable.	`0.0`–`1.0`
`similarity`	La fidélité de la voix par rapport au modèle vocal d’origine.	`0.0`–`1.0`
`optimizeStreamingLatency`	Sacrifie la qualité vocale pour réduire la latence de réponse. Des valeurs plus élevées réduisent la latence mais peuvent affecter la qualité. Ne la définissez pas sur `4` : cela désactive la normalisation du texte, et les nombres et les dates sont alors mal prononcés.	`0`–`4`

Comportement de l’appel

Champ	Ce que cela définit	Valeurs
`maxCallDuration`	Une limite stricte pour la durée de l’appel, en minutes.	Recommandé : 3–5 pour les appels sortants, 15–30 pour les appels entrants.
`dialTime`	Durée pendant laquelle le VoiceAgent attend une réponse lors des appels sortants avant d’abandonner.	`5`–`120` secondes.

Paramètres ElevenLabs

Ces paramètres s’appliquent lorsque votre VoiceAgent utilise ElevenLabs, la configuration par défaut pour la plupart des langues. Ils se trouvent à l’intérieur de l’objet elevenLabsSettings, et non à la racine de la configuration.

Champ	Ce que cela définit	Valeurs
`speculativeTurn`	Le VoiceAgent commence à formuler sa réponse avant que l’appelant ait fini de parler, ce qui réduit le temps de réponse.	`true` / `false`
`turnEagerness`	La rapidité avec laquelle le VoiceAgent prend la parole lorsque l’appelant marque une pause.	`"patient"` / `"normal"` / `"eager"`
`turnModel`	La version du modèle de détection de tour de parole.	`"turn_v2"` / `"turn_v3"`
`vad`	Filtre le bruit de fond afin qu’il ne déclenche pas de réponse involontaire.	`true` / `false`
`asrKeywords`	Mots ou expressions à privilégier dans la reconnaissance vocale, comme des noms de produits ou des termes techniques.	Liste de chaînes de caractères
`interruptionIgnoreTerms`	Courtes marques d’assentiment de l’appelant (par exemple des sons d’approbation) qui ne doivent pas être comptées comme une interruption, afin que le VoiceAgent continue de parler malgré elles. Rédigées dans la langue de l’appelant.	Liste de chaînes de caractères
`interruptionIgnoreTermLanguages`	Les langues dans lesquelles ces termes ignorés sont reconnus.	Liste de codes de langue
`backgroundSound`	Un son d’ambiance sous la voix du VoiceAgent. `null` signifie aucun son.	`null`, ou un objet : `preset` (une des valeurs `"office"`, `"office2"`, `"restaurant"`, `"city"`, `"typing"`, `"elevator"`, `"elevator2"`, `"elevator3"`, `"elevator4"`), `volume` (`0.0`–`1.0`, facultatif), `crossfadeLoop` (`true`/`false`, facultatif ; fait boucler le son de façon continue)

Exemple :

"elevenLabsSettings": {
  "speculativeTurn": true,
  "turnEagerness": "patient",
  "turnModel": "turn_v3",
  "vad": true,
  "asrKeywords": ["Capil Clinic", "injerto capilar", "Barcelona"],
  "interruptionIgnoreTerms": ["vale", "sí", "ajá"],
  "interruptionIgnoreTermLanguages": ["es"],
  "backgroundSound": {
    "preset": "office",
    "volume": 0.3,
    "crossfadeLoop": true
  }
}

Lors de l’enregistrement, l’objet elevenLabsSettings que vous envoyez remplace celui qui est stocké. Pour effacer un seul paramètre, supprimez-le de l’objet.

Paramètres Deepgram

deepgramSettings contient les paramètres des VoiceAgents qui utilisent Deepgram. Il est vide lorsqu’il n’y a rien à définir.

Gérés par CloudTalk

minorVersion et hashes sont gérés par CloudTalk. Laissez-les tels quels.

Besoin d’aide ou une question ? Contactez-nous simplement via notre Portail Support. Nous sommes là pour vous.

Premiers pas

Numéros et portabilité

IA

AI Sales Dialer

CloudTalk Phone et Go

Messages

Dashboard

Intégrations

Facturation et abonnement

Actualités et mises à jour techniques

Ancien Dashboard

Ouvrir le Mode Expert

Ce que vous voyez

Modifier la configuration

Copier une configuration vers un autre VoiceAgent

Référence des paramètres

Identité

Connaissances et comportement

Style de conversation

Modèle d’IA

Réglage de la voix

Comportement de l’appel

Paramètres ElevenLabs

Paramètres Deepgram

Gérés par CloudTalk

​Ouvrir le Mode Expert

​Ce que vous voyez

​Modifier la configuration

​Copier une configuration vers un autre VoiceAgent

​Référence des paramètres

​Identité

​Connaissances et comportement

​Style de conversation

​Modèle d’IA

​Réglage de la voix

​Comportement de l’appel

​Paramètres ElevenLabs

​Paramètres Deepgram

​Gérés par CloudTalk

Ouvrir le Mode Expert

Ce que vous voyez

Modifier la configuration

Copier une configuration vers un autre VoiceAgent

Référence des paramètres

Identité

Connaissances et comportement

Style de conversation

Modèle d’IA

Réglage de la voix

Comportement de l’appel

Paramètres ElevenLabs

Paramètres Deepgram

Gérés par CloudTalk