Konfigurieren

Personalisierung

Erfahren Sie, wie Sie das Verhalten Ihres Agenten mit dynamischen Variablen und Overrides personalisieren.

Überblick

Mit der Personalisierung können Sie das Verhalten Ihres Agenten für jeden einzelnen Nutzer anpassen und natürlichere, kontextrelevante Gespräche führen. ElevenLabs bietet mehrere Ansätze zur Personalisierung:

  1. Dynamische Variablen – Werte zur Laufzeit in Prompts und Nachrichten einfügen
  2. Überschreibungen – System-Prompts oder Nachrichten vollständig ersetzen
  3. Webhooks zur Gesprächsinitiierung – Daten beim Gesprächsstart von Ihrem Server abrufen

Personalisierungsmethoden

Dynamische Variablen

Definieren Sie Laufzeitwerte mit der Syntax {{ var_name }}, um die Nachrichten, System- Prompts und Tools Ihres Agenten zu personalisieren.

Überschreibungen

Ersetzen Sie System-Prompts, erste Nachrichten, Sprache oder Stimmeinstellungen für jedes Gespräch vollständig.

Webhooks zur Gesprächsinitiierung

Rufen Sie dynamische Variablen und Überschreibungen für eingehende Gespräche von Ihrem Server ab.

Datenstruktur für die Gesprächsinitiierung beim Client

Das Objekt conversation_initiation_client_data definiert, was beim Start eines Gesprächs angepasst werden kann. Clients können es direkt senden. Ein Webhook zur Gesprächsinitiierung gibt dasselbe Objekt zurück.

{
  "type": "conversation_initiation_client_data",
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "prompt": "overriding system prompt",
        "llm": "gpt-5.6-luna"
      },
      "first_message": "overriding first message",
      "language": "en"
    },
    "tts": {
      "voice_id": "voice-id-here"
    },
    "conversation": {
      "text_only": false
    },
    "asr": {
      "keywords": ["Acme Corp", "Contoso"]
    }
  },
  "custom_llm_extra_body": {
    "temperature": 0.7,
    "max_tokens": 100
  },
  "dynamic_variables": {
    "string_var": "text value",
    "number_var": 1.2,
    "integer_var": 123,
    "boolean_var": true
  },
  "user_id": "your_custom_user_id",
  "branch_id": "agtbrch_xxxx",
  "environment": "production"
}

Systemdynamische Variablen (mit dem Präfix system__) können nicht in der Client- Initiierungs-Payload gesendet oder überschrieben werden. Nur benutzerdefinierte dynamische Variablen können über das Feld dynamic_variables festgelegt werden.

Webhooks zur Gesprächsinitiierung

Für eingehende Telefonie und Nachrichten kann ElevenAgents diese Initiierungsdaten von Ihrem Server abrufen, statt vom Client. Wenn der Webhook aktiviert ist, sendet ElevenAgents eine POST-Anfrage und übernimmt das JSON, das Sie zurückgeben.

Konfigurieren Sie die Webhook-URL und Header-Secrets in den Agent-Einstellungen. Aktivieren Sie auf dem Tab Sicherheit des Agenten Initiierungs-Client-Daten über einen Webhook abrufen sowie alle Überschreibungsfelder, die Ihre Antwort enthalten kann.

Der Webhook wird für ein neues eingehendes Gespräch über Twilio Voice, Exotel, SIP-Trunk, WhatsApp oder Twilio SMS ausgeführt, wenn noch keine Client-Daten zur Gesprächsinitiierung vorhanden sind.

Ausgehende Anrufe über Twilio Voice, Exotel, SIP und WhatsApp lösen ihn nur aus, wenn die ausgehende Anfrage kein conversation_initiation_client_data enthielt. Ausgehende WhatsApp-Nachrichten lösen ihn nie aus – übergeben Sie stattdessen dynamische Variablen in der ausgehenden Anfrage.

Er wird nicht für Gespräche über Widgets oder SDKs, andere Messaging-Integrationen oder fortgesetzte WhatsApp- und SMS-Threads ausgeführt.

Vorschaugespräche, die über die Seite mit den Agent-Einstellungen gestartet werden, lösen keine Webhooks zur Gesprächsinitiierung aus. Verwenden Sie beim Testen in der Vorschau die Platzhalter für Dynamische Variablen im Agent-Editor. Diese Platzhalter werden in eingehenden Produktionsgesprächen nicht verwendet.

ElevenAgents sendet den Anruferkontext im Anfrage-Body:

{
  "caller_id": "+15551234567",
  "called_number": "+15557654321",
  "agent_id": "agent_7101k5zvyjhmfg983brhmhkd98n6",
  "call_sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "conversation_id": "conv_8901k5zvyjhmfg983brhmhkd98n6"
}

caller_id und called_number sind Telefonnummern bei Twilio, Exotel, SIP und SMS. Bei eingehendem WhatsApp sind sie die WhatsApp-Nutzer-ID und die ID Ihrer WhatsApp-Telefonnummer. Bei ausgehenden Anrufen ist caller_id Ihre Nummer und called_number die Nummer der angerufenen Person. call_sid ist die Call-SID des Anbieters bei Telefonie und eine leere Zeichenfolge bei WhatsApp und SMS. SIP-Anrufe können auch call_id und sip_headers enthalten.

Ihre Antwort muss die oben genannte Struktur conversation_initiation_client_data verwenden. Schließen Sie jede benutzerdefinierte dynamische Variable ein, die der Agent definiert. Überschreibungen sind optional und müssen unter Sicherheit aktiviert sein. Der HTTP-Antwort-Body darf maximal 256 KB (262.144 Byte) groß sein.

Ein fehlgeschlagener Webhook oder ein Timeout kann den Gesprächsstart verhindern. Informationen zur Twilio-Einrichtung finden Sie unter Twilio-Personalisierung. Dieser Webhook ist von Webhooks nach dem Anruf getrennt.

Den richtigen Ansatz wählen

MethodeAm besten geeignet fürImplementierung
Dynamische Variablen
  • Nutzerspezifische Daten in Vorlageninhalte einfügen - Einheitliches Agentenverhalten mit personalisierten Details beibehalten - Tool-Parameter personalisieren
Variablen mit {{ variable_name }} definieren und Werte zur Laufzeit übergeben
Überschreibungen
  • Agentenverhalten je Nutzer vollständig ändern - Sprache oder Stimme wechseln - Legacy- Anwendungen (Migration zu dynamischen Variablen erwägen)

Bestimmte Berechtigungen für Überschreibungen in den Sicherheitseinstellungen aktivieren und vollständige Ersatzinhalte übergeben

Webhooks zur Gesprächsinitiierung
  • Eingehende Twilio-, SIP-, WhatsApp- oder SMS-Gespräche von Ihrem Server personalisieren - Anruferkontext vor dem Gesprächsstart abrufen

Den Webhook in den Sicherheitseinstellungen aktivieren und conversation_initiation_client_data zurückgeben

Mehr erfahren