> ## 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.

# VoiceAgent-expertmodus

> Ontgrendel geavanceerde VoiceAgent-instellingen voor AI-model, stem en gespreksafhandeling.

<Note>
  Dit artikel legt uit hoe u Expertmodus gebruikt om de volledige configuratie van uw VoiceAgent te bekijken, bewerken en importeren via het tabblad *Geavanceerd*.
</Note>

**Gebruikersniveau:** Admin

***

**Expertmodus** geeft u rechtstreeks toegang tot de volledige configuratie van uw VoiceAgent als JSON-bestand. Het ontgrendelt het tabblad *Geavanceerd* in de VoiceAgent-instellingen, waar u configuraties kunt bekijken, bewerken en importeren, met toegang tot velden en fine-tuning-opties die niet beschikbaar zijn in het tabblad *Formulier*.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15933044/05b4c10fd19a-screenshot-2026-07-14-at-13-30-45.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=dd72b611a47c195276d367175de18678" alt="" width="2679" height="1497" data-path="images/help-center/articles/15933044/05b4c10fd19a-screenshot-2026-07-14-at-13-30-45.png" />
</Frame>

<h2 id="h_5a0a462910">
  Wat u kunt doen met Expertmodus
</h2>

Expertmodus is handig wanneer u een instelling wilt wijzigen die niet beschikbaar is in het tabblad *Formulier*, zoals overschakelen naar een specifiek AI-model, het aanpassen van het stemgedrag of het fine-tunen van de gespreksafhandeling. U opent het tabblad *Geavanceerd*, zoekt het betreffende veld op, past de waarde aan en slaat op.

<h2 id="h_545903f3bc">
  Hoe Expertmodus zich verhoudt tot het tabblad Formulier
</h2>

Het Formulier-tabblad en het tabblad *Geavanceerd* tonen dezelfde configuratie op twee verschillende manieren. Elke instelling die u configureert in het tabblad *Formulier* is ook aanwezig in de JSON, en wijzigingen in het ene tabblad worden weergegeven in het andere.

Expertmodus breidt uit wat het tabblad *Formulier* biedt. Het tabblad *Geavanceerd* geeft toegang tot extra velden voor het fine-tunen van AI-modelgedrag, stemkwaliteit en gespreksafhandeling die niet voorkomen in het tabblad *Formulier*.

<h2 id="h_619216c1b6">
  Velden die in beide tabbladen beschikbaar zijn
</h2>

De volgende velden kunnen worden geconfigureerd in het tabblad *Formulier* of het tabblad *Geavanceerd*.

**Persoonlijkheid**

| ***Formulier*tabblad-label** | **JSON-veld** | **Wat dit instelt** |
| - | - | - |
| Naam | `agentName` | De weergavenaam van de VoiceAgent |
| Oproeprichting | `direction` | Of de agent inkomende of uitgaande oproepen afhandelt. Toegestane waarden: `"inbound"` of `"outbound"`. |
| Taal | `language` | De taal die de VoiceAgent spreekt |
| Extra talen | `secondaryLanguages` | Extra talen die de VoiceAgent tijdens een gesprek kan detecteren en waarnaar hij kan overschakelen. Optioneel. |
| Stem | `voice` | De stem die de VoiceAgent gebruikt |
| Begroeting | `greeting` | De exacte openingszin die de VoiceAgent aan het begin van een gesprek zegt. Als dit leeg blijft, gebruiken agents voor inkomende oproepen een algemene standaardzin; agents voor uitgaande oproepen beginnen met stilte. |

**Kennisbronnen**

| ***Formulier*tabblad-label** | **JSON-veld** | **Wat dit instelt** |
| - | - | - |
| Kennisbanken | `knowledgeBaseIds` | Kennisbanken die de VoiceAgent kan raadplegen bij het beantwoorden van vragen |

**Gedrag**

| ***Formulier*tabblad-label** | **JSON-veld** | **Wat dit instelt** |
| - | - | - |
| Doelprompt | `goalPrompt` | De kerninstructies die het gedrag van de VoiceAgent tijdens een gesprek bepalen |
| Vaardigheden | `skills` | Gestructureerde mogelijkheden: Doorverbinden naar medewerker, Bericht aannemen, Informatie extraheren, Vragen beantwoorden, Afspraak boeken |
| Scenario's | `scenarios` | Hoe de VoiceAgent reageert op specifieke situaties, waaronder het beëindigen van gesprekken |
| Guardrails | `guardrails` | Vaste antwoorden voor situaties die ongeacht de context een consistent antwoord vereisen |

<h2 id="h_fa958a5caf">
  Velden die alleen in Expertmodus beschikbaar zijn
</h2>

De volgende velden zijn alleen toegankelijk via het tabblad *Geavanceerd*.

<h3 id="h_ab1aebdc99">
  Gespreksstijl
