VoiceAgent-expertmodus

Dit artikel legt uit hoe u de volledige configuratie van uw VoiceAgent bekijkt en bewerkt in de sectie Geavanceerd, inclusief instellingen die u nergens anders kunt wijzigen.

Gebruikersniveau: Admin

Expertmodus geeft u de volledige configuratie van uw VoiceAgent als JSON. U ziet elke instelling met de huidige waarde, ook de instellingen die u nooit hebt gewijzigd. U kunt instellingen verfijnen die niet beschikbaar zijn in de andere secties, zoals het AI-model, het stemgedrag en de gespreksafhandeling.

Expertmodus openen

Ga in het Dashboard naar AI Voice Agents > Agenten en open uw VoiceAgent.
Klik in het linkermenu onder Bouwen op Geavanceerd.

De sectie Geavanceerd van een VoiceAgent, met het paneel Configuratie dat de volledige JSON toont en de statusbalk Geen problemen

Het paneel Configuratie toont de volledige configuratie. Daarboven kunt u ook de AI Composer in gewone woorden vragen om wijzigingen voor u door te voeren.

Wat u ziet

Elke instelling, met de waarde ervan. Instellingen die u niet hebt gewijzigd, tonen hun standaardwaarde, zodat u alles ziet wat u kunt verfijnen. U hoeft niet eerst op te slaan om ze te zien.
Instellingen voor elke spraakprovider. elevenLabsSettings en deepgramSettings worden allebei weergegeven, welke provider uw VoiceAgent ook gebruikt.
Een statusbalk boven de JSON. Daarop staat Geen problemen wanneer de configuratie geldig is. Is er iets mis, bijvoorbeeld een niet-ondersteunde waarde, dan ziet u wat u moet oplossen voordat u kunt opslaan.

De configuratie bewerken

Wijzig de gewenste waarden in het paneel Configuratie.
Controleer of de statusbalk Geen problemen aangeeft.
Klik op Opslaan.

Om uw niet-opgeslagen wijzigingen ongedaan te maken, klikt u op Terugzetten. De andere secties (Identiteit, Kennisbank en Vaardigheden en scenario’s) en de sectie Geavanceerd tonen dezelfde configuratie op twee verschillende manieren. Een wijziging in de ene wordt weergegeven in de andere.

Een configuratie naar een andere VoiceAgent kopiëren

Klik in de sectie Geavanceerd op Kopiëren om de volledige configuratie te kopiëren, inclusief de standaardwaarden.
Open de sectie Geavanceerd van de andere VoiceAgent, vervang de configuratie door de gekopieerde en klik op Opslaan.

Omdat de kopie elke instelling bevat, gedraagt de andere VoiceAgent zich precies hetzelfde.

Wijzig de agentName. Elke VoiceAgent heeft een unieke naam nodig.
Koppel accountspecifieke resources opnieuw. Een configuratie kan verwijzen naar zaken die bij uw account horen, zoals kennisbanken, aangepaste tools, telefoonnummers of een agenda-integratie. Kopieert u een configuratie naar een ander account, stel deze daar dan opnieuw in.
Sla de VoiceAgent na een geslaagde import twee keer op. Een bekende reeks randgevallen komt pas na de tweede keer opslaan naar voren.

Naslag van instellingen

Identiteit

JSON-veld	Wat dit instelt
`agentName`	De naam van de VoiceAgent. Moet uniek zijn binnen uw account.
`direction`	Of de agent inkomende of uitgaande oproepen afhandelt: `"inbound"` of `"outbound"`.
`language`	De taal die de VoiceAgent spreekt.
`secondaryLanguages`	Extra talen die de VoiceAgent tijdens een gesprek kan detecteren en waarnaar hij kan overschakelen. Optioneel.
`voice`	De stem die de VoiceAgent gebruikt.
`greeting`	De exacte openingszin die de VoiceAgent aan het begin van een gesprek zegt. Als dit leeg is, gebruiken agents voor inkomende oproepen een algemene standaardzin; agents voor uitgaande oproepen beginnen met stilte.
`startSpeakingFirst`	Of de VoiceAgent als eerste spreekt wanneer het gesprek tot stand komt (`true`), of wacht op de beller (`false`).
`defaultOutboundNumberId`	Het telefoonnummer waarmee de VoiceAgent belt.
`failoverOutboundNumberId`	Een reservenummer om mee te bellen als het standaardnummer niet kan worden gebruikt.

Kennis en gedrag

