ओवरराइड्स

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

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

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

परिचय

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

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

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

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

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 मॉडल और उनके सटीक स्ट्रिंग आइडेंटिफ़ायर दिए गए हैं।