नेविगेशन पर जाएँ

ओवरराइड्स

हर यूज़र के लिए व्यक्तिगत संदर्भ के साथ हर बातचीत को अनुकूलित करें।

हालांकि सिस्टम प्रॉम्प्ट या पहले संदेश को पूरी तरह बदलने के लिए ओवरराइड्स अभी भी समर्थित हैं, हम आपके एजेंट के जवाबों को अनुकूलित करने और रीयल-टाइम डेटा जोड़ने के पसंदीदा तरीके के रूप में डायनामिक वेरिएबल्स का इस्तेमाल करने की सलाह देते हैं। डायनामिक वेरिएबल्स बेहतर रखरखाव और व्यक्तिगतकरण के लिए अधिक व्यवस्थित तरीका देते हैं।

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

परिचय

ओवरराइड्स आपको कई एजेंट बनाए बिना रीयल-टाइम में अपने AI एजेंट का व्यवहार बदलने देते हैं। इससे आप यूज़र-विशिष्ट डेटा के साथ जवाबों को व्यक्तिगत बना सकते हैं।

एजेंट की सुरक्षा सेटिंग्स में इन फ़ील्ड्स के लिए ओवरराइड्स चालू किए जा सकते हैं:

  • सिस्टम प्रॉम्प्ट
  • पहला संदेश
  • भाषा
  • वॉइस ID
  • LLM (लार्ज लैंग्वेज मॉडल)
  • टूल्स
  • नॉलेज बेस
  • केवल-टेक्स्ट मोड
  • स्थिरता
  • गति
  • समानता बूस्ट
  • ASR कीवर्ड्स
  • प्रक्रियाएं

प्रक्रियाएं ओवरराइड conversation_config_override का इस्तेमाल नहीं करता। इसके बजाय, क्लाइंट बातचीत शुरू करने वाले क्लाइंट डेटा के टॉप लेवल पर procedure_ids और start_procedure_ids भेजता है। हर बातचीत के लिए प्रक्रियाएं चुनें देखें।

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

ASR कीवर्ड्स सॉफ्ट डिसअलाउ का इस्तेमाल करते हैं: अगर सिक्योरिटी टॉगल बंद है और क्लाइंट फिर भी asr.keywords भेजता है, तो बातचीत जारी रहती है और कीवर्ड्स को अनदेखा कर दिया जाता है (कोई त्रुटि नहीं)। जब आप हर बातचीत के लिए कीवर्ड बूस्टिंग लागू करना चाहते हैं, तो सुरक्षा सेटिंग्स में ASR कीवर्ड्स ओवरराइड चालू करें। हर बातचीत में अधिकतम 50 कीवर्ड्स समर्थित हैं।

यहां कुछ उदाहरण हैं जहां ओवरराइड्स उपयोगी हो सकते हैं:

  • यूज़र्स का उनके नाम से अभिवादन करें
  • जवाबों में अकाउंट-विशिष्ट जानकारी शामिल करें
  • यूज़र की पसंद के आधार पर एजेंट की भाषा या टोन बदलें
  • अकाउंट बैलेंस या ऑर्डर स्टेटस जैसे रीयल-टाइम डेटा भेजें
  • ASR कीवर्ड्स के ज़रिए हर कॉल के नामों या शब्दों (जैसे CRM कंपनी नाम) की ट्रांसक्रिप्शन बेहतर करें

ओवरराइड्स खास तौर पर उन ऐप्लिकेशन्स के लिए उपयोगी हैं जिनमें व्यक्तिगत इंटरैक्शन चाहिए या संवेदनशील यूज़र डेटा संभालना होता है, जिसे एजेंट के बेस कॉन्फ़िगरेशन में स्टोर नहीं करना चाहिए।

गाइड

ज़रूरी शर्तें

यह गाइड आपको डिफ़ॉल्ट एजेंट सिस्टम प्रॉम्प्ट, पहला संदेश, LLM, टूल्स, नॉलेज बेस, TTS सेटिंग्स, और ASR कीवर्ड्स को ओवरराइड करने का तरीका दिखाती है।

1

