> ## Documentation Index > Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt > Use this file to discover all available pages before exploring further. # Mode Expert du VoiceAgent > Déverrouillez les paramètres avancés du VoiceAgent pour le modèle d'IA, la voix et la gestion des appels. 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: ```json theme={"system"} { "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](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — nous sommes là pour vous. ## Related topics - [Modèles de VoiceAgent : Réceptionniste IA pendant les heures d'ouverture](/fr/articles/15645612-voiceagent-templates-during-hours-ai-receptionist.md) - [Modèles de VoiceAgent : Réceptionniste IA en dehors des heures d'ouverture](/fr/articles/15653481-voiceagent-templates-after-hours-ai-receptionist.md) - [Premiers pas avec les VoiceAgents](/fr/articles/11053795-getting-started-with-voiceagents.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.