> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Gespreksstroom

## Overzicht

Instellingen voor de gespreksflow bepalen hoe je assistent omgaat met stiltes van gebruikers, onderbrekingen tijdens het spreken en beurtgedrag. Deze instellingen helpen natuurlijkere gesprekken te creëren en kunnen worden aangepast aan je use case.

#### [Maximale gespreksduur](#maximum-conversation-duration)

Beperk de totale duur van elk gesprek

#### [Beurt nemen na stilte](#turn-timeout)

Stel in hoelang je assistent wacht tijdens stiltes

#### [Zachte timeout](#soft-timeout)

Geef natuurlijke audiofeedback wanneer je agent tijd nodig heeft om na te denken

#### [Onderbrekingen](#interruptions)

Bepaal of gebruikers je assistent kunnen onderbreken terwijl deze spreekt

#### [Beurtbereidheid](#turn-eagerness)

Pas aan hoe snel je assistent reageert op gebruikersinvoer

## Maximale gespreksduur

De instelling **Max conversation duration** beperkt de totale tijd dat een gesprek actief kan blijven.
Deze algemene limiet begint wanneer het gesprek start en geldt onafhankelijk van time-outs
op beurtniveau. De standaardwaarde is 600 seconden (10 minuten). Je kunt een waarde instellen van 60 tot 7.200 seconden.

### Configuratie

Configureer deze instelling in de CLI en API met het veld
`conversation_config.conversation.max_duration_seconds`.

#### Bijwerken via het dashboard

Open je agent in het dashboard, ga naar het tabblad **Advanced** en pas **Max conversation
duration** aan onder \*\*Call limits \*\*. Sla je wijzigingen op.

#### Bijwerken via de CLI

#### Agentconfiguratie ophalen

```bash
elevenlabs agents pull --agent agent_7101k5zvyjhmfg983brhmhkd98n6
```

#### Agentconfiguratie bewerken

Stel `conversation_config.conversation.max_duration_seconds` in:

```json
{
  "conversation_config": {
    "conversation": {
      "max_duration_seconds": 1200
    }
  }
}
```

#### Agentconfiguratie pushen

```bash
elevenlabs agents push --agent agent_7101k5zvyjhmfg983brhmhkd98n6
```

#### Bijwerken via de API

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "conversation": {"max_duration_seconds": 1200},
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    conversation: { maxDurationSeconds: 1200 },
  },
});
```

> **Warning**
>
> WhatsApp-berichtgesprekken hebben standaard een time-out van 15 minuten bij inactiviteit, gemeten vanaf de
> meest recente reactie van de agent. Deze time-out kan een berichtgesprek beëindigen vóór de geconfigureerde
> maximale duur. Enterprise-klanten die voor hun use case een andere time-out nodig hebben, kunnen contact opnemen met
> support via [support@elevenlabs.io](mailto:support@elevenlabs.io).

## Beurt nemen na stilte

De instelling **Take turn after silence** bepaalt hoelang je assistent tijdens stiltes van gebruikers wacht voordat deze de volgende beurt neemt en om een reactie vraagt.

### Configuratie

De waarde wordt opgegeven in seconden en moet tussen 1 en 30 seconden liggen. Configureer deze instelling in de CLI en API met het veld `conversation_config.turn.turn_timeout`.

#### Bijwerken via het dashboard

Open je agent in het dashboard, ga naar het tabblad **Advanced** en pas de waarde **Take turn after silence** aan. Sla je wijzigingen op.

![Instelling voor beurt nemen na stilte](/docs/_fern-img/9de7653a0940ae3441b3470c2af53f4a72294ad3680946d4c3fa3b91df69c566.webp)

#### Bijwerken via de CLI

#### Agentconfiguratie ophalen

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### \`agent\_configs/\<agent-name>.json\` bewerken

Stel `conversation_config.turn.turn_timeout` in:

```json
{
  "conversation_config": {
    "turn": {
      "turn_timeout": 7
    }
  }
}
```

#### Je wijzigingen pushen

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### Bijwerken via de API

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "turn": {"turn_timeout": 7},
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    turn: { turnTimeout: 7 },
  },
});
```

