Hoppa till navigering
Konfigurera

Personalisering

Lär dig hur du anpassar agentens beteende med dynamiska variabler och åsidosättningar.

Översikt

Med personalisering kan du anpassa agentens beteende för varje enskild användare, vilket möjliggör mer naturliga och kontextuellt relevanta samtal. ElevenLabs erbjuder flera sätt att personalisera:

  1. Dynamiska variabler – Infoga värden vid körning i prompter och meddelanden
  2. Åsidosättningar – Ersätt systemprompter eller meddelanden helt
  3. Webhooks för samtalsinitiering – Hämta data från din server när ett samtal startar

Metoder för personalisering

Dynamiska variabler

Definiera värden vid körning med syntaxen {{ var_name }} för att personalisera agentens meddelanden, systemprompter och verktyg.

Åsidosättningar

Ersätt systemprompter, första meddelanden, språk eller röstinställningar helt för varje samtal.

Webhooks för samtalsinitiering

Hämta dynamiska variabler och åsidosättningar från din server för inkommande samtal.

Datastruktur för klientdata vid samtalsinitiering

Objektet conversation_initiation_client_data definierar vad som kan anpassas när ett samtal startas. Klienter kan skicka det direkt. En webhook för samtalsinitiering returnerar samma objekt.

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

Systemets dynamiska variabler (de med prefixet system__) kan inte skickas eller åsidosättas i klientens initieringspayload. Endast anpassade dynamiska variabler kan anges via fältet dynamic_variables.

Webhooks för samtalsinitiering

För inkommande telefoni och meddelanden kan ElevenAgents hämta dessa initieringsdata från din server i stället för från klienten. När webhooken är aktiverad skickar ElevenAgents en POST-begäran och tillämpar JSON-data som du returnerar.

Konfigurera webhook-URL:en och hemligheter för headers i agentinställningarna. På agentens flik Säkerhet aktiverar du Hämta klientdata för initiering från en webhook samt eventuella åsidosättningsfält som ditt svar kan innehålla.

Webhooken körs för ett nytt inkommande samtal via Twilio voice, Exotel, SIP-trunk, WhatsApp eller Twilio SMS när klientdata för samtalsinitiering inte redan finns. Den körs även för sessioner med Amazon Connect, där ditt svar sammanfogas med den kontaktkontext som Amazon Connect tillhandahåller.

Utgående samtal via Twilio voice, Exotel, SIP och WhatsApp utlöser den endast om den utgående begäran inte innehöll conversation_initiation_client_data. Utgående WhatsApp-meddelanden utlöser den aldrig – skicka i stället dynamiska variabler i den utgående begäran.

Den körs inte för widget- eller SDK-samtal, andra meddelandeintegrationer eller återupptagna WhatsApp- och SMS-trådar.

Förhandsgranskningssamtal som startas från agentens inställningssida utlöser inte webhooks för samtalsinitiering. Använd platshållarna för Dynamiska variabler i agentredigeraren när du testar i Förhandsgranskning. Dessa platshållare används inte i inkommande produktionssamtal.

ElevenAgents skickar samtalskontext i begärans brödtext:

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

caller_id och called_number är telefonnummer i Twilio, Exotel, SIP och SMS. I inkommande WhatsApp är de WhatsApp-användar-ID:t och ditt WhatsApp-telefonnummer-ID. Vid utgående samtal är caller_id ditt nummer och called_number personen som rings upp. call_sid är leverantörens samtals-SID för telefoni och en tom sträng för WhatsApp, SMS och Amazon Connect. SIP-samtal kan även innehålla call_id och sip_headers. Amazon Connect-sessioner innehåller call_id som är inställt på kontakt-ID:t.

Ditt svar måste använda formen conversation_initiation_client_data ovan. Inkludera varje anpassad dynamisk variabel som agenten definierar. Åsidosättningar är valfria och måste aktiveras i Säkerhet. HTTP-svarets brödtext måste vara högst 256 kB (262 144 byte).

En webhook som misslyckas eller tidsgränsar kan förhindra att samtalet startar. Information om Twilio-konfiguration finns i Twilio-personalisering. Den här webhooken är separat från webhooks efter samtal.

Välj rätt metod

MetodBäst förImplementering
Dynamiska variabler
  • Infoga användarspecifika data i mallbaserat innehåll - Bibehålla ett konsekvent agentbeteende med personliga detaljer - Personalisera verktygsparametrar
Definiera variabler med {{ variable_name }} och skicka värden vid körning
Åsidosättningar
  • Ändra agentens beteende helt för varje användare - Byta språk eller röster - Äldre applikationer (överväg att migrera till dynamiska variabler)

Aktivera specifika behörigheter för åsidosättning i säkerhetsinställningarna och skicka komplett ersättningsinnehåll

Webhooks för samtalsinitiering
  • Personalisera inkommande Twilio-, SIP-, WhatsApp- eller SMS-samtal från din server - Slå upp samtalskontext innan samtalet startar

Aktivera webhooken i säkerhetsinställningarna och returnera conversation_initiation_client_data

Läs mer