ओवरराइड्स चालू करें

सुरक्षा कारणों से, ओवरराइड्स डिफ़ॉल्ट रूप से बंद होते हैं। जिन फ़ील्ड्स को आप ओवरराइड करने की अनुमति देना चाहते हैं उन्हें चालू करें, जैसे first_message, prompt.prompt, prompt.tool_ids, prompt.knowledge_base, language, या asr.keywords।

अपने एजेंट की सेटिंग्स पर जाएं और सुरक्षा टैब चुनें। First message, System prompt, Tools, Knowledge base, ASR keywords, और आपको चाहिए कोई भी अन्य ओवरराइड, जैसे LLM, चालू करें।

ओवरराइड्स चालू करें

2

बातचीत को ओवरराइड करें

अपने कोड में, जहां बातचीत शुरू होती है, ओवरराइड्स को पैरामीटर के रूप में भेजें। टूल और नॉलेज बेस ओवरराइड्स उस बातचीत के लिए डिफ़ॉल्ट ऐरे को बदल देते हैं। ASR कीवर्ड ओवरराइड्स उस बातचीत के लिए एजेंट की डिफ़ॉल्ट कीवर्ड सूची को बदल देते हैं (अधिकतम 50 कीवर्ड्स)।

बातचीत शुरू करने का पेलोड
{
"conversation_config_override": {
"agent": {
"prompt": {
"tool_ids": ["tool_7101k5zvyjhmfg983brhmhkd98n6"],
"knowledge_base": [
{
"type": "file",
"name": "Unladen Swallow Facts",
"id": "5xM3yVvZQKV0EfqQpLrJ",
"usage_mode": "auto"
}
]
}
},
"asr": {
"keywords": ["Acme Corp", "Contoso", "Globex"]
}
}
}

पक्का करें कि आपके पास नवीनतम SDK इंस्टॉल है।

from elevenlabs.conversational_ai.conversation import Conversation, ConversationInitiationData
...
conversation_override = {
"agent": {
"prompt": {
"prompt": f"The customer's bank account balance is {customer_balance}. They are based in {customer_location}.", # Optional: override the system prompt.
"llm": "gpt-4o", # Optional: override the LLM model.
"tool_ids": [
"tool_7101k5zvyjhmfg983brhmhkd98n6"
], # Optional: replace the tools available to the agent.
"knowledge_base": [
{
"type": "file",
"name": "Unladen Swallow Facts",
"id": "5xM3yVvZQKV0EfqQpLrJ",
"usage_mode": "auto",
}
], # Optional: replace the knowledge base available to the agent.
},
"first_message": f"Hi {customer_name}, how can I help you today?", # Optional: override the first_message.
"language": "en" # Optional: override the language.
},
"tts": {
"voice_id": "custom_voice_id", # Optional: override the voice.
"stability": 0.7, # Optional: override stability (0.0 to 1.0).
"speed": 1.1, # Optional: override speed (0.7 to 1.2).
"similarity_boost": 0.9 # Optional: override similarity boost (0.0 to 1.0).
},
"conversation": {
"text_only": True # Optional: enable text-only mode (no audio).
},
"asr": {
"keywords": ["Acme Corp", "Contoso"] # Optional: boost ASR for per-call terms (max 50). Requires Security → ASR keywords.
}
}
config = ConversationInitiationData(
conversation_config_override=conversation_override
)
conversation = Conversation(
...
config=config,
...
)
conversation.start_session()

ओवरराइड्स इस्तेमाल करते समय, जिन फ़ील्ड्स को आप ओवरराइड नहीं करना चाहते उन्हें खाली स्ट्रिंग या null मान पर सेट करने के बजाय छोड़ दें। केवल वे फ़ील्ड्स शामिल करें जिन्हें आप खास तौर पर अनुकूलित करना चाहते हैं।

सही LLM मॉडल स्ट्रिंग खोजने के लिए एजेंट API रेफरेंस देखें, जिसमें सभी समर्थित LLM मॉडल और उनके सटीक स्ट्रिंग आइडेंटिफ़ायर दिए गए हैं।