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:
- Dynamiska variabler – Infoga värden vid körning i prompter och meddelanden
- Åsidosättningar – Ersätt systemprompter eller meddelanden helt
- 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.
Varje fält är valfritt.
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.
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 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.