> **Note**
>
> Kies een geschikte time-outduur op basis van je use case. Kortere time-outs zorgen voor responsievere
> gesprekken, maar kunnen gebruikers onderbreken die meer tijd nodig hebben om te reageren, waardoor het gesprek minder
> natuurlijk aanvoelt.

### Best practices

* Stel kortere time-outs in (5-10 seconden) voor informele gesprekken waarin snelle uitwisseling wordt verwacht
* Gebruik langere time-outs (10-30 seconden) wanneer gebruikers mogelijk meer tijd nodig hebben om na te denken of complexe reacties te formuleren
* Houd rekening met de context van je gebruiker: klantenservice kan baat hebben bij kortere time-outs, terwijl technische support mogelijk langere nodig heeft

## Zachte timeout

Een zachte timeout geeft direct audiofeedback wanneer de LLM langer dan verwacht nodig heeft om een reactie te genereren. In plaats van een ongemakkelijke stilte tijdens het wachten, spreekt je agent een korte opvulzin uit zoals "Hmm..." of "Even nadenken..." om de natuurlijke gespreksflow te behouden.

Deze functie is nuttig voor:

* Complexe vragen die langere LLM-verwerking vereisen
* Het afhandelen van variabele latentie van LLM-providers
* Natuurlijkere, menselijkere gesprekken creëren met natuurlijke denkpauzes

### Zo werkt het

1. Wanneer de gebruiker is uitgesproken, begint het systeem een LLM-reactie te genereren
2. Er start een timer op basis van de geconfigureerde time-outduur
3. Als de LLM-reactie **vóór** de time-out binnenkomt, wordt er geen opvultekst uitgesproken
4. Als de time-out wordt bereikt **voordat** de LLM reageert:
   * Wordt het geconfigureerde opvulbericht direct uitgesproken
   * Blijft de agent wachten op de daadwerkelijke reactie
   * Spreekt de agent, zodra deze klaar is, de volledige LLM-reactie uit

De zachte timeout wordt slechts één keer per beurt geactiveerd om meerdere opeenvolgende opvulteksten te voorkomen.

### Configuratie

#### Bijwerken via het dashboard

Open je agent in het dashboard, ga naar het tabblad **Advanced** en pas de instellingen voor **Soft timeout** aan. Sla je wijzigingen op.

![Instellingen voor zachte timeout](/docs/_fern-img/7fdaca49ad50e6bc1f09f5eac46e36f0f4b071c5477e061a62791df9e100be75.webp)

#### Bijwerken via de CLI

#### Agentconfiguratie ophalen

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### \`agent\_configs/\<agent-name>.json\` bewerken

Stel `conversation_config.turn.soft_timeout_config` in:

```json
{
  "conversation_config": {
    "turn": {
      "soft_timeout_config": {
        "timeout_seconds": 3.0,
        "message": "Hhmmmm...yeah.",
        "use_llm_generated_message": false
      }
    }
  }
}
```