JSON-veld	Wat dit instelt
`knowledgeBaseIds`	De kennisbanken die de VoiceAgent kan raadplegen bij het beantwoorden van vragen.
`goalPrompt`	De kerninstructies die het gedrag van de VoiceAgent tijdens een gesprek bepalen.
`skills`	Gestructureerde mogelijkheden, bijvoorbeeld `takeMessage` en `extractData`. Elke vaardigheid heeft `enabled` en eigen instellingen.
`scenarios`	Hoe de VoiceAgent reageert op specifieke situaties. Elk scenario heeft `when`, `reply` en optioneel een `action`, zoals `"hangup"`.
`guardrails`	Vaste antwoorden voor situaties die ongeacht de context een consistent antwoord vereisen.

In skills.extractData.properties heeft elke eigenschap een unieke name nodig. Als twee eigenschappen dezelfde naam hebben, wordt de configuratie niet opgeslagen.

Gespreksstijl

Deze twee velden bepalen hoe de VoiceAgent spreekt.

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"`. 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"`. 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.

AI-model

Veld	Wat dit instelt
`llm`	Het AI-model dat de VoiceAgent gebruikt. Zie de lijst met ondersteunde modellen hieronder.
`provider`	De spraakprovider: `"elevenlabs"` of `"deepgram"`. In de meeste gevallen bepaalt de taal de provider automatisch.
`temperature`	Hoe gevarieerd de reacties van de VoiceAgent zijn, van `0.0` tot `1.0`. Voor professionele of gestructureerde agents wordt `0.1` tot `0.3` aanbevolen.

Ondersteunde modellen voor llm

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`	Hoe consistent de stem van de VoiceAgent tijdens het gesprek klinkt. Hogere waarden zorgen voor een stabielere stem.	`0.0`–`1.0`
`similarity`	Hoe nauw de stem overeenkomt met het oorspronkelijke stemmodel.	`0.0`–`1.0`
`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`: dat schakelt tekstnormalisatie uit, waardoor cijfers en datums verkeerd worden uitgesproken.	`0`–`4`

Gespreksgedrag

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

ElevenLabs-instellingen

Deze instellingen zijn van toepassing wanneer uw VoiceAgent ElevenLabs gebruikt, de standaard voor de meeste talen. Ze staan binnen het object elevenLabsSettings, niet op het hoofdniveau van de configuratie.

Veld	Wat dit instelt	Waarden
`speculativeTurn`	De VoiceAgent begint met het opstellen van zijn antwoord voordat de beller is uitgesproken, waardoor de responstijd afneemt.	`true` / `false`
`turnEagerness`	Hoe snel de VoiceAgent het woord neemt wanneer de beller pauzeert.	`"patient"` / `"normal"` / `"eager"`
`turnModel`	De versie van het 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, zoals productnamen of technische termen.	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
`interruptionIgnoreTermLanguages`	De talen waarin de negeertermen worden herkend.	Lijst met taalcodes
`backgroundSound`	Een achtergrondgeluid onder de spraak van de VoiceAgent. `null` betekent geen geluid.	`null`, of een object: `preset` (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)

Voorbeeld:

"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 u opslaat, vervangt het elevenLabsSettings-object dat u verzendt het opgeslagen object. Om één instelling te wissen, verwijdert u deze uit het object.

Deepgram-instellingen

deepgramSettings bevat de instellingen voor VoiceAgents die Deepgram gebruiken. Het is leeg wanneer er niets in te stellen is.

Beheerd door CloudTalk

minorVersion en hashes worden beheerd door CloudTalk. Laat ze ongewijzigd.

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

Expertmodus openen

Wat u ziet

De configuratie bewerken

Een configuratie naar een andere VoiceAgent kopiëren

Naslag van instellingen

Identiteit

Kennis en gedrag

Gespreksstijl

AI-model

Stem finetunen

Gespreksgedrag

ElevenLabs-instellingen

Deepgram-instellingen

Beheerd door CloudTalk

​Expertmodus openen

​Wat u ziet

​De configuratie bewerken

​Een configuratie naar een andere VoiceAgent kopiëren

​Naslag van instellingen

​Identiteit

​Kennis en gedrag

​Gespreksstijl

​AI-model

​Stem finetunen

​Gespreksgedrag

​ElevenLabs-instellingen

​Deepgram-instellingen

​Beheerd door CloudTalk

Expertmodus openen

Wat u ziet

De configuratie bewerken

Een configuratie naar een andere VoiceAgent kopiëren

Naslag van instellingen

Identiteit

Kennis en gedrag

Gespreksstijl

AI-model

Stem finetunen

Gespreksgedrag

ElevenLabs-instellingen

Deepgram-instellingen

Beheerd door CloudTalk