Mode Expert du VoiceAgent

Cet article explique comment utiliser le Mode Expert pour afficher, modifier et importer la configuration complète de votre VoiceAgent via l’onglet Avancé.

Niveau utilisateur\u202F: Admin

Le Mode Expert vous donne un accès direct à la configuration complète de votre VoiceAgent sous forme de fichier JSON. Il déverrouille l’onglet Avancé dans les paramètres du VoiceAgent, où vous pouvez afficher, modifier et importer des configurations, avec accès à des champs et des options de réglage fin qui ne sont pas disponibles dans l’onglet Formulaire.

Ce que vous pouvez faire avec le Mode Expert

Le Mode Expert est utile lorsque vous devez mettre à jour un paramètre qui n’est pas disponible dans l’onglet Formulaire, par exemple pour passer à un modèle d’IA spécifique, ajuster le comportement de la voix ou affiner la gestion des appels. Ouvrez l’onglet Avancé, repérez le champ concerné, mettez à jour la valeur, puis enregistrez.

Le lien entre le Mode Expert et l’onglet Formulaire

L’onglet Formulaire et l’onglet Avancé affichent la même configuration sous deux formes différentes. Tout paramètre que vous configurez dans l’onglet Formulaire est également présent dans le JSON, et les modifications effectuées dans un onglet se répercutent dans l’autre. Le Mode Expert va au-delà de ce que propose l’onglet Formulaire. L’onglet Avancé expose des champs supplémentaires pour affiner le comportement du modèle d’IA, la qualité de la voix et la gestion des appels, qui n’apparaissent pas dans l’onglet Formulaire.

Champs disponibles dans les deux onglets

Les champs suivants peuvent être configurés aussi bien dans l’onglet Formulaire que dans l’onglet Avancé. Personnalité

Libellé de l’onglet Formulaire	Champ JSON	Ce que cela définit
Nom	`agentName`	Le nom d’affichage du VoiceAgent
Direction	`direction`	Indique si l’agent gère les appels entrants ou sortants. Valeurs acceptées\u202F: `"inbound"` ou `"outbound"`.
Langue	`language`	La langue parlée par le VoiceAgent
Langues supplémentaires	`secondaryLanguages`	Langues supplémentaires que le VoiceAgent peut détecter et vers lesquelles il peut basculer pendant un appel. Facultatif.
Voix	`voice`	La voix utilisée par le VoiceAgent
Message d’accueil	`greeting`	La phrase d’ouverture exacte que le VoiceAgent prononce au début de l’appel. Si ce champ est laissé 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.

Sources de connaissances

Libellé de l’onglet Formulaire	Champ JSON	Ce que cela définit
Bases de connaissances	`knowledgeBaseIds`	Bases de connaissances sur lesquelles le VoiceAgent peut s’appuyer pour répondre aux questions

Comportement

Libellé de l’onglet Formulaire	Champ JSON	Ce que cela définit
Prompt d’objectif	`goalPrompt`	Les instructions principales qui définissent le comportement du VoiceAgent pendant un appel
Compétences	`skills`	Fonctionnalités structurées : Transférer à un humain, Prendre un message, Extraire des informations, Répondre aux questions, Prise de rendez-vous
Scénarios	`scenarios`	Comment le VoiceAgent réagit à des situations spécifiques, y compris pour mettre fin aux appels
Garde-fous	`guardrails`	Réponses fixes pour les situations qui nécessitent une réponse cohérente quel que soit le contexte

Champs réservés au Mode Expert

Les champs suivants ne sont accessibles que via l’onglet Avancé.

Style de conversation

Ces deux champs contrôlent la manière dont le VoiceAgent s’exprime. Ils sont facultatifs : si vous ne les définissez pas, CloudTalk applique des valeurs par défaut correspondant au comportement actuel du VoiceAgent. Lors de votre prochain enregistrement, les deux champs apparaissent automatiquement dans le JSON avec leurs valeurs par défaut. C’est normal.

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, les valeurs en texte libre ne sont pas acceptées.	`"professional"`, `"friendly"`, `"casual"`, `"calm"`, `"empathetic"`, `"direct"`.Facultatif ; 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"`. Facultatif ; valeur par défaut `"standard"`.

Guide des préréglages de ton\u202F:

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. Si vous définissez une valeur non prise en charge, un message de validation répertorie les valeurs autorisées et la configuration n’est pas enregistrée.

Modèle d’IA

Champ	Ce que cela définit
`llmOverride`	Fixe un modèle d’IA spécifique au lieu d’utiliser la sélection automatique. Consultez la liste des modèles pris en charge ci-dessous.
`providerOverride`	Force un fournisseur vocal spécifique (`"elevenlabs"` ou `"deepgram"`). Dans la plupart des cas, il n’est pas nécessaire de le définir manuellement, car la langue détermine automatiquement le fournisseur.
`temperature`	Contrôle la variabilité des réponses du VoiceAgent. Accepte des valeurs de `0.0` à `1.0`. Pour les agents professionnels ou structurés, une valeur comprise entre `0.1` et `0.3` est recommandée. Obligatoire.