#### Je wijzigingen pushen

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### Bijwerken via de API

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "turn": {
            "soft_timeout_config": {
                "timeout_seconds": 3.0,
                "message": "Hhmmmm...yeah.",
                "use_llm_generated_message": False,
            },
        },
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    turn: {
      softTimeoutConfig: {
        timeoutSeconds: 3.0,
        message: "Hhmmmm...yeah.",
        useLlmGeneratedMessage: false,
      },
    },
  },
});
```

#### Time-outduur

De tijd in seconden voordat het opvulbericht wordt uitgesproken terwijl op de LLM-reactie wordt gewacht.

| Instelling     | Beschrijving             |
| -------------- | ------------------------ |
| **Standaard**  | `-1` (uitgeschakeld)     |
| **Bereik**     | `0.5` tot `8.0` seconden |
| **Aanbevolen** | `3.0` seconden           |

> **Tip**
>
> Begin met 3,0 seconden—lang genoeg om onnodige opvulteksten bij snelle reacties te voorkomen, kort genoeg om
> ongemakkelijke stiltes te voorkomen.

#### Statisch bericht

Een vooraf gedefinieerde opvulzin die wordt uitgesproken wanneer de zachte timeout wordt geactiveerd.

| Instelling    | Beschrijving       |
| ------------- | ------------------ |
| **Standaard** | `"Hhmmmm...yeah."` |
| **Lengte**    | 1–200 tekens       |

Dit bericht ondersteunt:

* **Taaloverschrijvingen**: Wordt automatisch vertaald naar aanvullende talen die voor je agent zijn geconfigureerd
* **Clientoverschrijvingen**: Kan per gesprek via de SDK worden aangepast

#### Door LLM gegenereerd bericht

Wanneer deze optie is ingeschakeld, wordt met een lichtgewicht LLM dynamisch een contextueel passende opvulzin gegenereerd, in plaats van het statische bericht.

| Instelling    | Beschrijving                                        |
| ------------- | --------------------------------------------------- |
| **Standaard** | `false`                                             |
| **Fallback**  | Gebruikt een statisch bericht als generatie mislukt |

Het systeem gebruikt recente gesprekscontext (maximaal 4 berichten, 1000 tekens) om relevante opvulteksten te genereren zoals "Hmm...", "Ik snap het...", "Begrepen...", "Duidelijk..." of "Oké..."

> **Note**
>
> Een statisch fallback-bericht is nog steeds vereist wanneer je door LLM gegenereerde berichten gebruikt.

### Best practices

* Vermijd tijdsaanduidingen in opvulberichten (bijvoorbeeld "Eén seconde...") omdat de daadwerkelijke reactietijden onvoorspelbaar zijn
* Schakel de zachte timeout uit voor snelle FAQ-bots waarvan reacties consistent snel zijn

## Onderbrekingen

De afhandeling van onderbrekingen bepaalt of gebruikers je assistent kunnen onderbreken terwijl deze spreekt.

### Configuratie

Je kunt instellingen voor onderbrekingen configureren op het tabblad **Advanced** van de agent, onder **Client Events**.

Zorg ervoor dat onderbreking een geselecteerde clientgebeurtenis is om onderbrekingen in te schakelen.

#### Onderbrekingen ingeschakeld

![Onderbreking toegestaan](/docs/_fern-img/1da794be8ea3bfed45d06241ce5db390480cd45d27c0f886943518bd52d76157.webp)

#### Onderbrekingen uitgeschakeld

![Onderbreking genegeerd](/docs/_fern-img/847a2ebcdfff9498501502ab4b568fc498b6995f860a5552177a7883942197ff.webp)

> **Note**
>
> Schakel onderbrekingen uit wanneer de volledige overdracht van informatie cruciaal is, zoals bij juridische
> disclaimers of veiligheidsinstructies.

### Best practices voor onderbrekingen

* Schakel onderbrekingen in voor natuurlijke gespreksflows waarin een dialoog heen en weer wordt verwacht
* Schakel onderbrekingen uit wanneer het afronden van berichten cruciaal is (bijvoorbeeld algemene voorwaarden, veiligheidsinformatie)
* Houd rekening met de context van je use case: klantenservice kan baat hebben bij onderbrekingen, maar informatieoverdracht mogelijk niet

## Beurtbereidheid

Beurtbereidheid bepaalt hoe snel je assistent tijdens een gesprek reageert op gebruikersinvoer. Deze instelling bepaalt hoe snel de assistent beurten neemt en begint te spreken op basis van gedetecteerde spraakpatronen.

### Zo werkt het

De assistent bevat nu twee belangrijke verbeteringen voor natuurlijker beurtgedrag:

1. **Snellere reactiegeneratie** - De assistent begint te spreken nadat deze voldoende woorden en een komma van het taalmodel heeft ontvangen, in plaats van te wachten op volledige zinnen. Dit vermindert latentie en zorgt voor responsievere gesprekken, vooral wanneer de assistent langere reacties heeft.

2. **Configureerbare beurtbereidheid** - Bepaal hoe snel de assistent stiltes of spraakpatronen interpreteert als kansen om te reageren.

### Configuratie

Er zijn drie modi beschikbaar:

* **Gretig** - De assistent reageert snel op gebruikersinvoer en springt bij de eerste gelegenheid in. Het beste voor snelle gesprekken waarin directe reacties belangrijk zijn.
* **Normaal** - Evenwichtig beurtgedrag dat goed werkt voor de meeste gespreksscenario's. De assistent wacht op natuurlijke gesprekspauzes voordat deze reageert.
* **Geduldig** - De assistent wacht langer voordat deze aan de beurt is, waardoor gebruikers meer tijd krijgen om hun gedachten af te ronden. Ideaal voor het verzamelen van gedetailleerde informatie of wanneer gebruikers tijd nodig hebben om reacties te formuleren.

#### Bijwerken via het dashboard

Open je agent in het dashboard, ga naar de instellingen van **Agent** en selecteer de gewenste modus voor beurtbereidheid. Sla je wijzigingen op.

#### Bijwerken via de CLI

#### Agentconfiguratie ophalen

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### \`agent\_configs/\<agent-name>.json\` bewerken

Stel `conversation_config.turn.turn_eagerness` in op `"patient"`, `"normal"`` of `"eager"\`:

```json
{
  "conversation_config": {
    "turn": {
      "turn_eagerness": "normal"
    }
  }
}
```

#### Je wijzigingen pushen

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### Bijwerken via de API

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "turn": {"turn_eagerness": "normal"},
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    turn: { turnEagerness: "normal" },
  },
});
```

