Zur Navigation springen
KonfigurierenPersonalisierung

Überschreibungen

Passen Sie jede Unterhaltung mit personalisiertem Kontext für jeden Nutzer an.

Überschreibungen werden weiterhin unterstützt, um System Prompts oder erste Nachrichten vollständig zu ersetzen. Wir empfehlen jedoch dynamische Variablen als bevorzugte Methode, die Antworten Ihres Agenten anzupassen und Echtzeitdaten einzufügen. Dynamische Variablen sind wartungsfreundlicher und bieten einen strukturierteren Ansatz zur Personalisierung.

Mit Überschreibungen kann Ihr Assistent sein Verhalten an jede Nutzerinteraktion anpassen. Sie können zu Beginn jeder Unterhaltung benutzerdefinierte Daten und Einstellungen übergeben. So kann der Assistent seine Antworten und sein Wissen mit Echtzeitkontext personalisieren. Überschreibungen ersetzen die in der Dashboard Ihres Agenten definierten Standardwerte vollständig.

Überblick

Mit Überschreibungen 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.

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

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

Die Überschreibung für Verfahren verwendet nicht conversation_config_override. Stattdessen übergibt der Client procedure_ids und start_procedure_ids auf oberster Ebene der Clientdaten zur Gesprächsinitiierung. Siehe Verfahren pro Unterhaltung auswählen.

Wenn Überschreibungen für ein Feld aktiviert sind, ist die Angabe einer Überschreibung weiterhin optional. Wird keine angegeben, verwendet der Agent die in der Dashboard des Agenten definierten Standardwerte. Für die meisten Felder wird ein Fehler ausgegeben, wenn eine Überschreibung angegeben wird, obwohl für dieses Feld keine Überschreibungen aktiviert sind.

Für ASR-Schlüsselwörter gilt eine weiche Sperre: Wenn der Sicherheitsschalter deaktiviert ist und der Client dennoch asr.keywords sendet, wird die Unterhaltung fortgesetzt und die Schlüsselwörter werden ignoriert (kein Fehler). Aktivieren Sie die Überschreibung 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.

Der Reasoning-Aufwand muss eine vom LLM des Agenten unterstützte Stufe sein. Andernfalls startet die Unterhaltung nicht und die Verbindung wird mit einem Fehler geschlossen, der die nicht unterstützte Stufe nennt. Wenn der Sicherheitsschalter deaktiviert ist, wird prompt.reasoning_effort ignoriert und der gespeicherte Reasoning-Aufwand des Agenten verwendet. Der Wert gilt für die gesamte Unterhaltung und kann nach ihrem Start nicht geändert werden.

Hier sind einige Beispiele, in denen Überschreibungen 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 an die Nutzerpräferenzen an
  • Übergeben Sie Echtzeitdaten wie Kontostände oder Bestellstatus
  • Verbessern Sie die Transkription von Namen oder Begriffen pro Anruf (z. B. CRM-Firmennamen) über ASR-Schlüsselwörter

Überschreibungen 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

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

1

Überschreibungen aktivieren

Aus Sicherheitsgründen sind Überschreibungen standardmäßig deaktiviert. Aktivieren Sie die Felder, für die Sie Überschreibungen zulassen möchten, etwa first_message, prompt.prompt, prompt.reasoning_effort, prompt.tool_ids, prompt.knowledge_base, language oder asr.keywords.

Öffnen Sie die Einstellungen Ihres Agenten und wählen Sie den Tab Security. Aktivieren Sie First message, System prompt, Tools, Knowledge base, ASR keywords und alle weiteren benötigten Überschreibungen, etwa LLM oder Reasoning effort.

Überschreibungen aktivieren

2

Unterhaltung überschreiben

Übergeben Sie die Überschreibungen in Ihrem Code beim Starten der Unterhaltung als Parameter. Überschreibungen für Tools und Wissensdatenbanken ersetzen die Standard-Arrays für diese Unterhaltung. Überschreibungen für ASR-Schlüsselwörter ersetzen die Standardliste der Schlüsselwörter des Agenten für diese Unterhaltung (maximal 50 Schlüsselwörter).

Payload zur Gesprächsinitiierung
{
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "reasoning_effort": "high",
        "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 aktuelle 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.
            "reasoning_effort": "high", # Optional: override the reasoning effort. Requires Security → Reasoning effort.
            "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 Überschreibungen verwenden, lassen Sie 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.

Die korrekte LLM-Modellzeichenfolge finden Sie in der Agent-API-Referenz. Dort sind alle unterstützten LLM-Modelle und ihre exakten String-Identifikatoren aufgeführt.