Überschreibungen

Überschreibungen ermöglichen es Ihrem Assistenten, sein Verhalten an jede Nutzerinteraktion anzupassen. Sie können zu Beginn jeder Unterhaltung benutzerdefinierte Daten und Einstellungen übergeben, damit der Assistent seine Antworten und sein Wissen mit Echtzeitkontext personalisiert. Überschreibungen ersetzen die im Dashboard des 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)
• Tools
• Wissensdatenbank
• Nur-Text-Modus
• Stabilität
• Geschwindigkeit
• Ähnlichkeitsverstärkung
• ASR-Schlüsselwörter
• Prozeduren

Die Überschreibung Prozeduren verwendet nicht conversation_config_override. Stattdessen übergibt der Client procedure_ids und start_procedure_ids auf oberster Ebene der Clientdaten zur Gesprächsinitialisierung. Siehe Prozeduren 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 im Dashboard des Agenten definierten Standardwerte. Für die meisten Felder wird ein Fehler ausgegeben, wenn eine Überschreibung angegeben wird, obwohl Überschreibungen für dieses Feld nicht aktiviert sind.

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-Unternehmensnamen) über ASR-Schlüsselwörter

Anleitung

Voraussetzungen

• Ein ElevenLabs-Konto
• Ein konfigurierter ElevenLabs-Konversationsagent (hier erstellen)

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

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

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