Modèles pris en charge pour llmOverride

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`	Contrôle 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`. Obligatoire.
`similarity`	Contrôle la fidélité de la voix par rapport au modèle vocal d’origine.	`0.0`–`1.0`. Obligatoire.
`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 définissez pas cette valeur sur `4`, car cela désactive la normalisation du texte, ce qui entraîne une mauvaise prononciation des nombres et des dates.	`0`–`4`. Obligatoire.

Comportement de l’appel

Champ	Ce que cela définit	Valeurs
`maxCallDuration`	Définit 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. Obligatoire.
`dialTime`	Durée pendant laquelle le VoiceAgent attend une réponse lors des appels sortants avant d’abandonner.	`5`–`120` secondes. Facultatif.

Réglages avancés ElevenLabs

Ces paramètres s’appliquent uniquement lorsque votre VoiceAgent utilise ElevenLabs, ce qui est la configuration par défaut pour la plupart des langues.

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 la latence de réponse perçue.	`true` / `false`
`turnEagerness`	Contrôle la rapidité avec laquelle le VoiceAgent prend la parole lorsque l’appelant marque une pause.	`"patient"` / `"normal"` / `"eager"`
`turnModel`	Définit la version du modèle de détection de tour de parole utilisé.	`"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. Utile pour les noms de produits ou la terminologie technique.	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. Facultatif.
`interruptionIgnoreTermLanguages`	Les langues dans lesquelles ces termes ignorés sont reconnus.	Liste de codes de langue. Facultatif.
`backgroundSound`	Diffuse un fond sonore d’ambiance sous la voix du VoiceAgent.	Objet : `preset` (obligatoire lorsque backgroundSound est défini ; 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).

Dans l’onglet Avancé, ces champs doivent être placés à l’intérieur d’un objet elevenLabsSettings. Ils ne doivent pas se trouver à la racine de la configuration. Voici un exemple montrant comment les imbriquer\u202F:

{
  "agentName": "Clinic Reception",
  "direction": "inbound",
  "language": "es",
  "temperature": 0.2,
  "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
    }
  }
}

Lorsqu’une configuration enregistrée inclut elevenLabsSettings, l’objet envoyé remplace celui qui est stocké. Pour effacer un seul sous-champ, omettez-le de l’objet envoyé. Si vous omettez entièrement elevenLabsSettings, les paramètres stockés sont conservés.

Ces champs doivent être placés à l’intérieur de elevenLabsSettings ; à la racine, ils ne sont pas reconnus et l’enregistrement échoue avec une erreur de validation.

Importer et exporter des configurations

Vous pouvez exporter une configuration depuis l’onglet Avancé et l’importer dans un autre VoiceAgent, ou la partager avec un autre utilisateur afin qu’il l’importe dans son compte. La plupart des configurations s’importent immédiatement, sans configuration supplémentaire nécessaire. L’exception concerne les configurations qui font référence à des ressources propres à votre compte, comme une base de connaissances, un outil personnalisé, un numéro de téléphone ou une intégration de calendrier. Ces connexions doivent être configurées manuellement après l’importation. Après toute importation réussie, enregistrez le VoiceAgent deux fois. Un ensemble connu de cas particuliers n’apparaît qu’après le second enregistrement. Les configurations exportées incluent désormais tone et verbosity. Si une configuration importée contient une valeur non prise en charge pour ces champs (ou pour tout autre champ), l’importation est rejetée avec un message indiquant le champ concerné et les valeurs autorisées.

Besoin d’aide ou une question\u202F? 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

Ce que vous pouvez faire avec le Mode Expert

Le lien entre le Mode Expert et l’onglet Formulaire

Champs disponibles dans les deux onglets

Champs réservés au Mode Expert

Style de conversation

Modèle d’IA

Réglage de la voix

Comportement de l’appel

Réglages avancés ElevenLabs

Importer et exporter des configurations

​Ce que vous pouvez faire avec le Mode Expert

​Le lien entre le Mode Expert et l’onglet Formulaire

​Champs disponibles dans les deux onglets

​Champs réservés au Mode Expert

​Style de conversation

​Modèle d’IA

​Réglage de la voix

​Comportement de l’appel

​Réglages avancés ElevenLabs

​Importer et exporter des configurations

Ce que vous pouvez faire avec le Mode Expert

Le lien entre le Mode Expert et l’onglet Formulaire

Champs disponibles dans les deux onglets

Champs réservés au Mode Expert

Style de conversation

Modèle d’IA

Réglage de la voix

Comportement de l’appel

Réglages avancés ElevenLabs

Importer et exporter des configurations