पर्सनलाइज़ेशन

डायनामिक वेरिएबल्स और ओवरराइड्स का इस्तेमाल करके अपने एजेंट के व्यवहार को पर्सनलाइज़ करना सीखें।

ओवरव्यू

पर्सनलाइज़ेशन से आप हर यूज़र के लिए अपने एजेंट के व्यवहार को अनुकूलित कर सकते हैं, जिससे बातचीत ज़्यादा स्वाभाविक और संदर्भ के मुताबिक होती है। ElevenLabs पर्सनलाइज़ेशन के लिए कई तरीके देता है:

  1. डायनामिक वेरिएबल्स - प्रॉम्प्ट और मैसेज में रनटाइम वैल्यू डालें
  2. ओवरराइड्स - सिस्टम प्रॉम्प्ट या मैसेज को पूरी तरह बदलें
  3. कन्वर्सेशन इनिशिएशन वेबहुक्स - बातचीत शुरू होने पर अपने सर्वर से वह डेटा प्राप्त करें

पर्सनलाइज़ेशन के तरीके

कन्वर्सेशन इनिशिएशन क्लाइंट डेटा स्ट्रक्चर

conversation_initiation_client_data ऑब्जेक्ट यह तय करता है कि बातचीत शुरू करते समय क्या कस्टमाइज़ किया जा सकता है। क्लाइंट इसे सीधे भेज सकते हैं। कन्वर्सेशन इनिशिएशन वेबहुक भी यही ऑब्जेक्ट लौटाता है।

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

सिस्टम डायनामिक वेरिएबल्स (जिनके आगे system__ लगा होता है) को क्लाइंट इनिशिएशन पेलोड में भेजा या ओवरराइड नहीं किया जा सकता। dynamic_variables फ़ील्ड से केवल कस्टम डायनामिक वेरिएबल्स सेट किए जा सकते हैं।

कन्वर्सेशन इनिशिएशन वेबहुक्स

इनबाउंड टेलीफोनी और मैसेजिंग के लिए, ElevenAgents क्लाइंट के बजाय आपके सर्वर से यह इनिशिएशन डेटा प्राप्त कर सकता है। वेबहुक सक्षम होने पर, ElevenAgents POST रिक्वेस्ट भेजता है और आपके लौटाए गए JSON को लागू करता है।

एजेंट्स सेटिंग्स में वेबहुक URL और हेडर सीक्रेट्स कॉन्फ़िगर करें। एजेंट के सिक्योरिटी टैब में वेबहुक से इनिशिएशन क्लाइंट डेटा प्राप्त करें और वे सभी ओवरराइड फ़ील्ड सक्षम करें जिन्हें आपके रिस्पॉन्स में शामिल किया जा सकता है।

जब इनिशिएशन क्लाइंट डेटा पहले से मौजूद न हो, तो नया इनबाउंड कन्वर्सेशन शुरू होने पर यह वेबहुक Twilio वॉइस, Exotel, SIP ट्रंक, WhatsApp या Twilio SMS के लिए चलता है।

आउटबाउंड Twilio वॉइस, Exotel, SIP और WhatsApp कॉल में यह केवल तभी ट्रिगर होता है, जब आउटबाउंड रिक्वेस्ट में conversation_initiation_client_data शामिल न हो। आउटबाउंड WhatsApp मैसेज में यह कभी ट्रिगर नहीं होता — इसके बजाय आउटबाउंड रिक्वेस्ट में डायनामिक वेरिएबल्स पास करें।

यह विजेट या SDK बातचीत, अन्य मैसेजिंग इंटीग्रेशन, या फिर से शुरू किए गए WhatsApp और SMS थ्रेड्स के लिए नहीं चलता।

एजेंट सेटिंग्स पेज से शुरू की गई प्रीव्यू बातचीत कन्वर्सेशन इनिशिएशन वेबहुक्स को ट्रिगर नहीं करती। प्रीव्यू में टेस्ट करते समय एजेंट एडिटर में डायनामिक वेरिएबल्स प्लेसहोल्डर्स का इस्तेमाल करें। इन प्लेसहोल्डर्स का इस्तेमाल प्रोडक्शन इनबाउंड बातचीत में नहीं होता।

ElevenAgents रिक्वेस्ट बॉडी में कॉलर का संदर्भ भेजता है:

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

caller_id और called_number, Twilio, Exotel, SIP और SMS पर फ़ोन नंबर होते हैं। इनबाउंड WhatsApp पर ये WhatsApp यूज़र ID और आपके WhatsApp फ़ोन नंबर ID होते हैं। आउटबाउंड कॉल में caller_id आपका नंबर होता है और called_number उस व्यक्ति का नंबर होता है जिसे कॉल की जा रही है। call_sid, टेलीफोनी पर प्रोवाइडर कॉल SID और WhatsApp व SMS पर एक खाली स्ट्रिंग होता है। SIP कॉल में call_id और sip_headers भी शामिल हो सकते हैं।

आपके रिस्पॉन्स में ऊपर दिया गया conversation_initiation_client_data स्ट्रक्चर होना चाहिए। एजेंट द्वारा तय किए गए हर कस्टम डायनामिक वेरिएबल को शामिल करें। ओवरराइड्स वैकल्पिक हैं और उन्हें सिक्योरिटी में सक्षम होना चाहिए। HTTP रिस्पॉन्स बॉडी 256 KB या उससे छोटी (262,144 बाइट्स) होनी चाहिए।

वेबहुक के विफल होने या टाइम आउट होने से बातचीत शुरू नहीं हो सकती। Twilio सेटअप के लिए Twilio पर्सनलाइज़ेशन देखें। यह वेबहुक पोस्ट-कॉल वेबहुक्स से अलग है।

सही तरीका चुनें

तरीकासबसे उपयुक्तइंप्लीमेंटेशन
डायनामिक वेरिएबल्स
  • टेम्पलेटेड कॉन्टेंट में यूज़र-विशिष्ट डेटा डालना - पर्सनलाइज़्ड जानकारी के साथ एजेंट का व्यवहार एक जैसा बनाए रखना - टूल पैरामीटर्स को पर्सनलाइज़ करना
{{ variable_name }} के साथ वेरिएबल्स तय करें और रनटाइम पर वैल्यू पास करें
ओवरराइड्स
  • हर यूज़र के लिए एजेंट का व्यवहार पूरी तरह बदलना - भाषाएं या वॉइस बदलना - लेगसी एप्लिकेशन (डायनामिक वेरिएबल्स पर माइग्रेट करने पर विचार करें)

सिक्योरिटी सेटिंग्स में खास ओवरराइड अनुमतियां सक्षम करें और पूरा रिप्लेसमेंट कॉन्टेंट पास करें

कन्वर्सेशन इनिशिएशन वेबहुक्स
  • अपने सर्वर से इनबाउंड Twilio, SIP, WhatsApp या SMS बातचीत को पर्सनलाइज़ करना - बातचीत शुरू होने से पहले कॉलर का संदर्भ देखना

सिक्योरिटी सेटिंग्स में वेबहुक सक्षम करें और conversation_initiation_client_data लौटाएं

और जानें