VoiceAgent-expertmodus

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

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.

Wat u kunt doen met Expertmodus

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.

Hoe Expertmodus zich verhoudt tot het tabblad Formulier

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.

Velden die in beide tabbladen beschikbaar zijn

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

Formuliertabblad-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

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

Gedrag

Formuliertabblad-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

Velden die alleen in Expertmodus beschikbaar zijn

De volgende velden zijn alleen toegankelijk via het tabblad Geavanceerd.

Gespreksstijl

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.

Veld	Wat dit instelt	Waarden
`tone`	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.	`"professional"`, `"friendly"`, `"casual"`, `"calm"`, `"empathetic"`, `"direct"`.Optioneel; standaard `["friendly", "direct"]`.
`verbosity`	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).	`"concise"` / `"standard"` / `"thorough"`. Optioneel; standaard `"standard"`.

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.

AI-model

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`

Stem finetunen

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.

Gespreksgedrag

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.

Geavanceerde ElevenLabs-afstemming

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:

{
  "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
    }
  }
}

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.

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

Configuraties importeren en exporteren

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 — we staan voor u klaar.

Aan de slag

Nummers & portering

AI

AI Sales Dialer

CloudTalk Phone & Go

Berichten

Dashboard

Integraties

Facturering & abonnement

Technisch nieuws & updates

Oude Dashboard

Wat u kunt doen met Expertmodus

Hoe Expertmodus zich verhoudt tot het tabblad Formulier

Velden die in beide tabbladen beschikbaar zijn

Velden die alleen in Expertmodus beschikbaar zijn

Gespreksstijl

AI-model

Stem finetunen

Gespreksgedrag

Geavanceerde ElevenLabs-afstemming

Configuraties importeren en exporteren

​Wat u kunt doen met Expertmodus

​Hoe Expertmodus zich verhoudt tot het tabblad Formulier

​Velden die in beide tabbladen beschikbaar zijn

​Velden die alleen in Expertmodus beschikbaar zijn

​Gespreksstijl

​AI-model

​Stem finetunen

​Gespreksgedrag

​Geavanceerde ElevenLabs-afstemming

​Configuraties importeren en exporteren

Wat u kunt doen met Expertmodus

Hoe Expertmodus zich verhoudt tot het tabblad Formulier

Velden die in beide tabbladen beschikbaar zijn

Velden die alleen in Expertmodus beschikbaar zijn

Gespreksstijl

AI-model

Stem finetunen

Gespreksgedrag

Geavanceerde ElevenLabs-afstemming

Configuraties importeren en exporteren