</h3>

Deze twee velden bepalen hoe de VoiceAgent spreekt. Ze zijn optioneel: als u ze niet instelt, past CloudTalk standaardwaarden toe die overeenkomen met het bestaande gedrag van de VoiceAgent. Na uw volgende keer opslaan verschijnen beide velden automatisch in de JSON met hun standaardwaarden. Dit is normaal.

<table>
  <tbody>
    <tr>
      <td>
        **Veld**
      </td>

      <td>
        **Wat dit instelt**
      </td>

      <td>
        **Waarden**
      </td>
    </tr>

    <tr>
      <td>
        `tone`
      </td>

      <td>
        Hoe de VoiceAgent klinkt. Een lijst met stijlpresets; deze kunnen worden gecombineerd, maar één of twee werken het best (elke extra preset verzwakt de andere). De volgorde maakt niet uit, duplicaten worden automatisch verwijderd en vrije tekstwaarden worden niet geaccepteerd.
      </td>

      <td>
        `"professional"`, `"friendly"`, `"casual"`, `"calm"`, `"empathetic"`, `"direct"`.

        Optioneel; standaard `["friendly", "direct"]`.
      </td>
    </tr>

    <tr>
      <td>
        `verbosity`
      </td>

      <td>
        Hoeveel de VoiceAgent per antwoord zegt. `"concise"` = het kortst mogelijke bruikbare antwoord. `"standard"` = één tot twee zinnen, met meer indien nodig. `"thorough"` = uitgebreidere antwoorden met nuttige context (nog steeds beknopt; het is tenslotte een telefoongesprek).
      </td>

      <td>
        `"concise"` / `"standard"` / `"thorough"`. Optioneel; standaard `"standard"`.
      </td>
    </tr>
  </tbody>
</table>

**Gids voor toonpresets:**

| **Preset** | **Effect** |
| - | - |
| `professional` | Beheerst, precies en respectvol |
| `friendly` | Warm en persoonlijk |
| `casual` | Relaxed en informeel, zoals een behulpzame collega |
| `calm` | Rustig, ontspannen en geduldig |
| `empathetic` | Erkent de gevoelens van de beller voordat er naar oplossingen wordt overgegaan |
| `direct` | Begint met het antwoord en houdt beleefdheden tot een minimum beperkt |

Ongeacht toon en uitgebreidheid blijft de VoiceAgent altijd beknopt tijdens operationele momenten: bevestigingen, herhalingen ter controle, afscheidswoorden en doorverbind- of boekingsstappen.

Als u een niet-ondersteunde waarde instelt, verschijnt er een validatiebericht met de toegestane waarden en wordt de configuratie niet opgeslagen.

<h3 id="h_0b1da9843c">
  AI-model
</h3>

| **Veld** | **Wat dit instelt** |
| - | - |
| `llmOverride` | Legt een specifiek AI-model vast in plaats van automatische selectie te gebruiken. Zie de lijst met ondersteunde modellen hieronder. |
| `providerOverride` | Forceert een specifieke spraakprovider (`"elevenlabs"` of `"deepgram"`). In de meeste gevallen hoeft dit niet handmatig te worden ingesteld, omdat de taal de provider automatisch bepaalt. |
| `temperature` | Bepaalt hoe gevarieerd de reacties van de VoiceAgent zijn. Accepteert waarden van `0.0` tot `1.0`. Voor professionele of gestructureerde agents wordt een waarde tussen `0.1` en `0.3` aanbevolen. Verplicht. |

**Ondersteunde modellen voor `llmOverride`**