> **Note**
>
> Beurtbereidheid is bijzonder krachtig in combinatie met workflows. Je kunt de responsiviteit van de
> assistent dynamisch aanpassen op basis van de context—door deze sneller te laten reageren tijdens een informeel gesprek,
> of langer te laten wachten bij het verzamelen van gevoelige informatie zoals telefoonnummers of e-mailadressen.

### Best practices voor beurtbereidheid

* Gebruik de modus **Gretig** voor klantenservicescenario's waarin snelle reacties de gebruikerservaring verbeteren
* Gebruik de modus **Geduldig** bij het verzamelen van gestructureerde informatie zoals telefoonnummers, adressen of e-mailadressen
* Gebruik de modus **Normaal** als standaard voor algemene gespreksflows
* Combineer met workflows om beurtbereidheid dynamisch aan te passen op basis van de gesprekscontext
* Test verschillende instellingen met je specifieke use case om de optimale balans te vinden

## Aanbevolen configuraties

#### Klantenservice

* Kortere time-outs (5-10 seconden) voor responsieve interacties - Schakel onderbrekingen in zodat
  klanten tussendoor vragen kunnen stellen - **Gretige** beurtbereidheid voor snelle, responsieve
  gesprekken

#### Informatie verzamelen

* Gematigde time-outs (10-15 seconden) zodat gebruikers tijd hebben om informatie te verzamelen - Schakel
  onderbrekingen in voor een natuurlijke gespreksflow - **Geduldige** beurtbereidheid bij het verzamelen van telefoon-
  nummers, adressen of e-mailadressen

#### Juridische disclaimers

* Langere time-outs (15-30 seconden) om complexe reacties mogelijk te maken - Schakel onderbrekingen uit om de
  volledige overdracht van juridische informatie te waarborgen - **Normale** beurtbereidheid om een gelijkmatig tempo te behouden

#### Conversationele EdTech

* Langere time-outs (10-30 seconden) om tijd te geven voor nadenken en het formuleren van reacties - Schakel
  onderbrekingen in zodat studenten tussendoor vragen kunnen stellen - **Geduldige** beurtbereidheid om
  studenten voldoende tijd te geven om te reageren