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

# Overschrijvingen

> **Warning**
>
> Hoewel overschrijvingen nog steeds worden ondersteund om system prompts of eerste berichten volledig te vervangen, raden we aan om [dynamische variabelen](/docs/nl/eleven-agents/customization/personalization/dynamic-variables) te gebruiken als voorkeursmethode om de reacties van je agent aan te passen en realtimegegevens in te voegen. Dynamische variabelen zijn beter onderhoudbaar en bieden een meer gestructureerde aanpak voor personalisatie.

Met **overschrijvingen** kan je assistent zijn gedrag aanpassen aan elke gebruikersinteractie. Je kunt aan het begin van elk gesprek aangepaste gegevens en instellingen doorgeven, zodat de assistent zijn reacties en kennis kan personaliseren met realtime context. Overschrijvingen vervangen de standaardwaarden van de agent die zijn ingesteld in het [dashboard](https://elevenlabs.io/app/agents/agents) van de agent volledig.

## Overzicht

Met overschrijvingen kun je het gedrag van je AI-agent realtime aanpassen zonder meerdere agents te maken. Zo kun je reacties personaliseren met gebruikersspecifieke gegevens.

Overschrijvingen kunnen worden ingeschakeld voor de volgende velden in de beveiligingsinstellingen van de agent:

* System prompt
* Eerste bericht
* Taal
* Stem-ID
* LLM (Large Language Model)
* Tools
* Kennisbank
* Alleen-tekstmodus
* Stabiliteit
* Snelheid
* Similarity boost
* ASR-keywords

Wanneer overschrijvingen voor een veld zijn ingeschakeld, blijft het opgeven van een overschrijving optioneel. Als je niets opgeeft, gebruikt de agent de standaardwaarden die zijn ingesteld in het [dashboard](https://elevenlabs.io/app/agents/agents) van de agent. Voor de meeste velden wordt een fout gegenereerd als je een overschrijving opgeeft terwijl overschrijvingen voor dat veld niet zijn ingeschakeld.

> **Warning**
>
> **ASR-keywords** gebruiken soft disallow: als de schakelaar voor Security uit staat en de client toch
> `asr.keywords` verstuurt, gaat het gesprek door en worden de keywords genegeerd (geen fout). Schakel de
> overschrijving voor **ASR-keywords** in bij de beveiligingsinstellingen wanneer je keywordboosting per gesprek wilt
> toepassen. Per gesprek worden maximaal 50 keywords ondersteund.

Hier zijn enkele voorbeelden waarin overschrijvingen nuttig kunnen zijn:

* **Begroet gebruikers** met hun naam
* **Neem accountspecifieke gegevens op** in reacties
* **Pas de taal** of toon van de agent aan op basis van gebruikersvoorkeuren
* **Geef realtimegegevens door**, zoals rekeningsaldi of bestelstatus
* **Verbeter transcriptie** van namen of termen per gesprek (bijvoorbeeld bedrijfsnamen uit CRM) via ASR-keywords

> **Info**
>
> Overschrijvingen zijn vooral nuttig voor applicaties die gepersonaliseerde interacties vereisen of gevoelige
> gebruikersgegevens verwerken die niet in de basisconfiguratie van de agent mogen worden opgeslagen.

## Handleiding

### Vereisten

* Een [ElevenLabs-account](https://elevenlabs.io)
* Een geconfigureerde ElevenLabs Conversational Agent ([maak er hier een](/docs/nl/eleven-agents/quickstart))

In deze handleiding zie je hoe je de standaardwaarden voor **System prompt**, **Eerste bericht**, **LLM**, **Tools**, **Kennisbank**, **TTS-instellingen** en **ASR-keywords** van de agent overschrijft.

#### Overschrijvingen inschakelen

Om veiligheidsredenen zijn overschrijvingen standaard uitgeschakeld. Schakel de velden in die je wilt laten overschrijven, zoals `first_message`, `prompt.prompt`, `prompt.tool_ids`, `prompt.knowledge_base`, `language` of `asr.keywords`.

#### Bijwerken via het dashboard

Ga naar de instellingen van je agent en selecteer het tabblad **Security**. Schakel `First message`, `System prompt`, `Tools`, `Knowledge base`, `ASR keywords` en alle andere overschrijvingen in die je nodig hebt, zoals `LLM`.

![Overschrijvingen inschakelen](/docs/_fern-img/496f20380ffe29fc46275bbfe5c6eaabdb5e211c780188243a018b38715ea779.webp)

#### Bijwerken via de CLI

#### De agentconfiguratie ophalen

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

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

Stel velden onder `platform_settings.overrides.conversation_config_override` in op `true` om runtime-overschrijvingen voor dat veld toe te staan:

```json
{
  "platform_settings": {
    "overrides": {
      "conversation_config_override": {
        "agent": {
          "first_message": true,
          "language": true,
          "prompt": {
            "prompt": true,
            "tool_ids": true,
            "knowledge_base": true
          }
        },
        "tts": { "voice_id": true },
        "asr": { "keywords": true }
      }
    }
  }
}
```

#### 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",
    platform_settings={
        "overrides": {
            "conversation_config_override": {
                "agent": {
                    "first_message": True,
                    "language": True,
                    "prompt": {
                        "prompt": True,
                        "tool_ids": True,
                        "knowledge_base": True,
                    },
                },
                "tts": {"voice_id": True},
                "asr": {"keywords": True},
            },
        },
    },
)
```

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

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  platformSettings: {
    overrides: {
      conversationConfigOverride: {
        agent: {
          firstMessage: true,
          language: true,
          prompt: {
            prompt: true,
            toolIds: true,
            knowledgeBase: true,
          },
        },
        tts: { voiceId: true },
        asr: { keywords: true },
      },
    },
  },
});
```

#### Het gesprek overschrijven

Geef in je code, waar het gesprek wordt gestart, de overschrijvingen door als parameter. Overschrijvingen voor tools en de kennisbank vervangen de standaardarrays voor dat gesprek. Overschrijvingen voor ASR-keywords vervangen de standaardkeywordlijst van de agent voor dat gesprek (maximaal 50 keywords).

**`Payload voor gespreksstart`**

```json title="Payload voor gespreksstart" focus={4-15}
{
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "tool_ids": ["tool_7101k5zvyjhmfg983brhmhkd98n6"],
        "knowledge_base": [
          {
            "type": "file",
            "name": "Unladen Swallow Facts",
            "id": "5xM3yVvZQKV0EfqQpLrJ",
            "usage_mode": "auto"
          }
        ]
      }
    },
    "asr": {
      "keywords": ["Acme Corp", "Contoso", "Globex"]
    }
  }
}
```

> **Tip**
>
> Zorg dat je de nieuwste [SDK](/docs/nl/eleven-agents/libraries/python) hebt geïnstalleerd.

**`Python`**

```python title="Python" focus={3-28} maxLines=28
from elevenlabs.conversational_ai.conversation import Conversation, ConversationInitiationData
...
conversation_override = {
    "agent": {
        "prompt": {
            "prompt": f"The customer's bank account balance is {customer_balance}. They are based in {customer_location}.", # Optional: override the system prompt.
            "llm": "gpt-4o", # Optional: override the LLM model.
            "tool_ids": [
                "tool_7101k5zvyjhmfg983brhmhkd98n6"
            ], # Optional: replace the tools available to the agent.
            "knowledge_base": [
                {
                    "type": "file",
                    "name": "Unladen Swallow Facts",
                    "id": "5xM3yVvZQKV0EfqQpLrJ",
                    "usage_mode": "auto",
                }
            ], # Optional: replace the knowledge base available to the agent.
        },
        "first_message": f"Hi {customer_name}, how can I help you today?", # Optional: override the first_message.
        "language": "en" # Optional: override the language.
    },
    "tts": {
        "voice_id": "custom_voice_id", # Optional: override the voice.
        "stability": 0.7, # Optional: override stability (0.0 to 1.0).
        "speed": 1.1, # Optional: override speed (0.7 to 1.2).
        "similarity_boost": 0.9 # Optional: override similarity boost (0.0 to 1.0).
    },
    "conversation": {
        "text_only": True # Optional: enable text-only mode (no audio).
    },
    "asr": {
        "keywords": ["Acme Corp", "Contoso"] # Optional: boost ASR for per-call terms (max 50). Requires Security → ASR keywords.
    }
}

config = ConversationInitiationData(
    conversation_config_override=conversation_override
)
conversation = Conversation(
    ...
    config=config,
    ...
)
conversation.start_session()
```

**`JavaScript`**

```javascript title="JavaScript" focus={4-29} maxLines=29
...
const conversation = await Conversation.startSession({
  ...
  overrides: {
      agent: {
          prompt: {
              prompt: `The customer's bank account balance is ${customer_balance}. They are based in ${customer_location}.`, // Optional: override the system prompt.
              llm: "gpt-4o", // Optional: override the LLM model.
              toolIds: [
                  "tool_7101k5zvyjhmfg983brhmhkd98n6"
              ], // Optional: replace the tools available to the agent.
              knowledgeBase: [
                  {
                      type: "file",
                      name: "Unladen Swallow Facts",
                      id: "5xM3yVvZQKV0EfqQpLrJ",
                      usageMode: "auto",
                  }
              ], // Optional: replace the knowledge base available to the agent.
          },
          firstMessage: `Hi ${customer_name}, how can I help you today?`, // Optional: override the first message.
          language: "en" // Optional: override the language.
      },
      tts: {
          voiceId: "custom_voice_id", // Optional: override the voice.
          stability: 0.7, // Optional: override stability (0.0 to 1.0).
          speed: 1.1, // Optional: override speed (0.7 to 1.2).
          similarityBoost: 0.9 // Optional: override similarity boost (0.0 to 1.0).
      },
      conversation: {
          textOnly: true // Optional: enable text-only mode (no audio).
      },
      asr: {
          keywords: ["Acme Corp", "Contoso"] // Optional: boost ASR for per-call terms (max 50). Requires Security → ASR keywords.
      }
  },
  ...
})
```

**`Swift`**

```swift title="Swift" focus={3-16} maxLines=16
import ElevenLabsSDK

