Hoppa till navigering

Personalisering

Läs om 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 och få mer naturliga och kontextuellt relevanta konversationer. 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 konversationsstart – Hämta dessa data från din server när en konversation startar

Metoder för personalisering

Datastruktur för klientdata vid konversationsstart

Objektet conversation_initiation_client_data definierar vad som kan anpassas när en konversation startas. Klienter kan skicka det direkt. En webhook för konversationsstart 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",
"starting_workflow_node_id": "node_xxxx",
"procedure_ids": ["agtprc_xxxx", "agtprc_yyyy"],
"start_procedure_ids": ["agtprc_xxxx"]
}

Varje fält är valfritt.

FältBeskrivning
conversation_config_overrideÅsidosättningar per konversation. Varje fält kräver att dess åsidosättning är aktiverad på agentens flik Säkerhet.
custom_llm_extra_bodyExtra JSON som sammanfogas med begäran till din anpassade LLM. Kräver åsidosättningen Extra brödtext för anpassad LLM.
dynamic_variablesVärden för agentens dynamiska variabler.
user_idDitt ID för slutanvändaren, som används för att identifiera användare i olika konversationer.
source_infoKlienten som startade konversationen och dess version. Se Källinformation.
branch_idAgentgrenen som ska köras. Standard är agentens huvudgren.
environmentMiljön som används för att lösa miljövariabler. Standard är production.
starting_workflow_node_idStartar workflowet vid denna nod i stället för startnoden. Kräver åsidosättningen Startnod för workflow. En nodtyp som inte stöds gör att konversationsstarten misslyckas. Ett ID som inte finns i workflowet ignoreras, och konversationen börjar vid startnoden.
procedure_idsBegränsar konversationen till dessa procedurer. En tom array inaktiverar alla agentens procedurer. Gäller endast agenten som konversationen startar med. Kräver åsidosättningen Procedurer.
start_procedure_idsFriformsprocedurer som startar med konversationen, upp till fem. Kräver åsidosättningen Procedurer.

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

Källinformation

source_info registrerar vilken klient som startade konversationen. Källan lagras i konversationen och slutpunkten för att lista konversationer kan filtrera efter den.

{
"source_info": {
"source": "js_sdk",
"version": "1.2.3"
}
}
FältBeskrivning
sourceKlienttypen, ett ConversationInitiationSource-värde från API-referensen. Alla andra värden misslyckas vid validering.
versionKlientens version, upp till 50 tecken.

ElevenLabs SDK:er och widgeten rapporterar sin källa åt dig: js_sdk, react_sdk, react_native_sdk, python_sdk, swift_sdk, android_sdk, flutter_sdk och widget. En anpassad klient kan utelämna source_info. Använd det inte för dina egna metadata, utan använd dynamic_variables i stället.

ElevenAgents anger själv källan för telefoni, meddelanden, integrationer, förhandsvisningar av mallar och körningar av underagenter, till exempel twilio, sip_trunk, whatsapp, zendesk_integration, template_preview och subagent_tool. Ett svar från en webhook för konversationsstart ändrar inte detta.

Webhooks för konversationsstart

För inkommande telefoni och meddelanden kan ElevenAgents hämta dessa startdata 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:en du returnerar.

Konfigurera webhookens URL och header-hemligheter i Agentinställningar. På agentens flik Säkerhet aktiverar du Hämta klientdata för start från en webhook och alla åsidosättningsfält som ditt svar kan innehålla.

Webhooken körs för en ny inkommande konversation via Twilio-röst, Exotel, SIP-trunk, WhatsApp eller Twilio SMS när klientdata för start inte redan finns. Den körs även för sessioner i Amazon Connect, där ditt svar sammanfogas med kontaktkontexten som Amazon Connect tillhandahåller.

Utgående samtal via Twilio-röst, 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 konversationer via widgeten eller SDK:er, andra meddelandeintegrationer eller återupptagna WhatsApp- och SMS-trådar.

Förhandsvisningskonversationer som startas från sidan med agentinställningar utlöser inte webhooks för konversationsstart. Använd platshållarna Dynamiska variabler i agentredigeraren när du testar i Förhandsvisning. Dessa platshållare används inte i inkommande produktionskonversationer.

ElevenAgents skickar samtalskontext i begärandetexten:

{
"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. I 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 också 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 vara aktiverade under Säkerhet. HTTP-svarstexten måste vara högst 256 KB (262 144 byte).

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

Välj rätt metod

MetodPassar bäst förImplementering
Dynamiska variabler
  • Infoga användarspecifika data i mallbaserat innehåll - Behålla ett konsekvent agentbeteende med personliga detaljer - Personanpassa verktygsparametrar
Definiera variabler med {{ variable_name }} och skicka värden vid körning
Åsidosättningar
  • Ändra agentens beteende helt per 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 konversationsstart
  • Personanpassa inkommande Twilio-, SIP-, WhatsApp- eller SMS-konversationer från din server - Slå upp samtalskontext innan konversationen startar

Aktivera webhooken i säkerhetsinställningarna och returnera conversation_initiation_client_data

Läs mer