| **Model** | **Waarde** |
| - | - |
| 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` |

<h3 id="h_e13347be06">
  Stem finetunen
</h3>

| **Veld** | **Wat dit instelt** | **Waarden** |
| - | - | - |
| `stability` | Bepaalt hoe consistent de stem van de VoiceAgent tijdens het gesprek klinkt. Hogere waarden zorgen voor een stabielere stem. | `0.0`–`1.0`. Verplicht. |
| `similarity` | Bepaalt hoe nauw de stem overeenkomt met het oorspronkelijke stemmodel. | `0.0`–`1.0`. Verplicht. |
| `optimizeStreamingLatency` | Wisselt stemkwaliteit in voor een lagere responslatentie. Hogere waarden verminderen de latentie, maar kunnen de kwaliteit beïnvloeden. Stel dit niet in op `4`, omdat dit tekstnormalisatie uitschakelt, waardoor cijfers en datums verkeerd worden uitgesproken. | `0`–`4`. Verplicht. |

<h3 id="h_45623a84dc">
  Gespreksgedrag
</h3>

| **Veld** | **Wat dit instelt** | **Waarden** |
| - | - | - |
| `maxCallDuration` | Stelt een harde limiet in voor de duur van het gesprek, in minuten. | Aanbevolen: 3–5 voor uitgaande oproepen, 15–30 voor inkomende oproepen. Verplicht. |
| `dialTime` | Hoe lang de VoiceAgent wacht op een antwoord bij uitgaande oproepen voordat hij het opgeeft. | `5`–`120` seconden. Optioneel. |

<h3 id="h_f6fb35e27b">
  Geavanceerde ElevenLabs-afstemming
</h3>

Deze instellingen zijn alleen van toepassing wanneer uw VoiceAgent ElevenLabs gebruikt, wat de standaardinstelling is voor de meeste taalconfiguraties.

| **Veld** | **Wat dit instelt** | **Waarden** |
| - | - | - |
| `speculativeTurn` | De VoiceAgent begint met het opstellen van zijn antwoord voordat de beller is uitgesproken, waardoor de waargenomen responslatentie afneemt. | `true` / `false` |
| `turnEagerness` | Bepaalt hoe snel de VoiceAgent het woord neemt wanneer de beller pauzeert. | `"patient"` / `"normal"` / `"eager"` |
| `turnModel` | Stelt de versie in van het gebruikte turn-detectiemodel. | `"turn_v2"` / `"turn_v3"` |
| `vad` | Filtert achtergrondgeluid weg zodat dit geen onbedoelde reactie veroorzaakt. | `true` / `false` |
| `asrKeywords` | Woorden of zinnen die voorrang krijgen bij spraakherkenning. Nuttig voor productnamen of technische terminologie. | Lijst met tekenreeksen |
| `interruptionIgnoreTerms` | Korte bevestigingen van de beller (bijvoorbeeld instemmende geluiden) die niet als onderbreking moeten tellen, zodat de VoiceAgent blijft doorpraten. Geschreven in de taal van de beller. | Lijst met tekenreeksen. Optioneel. |
| `interruptionIgnoreTermLanguages` | De talen waarin de negeertermen worden herkend. | Lijst met taalcodes. Optioneel. |
| `backgroundSound` | Speelt een achtergrondgeluid af onder de spraak van de VoiceAgent. | Object: `preset` (verplicht wanneer backgroundSound is ingesteld; een van `"office"`, `"office2"`, `"restaurant"`, `"city"`, `"typing"`, `"elevator"`, `"elevator2"`, `"elevator3"`, `"elevator4"`), `volume` (`0.0`–`1.0`, optioneel), `crossfadeLoop` (`true`/`false`, optioneel; herhaalt het geluid naadloos in een lus). |

In het tabblad *Geavanceerd* moeten deze velden binnen een `elevenLabsSettings`-object worden geplaatst. Ze horen niet op het hoofdniveau van de configuratie. Hieronder ziet u een voorbeeld van hoe u ze nest:

```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
    }
  }
}
```

<Warning>
  Wanneer een opgeslagen configuratie `elevenLabsSettings` bevat, vervangt het verzonden object het opgeslagen object. Om een enkel subveld te wissen, laat u dit weg uit het verzonden object. Als u `elevenLabsSettings` volledig weglaat, blijven de opgeslagen instellingen behouden.
</Warning>

Deze velden moeten binnen `elevenLabsSettings` worden geplaatst; op het hoofdniveau worden ze niet herkend en mislukt het opslaan met een validatiefout.

<h2 id="h_5b5f294b62">
  Configuraties importeren en exporteren
</h2>

U kunt een configuratie exporteren vanuit het tabblad *Geavanceerd* en deze importeren in een andere VoiceAgent, of deze delen met een andere gebruiker om in hun account te importeren.

De meeste configuraties worden direct geïmporteerd zonder extra instellingen. Uitzondering hierop is wanneer een configuratie verwijst naar resources die specifiek zijn voor uw account, zoals een kennisbank, een aangepaste tool, een telefoonnummer of een agenda-integratie. Deze koppelingen moet u na het importeren handmatig instellen.

Sla de VoiceAgent na elke geslaagde import twee keer op. Een bekende reeks randgevallen komt pas na de tweede keer opslaan naar voren.

Geëxporteerde configuraties bevatten nu `tone` en `verbosity`. Als een geïmporteerde configuratie een niet-ondersteunde waarde bevat voor deze (of andere) velden, wordt de import geweigerd met een bericht dat het veld en de toegestane waarden vermeldt.

***

*Hulp nodig of een vraag?* Neem gewoon contact op via ons [Support portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — we staan voor u klaar.


## Related topics

- [VoiceAgent-vaardigheden](/nl/articles/14072758-voiceagent-skills.md)
- [VoiceAgent-doorverbindingen](/nl/articles/11393590-voiceagent-call-transfers.md)
- [Kennisbank voor VoiceAgents](/nl/articles/11204159-knowledge-base-for-voiceagents.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.