let promptOverride = ElevenLabsSDK.AgentPrompt(
    prompt: "The customer's bank account balance is \(customer_balance). They are based in \(customer_location).", // Optional: override the system prompt.
    llm: "gpt-4o" // Optional: override the LLM model.
)
let agentConfig = ElevenLabsSDK.AgentConfig(
    prompt: promptOverride, // Optional: override the system prompt.
    firstMessage: "Hi \(customer_name), how can I help you today?", // Optional: override the first message.
    language: .en // Optional: override the language.
)
let ttsConfig = ElevenLabsSDK.TTSConfig(
    voiceId: "custom_voice_id", // Optional: override the voice.
    stability: 0.7, // Optional: override stability (0.0 to 1.0).
    speed: 1.1, // Optional: override speed (0.7 to 1.2).
    similarityBoost: 0.9 // Optional: override similarity boost (0.0 to 1.0).
)
let conversationConfig = ElevenLabsSDK.ConversationConfig(
    textOnly: true // Optional: enable text-only mode (no audio).
)
let overrides = ElevenLabsSDK.ConversationConfigOverride(
    agent: agentConfig, // Optional: override agent settings.
    tts: ttsConfig, // Optional: override TTS settings.
    conversation: conversationConfig // Optional: override conversation settings.
)

let config = ElevenLabsSDK.SessionConfig(
    agentId: "",
    overrides: overrides
)

let conversation = try await ElevenLabsSDK.Conversation.startSession(
  config: config,
  callbacks: callbacks
)
```

**`Widget`**

```html title="Widget"
  <elevenlabs-convai
    agent-id="agent_7101k5zvyjhmfg983brhmhkd98n6"
    override-language="es"         <!-- Optional: override the language -->
    override-prompt="Custom system prompt for this user"  <!-- Optional: override the system prompt -->
    override-first-message="Hi! How can I help you today?"  <!-- Optional: override the first message -->
    override-voice-id="custom_voice_id"  <!-- Optional: override the voice -->
  ></elevenlabs-convai>
```

> **Note**
>
> Laat bij het gebruik van overschrijvingen velden die je niet wilt overschrijven weg, in plaats van ze in te stellen op lege strings of null-waarden. Neem alleen de velden op die je specifiek wilt aanpassen.

> **Tip**
>
> Raadpleeg de [Agent API-referentie](/docs/nl/api-reference/agents/create#request.body.conversation_config.agent.prompt.llm) om de juiste LLM-modelstring te vinden. Daar vind je alle ondersteunde LLM-modellen en hun exacte string-ID's.