Überschreibungen | ElevenLabs Documentation

Obwohl Overrides weiterhin unterstützt werden, um System-Prompts oder erste Nachrichten vollständig zu ersetzen, empfehlen wir dynamische Variablen 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 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 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.

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

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
Ein konfigurierter ElevenLabs Conversational Agent (hier erstellen)

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

Über die CLI aktualisieren

Über die API 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.

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

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

Stellen Sie sicher, dass Sie das neueste SDK installiert haben.

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()

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.

Den korrekten LLM-Modell-String finden Sie in der Agent-API-Referenz, in der alle unterstützten LLM-Modelle und ihre exakten String-IDs aufgeführt sind.