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

# Überschreibungen

> **Warning**
>
> Obwohl Overrides weiterhin unterstützt werden, um System-Prompts oder erste Nachrichten vollständig zu ersetzen, empfehlen wir
> [dynamische Variablen](/docs/de/eleven-agents/customization/personalization/dynamic-variables) als bevorzugte Methode,
> um die Antworten Ihres Agenten anzupassen und Echtzeitdaten einzufügen. Dynamische Variablen bieten eine bessere
> Wartbarkeit und einen strukturierteren Ansatz zur Personalisierung.

Mit **Overrides** kann Ihr Assistent sein Verhalten für jede Nutzerinteraktion anpassen. Sie können zu Beginn jeder Unterhaltung benutzerdefinierte Daten und Einstellungen übergeben, sodass der Assistent seine Antworten und sein Wissen mit Echtzeitkontext personalisieren kann. Overrides überschreiben die im [Dashboard](https://elevenlabs.io/app/agents/agents) des Agenten definierten Standardwerte vollständig.

## Überblick

Mit Overrides können Sie das Verhalten Ihres KI-Agenten in Echtzeit ändern, ohne mehrere Agenten zu erstellen. So können Sie Antworten mit nutzerspezifischen Daten personalisieren.

Overrides können für die folgenden Felder in den Sicherheitseinstellungen des Agenten aktiviert werden:

* System-Prompt
* Erste Nachricht
* Sprache
* Voice-ID
* LLM (Large Language Model)
* Tools
* Wissensdatenbank
* Nur-Text-Modus
* Stabilität
* Geschwindigkeit
* Ähnlichkeitsverstärkung
* ASR-Schlüsselwörter

Wenn Overrides für ein Feld aktiviert sind, ist die Angabe eines Overrides weiterhin optional. Wenn Sie keinen angeben, verwendet der Agent die im [Dashboard](https://elevenlabs.io/app/agents/agents) des Agenten definierten Standardwerte. Bei den meisten Feldern wird ein Fehler ausgelöst, wenn ein Override angegeben wird, obwohl für dieses Feld keine Overrides aktiviert sind.

> **Warning**
>
> Für **ASR-Schlüsselwörter** gilt eine weiche Sperre: Wenn der Security-Schalter deaktiviert ist und der Client dennoch
> `asr.keywords` sendet, wird die Unterhaltung fortgesetzt und die Schlüsselwörter werden ignoriert
> (ohne Fehler). Aktivieren Sie den Override für **ASR-Schlüsselwörter** in den Sicherheitseinstellungen, wenn die
> Schlüsselwortverstärkung pro Unterhaltung angewendet werden soll. Pro Unterhaltung werden bis zu 50 Schlüsselwörter unterstützt.

Hier sind einige Beispiele, in denen Overrides nützlich sein können:

* **Begrüßen Sie Nutzer** mit ihrem Namen
* **Fügen Sie kontospezifische Details** in Antworten ein
* **Passen Sie die Sprache** oder den Ton des Agenten anhand von Nutzerpräferenzen an
* **Übergeben Sie Echtzeitdaten** wie Kontostände oder Bestellstatus
* **Verbessern Sie die Transkription** von Namen oder Begriffen pro Anruf (z. B. CRM-Unternehmensnamen) über ASR-Schlüsselwörter

> **Info**
>
> Overrides sind besonders nützlich für Anwendungen, die personalisierte Interaktionen erfordern oder sensible Nutzerdaten verarbeiten,
> die nicht in der Basiskonfiguration des Agenten gespeichert werden sollten.

## Anleitung

### Voraussetzungen

* Ein [ElevenLabs-Konto](https://elevenlabs.io)
* Ein konfigurierter ElevenLabs Conversational Agent ([hier erstellen](/docs/de/eleven-agents/quickstart))

Diese Anleitung zeigt, wie Sie den standardmäßigen **System-Prompt**, die **erste Nachricht**, das **LLM**, **Tools**, die **Wissensdatenbank**, **TTS-Einstellungen** und **ASR-Schlüsselwörter** überschreiben.

#### Overrides aktivieren

Aus Sicherheitsgründen sind Overrides standardmäßig deaktiviert. Aktivieren Sie die Felder, für die Sie Overrides zulassen möchten, z. B. `first_message`, `prompt.prompt`, `prompt.tool_ids`, `prompt.knowledge_base`, `language` oder `asr.keywords`.

#### Über das Dashboard aktualisieren

Navigieren Sie zu den Einstellungen Ihres Agenten und wählen Sie den Tab **Security** aus. Aktivieren Sie `First message`, `System prompt`, `Tools`, `Knowledge base`, `ASR keywords` und alle weiteren benötigten Overrides, z. B. `LLM`.

![Overrides aktivieren](/docs/_fern-img/496f20380ffe29fc46275bbfe5c6eaabdb5e211c780188243a018b38715ea779.webp)

#### Über die CLI aktualisieren

#### Agentenkonfiguration abrufen

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

#### \`agent_configs/\<agent-name>.json\` bearbeiten

Setzen Sie Felder unter `platform_settings.overrides.conversation_config_override` auf `true`, um Laufzeit-Overrides für dieses Feld zuzulassen:

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

#### Änderungen übertragen

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

#### Über die API aktualisieren

```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 },
      },
    },
  },
});
```

#### Unterhaltung überschreiben

Übergeben Sie in Ihrem Code an der Stelle, an der die Unterhaltung gestartet wird, die Overrides als Parameter. Tool- und Wissensdatenbank-Overrides ersetzen die Standard-Arrays für diese Unterhaltung. ASR-Schlüsselwort-Overrides ersetzen die Standard-Schlüsselwortliste des Agenten für diese Unterhaltung (maximal 50 Schlüsselwörter).

**`Conversation initiation payload`**

```json title="Conversation initiation payload" 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**
>
> Stellen Sie sicher, dass Sie das neueste [SDK](/docs/de/eleven-agents/libraries/python) installiert haben.

**`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**
>
> Wenn Sie Overrides verwenden, lassen Sie alle Felder weg, die Sie nicht überschreiben möchten, statt sie auf leere Strings oder Nullwerte zu setzen. Fügen Sie nur die Felder ein, die Sie gezielt anpassen möchten.

> **Tip**
>
> Den korrekten LLM-Modell-String finden Sie in der [Agent-API-Referenz](/docs/de/api-reference/agents/create#request.body.conversation_config.agent.prompt.llm), in der alle unterstützten LLM-Modelle und ihre exakten String-IDs aufgeführt sind.