चैट मोड

अवलोकन

चैट मोड सक्षम करने के दो मुख्य तरीके हैं:

1. एजेंट कॉन्फ़िगरेशन: API से एजेंट बनाते समय उसे सिर्फ़ टेक्स्ट मोड के लिए कॉन्फ़िगर करें
2. रनटाइम ओवरराइड्स: प्रोग्राम के ज़रिए सिर्फ़ टेक्स्ट वाली बातचीत लागू करने के लिए SDK ओवरराइड्स का उपयोग करें

यह गाइड दोनों तरीकों और अलग-अलग SDKs में चैट मोड लागू करने का तरीका बताती है।

सिर्फ़ टेक्स्ट वाले एजेंट्स बनाना

हर बातचीत के लिए इसे डिफ़ॉल्ट बनाने हेतु एजेंट को सिर्फ़ टेक्स्ट मोड के लिए कॉन्फ़िगर करें।

सिर्फ़ टेक्स्ट मोड के लिए रनटाइम ओवरराइड्स

ओवरराइड्स का उपयोग करके रनटाइम पर चैट मोड सक्षम करने के लिए (एजेंट स्तर पर कॉन्फ़िगर करने के बजाय), आप अपने कन्वर्सेशन कॉन्फ़िगरेशन में textOnly ओवरराइड का उपयोग कर सकते हैं:

from elevenlabs.client import ElevenLabs
from elevenlabs.conversational_ai.conversation import Conversation, ConversationInitiationData
# Configure for text-only mode with proper structure
conversation_override = {
    "conversation": {
        "text_only": True
    }
}
config = ConversationInitiationData(
    conversation_config_override=conversation_override
)
conversation = Conversation(
    elevenlabs,
    agent_id,
    requires_auth=bool(api_key),
    config=config,
    # Important: Ensure agent_response callback is set
    callback_agent_response=lambda response: print(f"Agent: {response}"),
    callback_user_transcript=lambda transcript: print(f"User: {transcript}"),
)
conversation.start_session()

यह कॉन्फ़िगरेशन सुनिश्चित करता है कि:

• कोई ऑडियो इनपुट/आउटपुट इस्तेमाल नहीं होता
• सभी संवाद टेक्स्ट मैसेज के ज़रिए होते हैं
• बातचीत चैट-जैसे इंटरफ़ेस मोड में चलती है

अहम बातें

मुख्य आवश्यकताएं

1. एजेंट रिस्पॉन्स इवेंट: एजेंट के टेक्स्ट मैसेज पाने और दिखाने के लिए हमेशा agent_response कॉलबैक या इवेंट हैंडलर कॉन्फ़िगर करें।

2. एजेंट कॉन्फ़िगरेशन: अगर आपका एजेंट एजेंट सेटिंग्स में खास तौर पर चैट मोड पर सेट है, तो वह ओवरराइड के बिना अपने-आप सिर्फ़ टेक्स्ट वाली बातचीत इस्तेमाल करेगा।

3. कोई ऑडियो इंटरफ़ेस नहीं: सिर्फ़ टेक्स्ट मोड का उपयोग करते समय, आपको ऑडियो इंटरफ़ेस कॉन्फ़िगर करने या माइक्रोफ़ोन की अनुमति मांगने की ज़रूरत नहीं है।

उदाहरण: एजेंट रिस्पॉन्स संभालना

def handle_agent_response(response):
    """Critical handler for displaying agent messages"""
    print(f"Agent: {response}")  # Update your UI with the response
    update_chat_ui(response)
config = ConversationInitiationData(
    conversation_config_override={"conversation": {"text_only": True}}
)
conversation = Conversation(
  elevenlabs,
  agent_id,
  config=config,
  callback_agent_response=handle_agent_response,
)
conversation.start_session()

टेक्स्ट मैसेज भेजना

चैट मोड में, आपको ऑडियो के बजाय प्रोग्राम के ज़रिए यूज़र मैसेज भेजने होंगे:

# Send a text message to the agent
conversation.send_user_message("Hello, how can you help me today?")

कॉन्करेंसी के फ़ायदे

चैट मोड वॉइस बातचीत की तुलना में कॉन्करेंसी के महत्वपूर्ण फ़ायदे देता है:

• ज़्यादा सीमाएं: सिर्फ़ चैट वाली बातचीत की कॉन्करेंसी सीमा वॉइस बातचीत से 25x ज़्यादा होती है
• अलग पूल: टेक्स्ट बातचीत, वॉइस बातचीत की सीमाओं से स्वतंत्र एक समर्पित कॉन्करेंसी पूल का उपयोग करती है
• स्केलेबिलिटी: कस्टमर सपोर्ट, चैटबॉट्स या ऑटोमेटेड टेस्टिंग जैसे हाई-थ्रूपुट ऐप्लिकेशंस के लिए बेहतरीन

उपयोग के मामले

चैट मोड इनके लिए बेहतरीन है:

• चैट इंटरफ़ेस: वॉइस के बिना पारंपरिक चैट UIs बनाना
• टेस्टिंग: ऑडियो डिपेंडेंसी के बिना एजेंट लॉजिक टेस्ट करना
• ऐक्सेसिबिलिटी: यूज़र्स के लिए टेक्स्ट-आधारित विकल्प देना
• शांत वातावरण: जब ऑडियो इनपुट/आउटपुट उचित न हो
• इंटीग्रेशन टेस्टिंग: एजेंट बातचीत की ऑटोमेटेड टेस्टिंग

समस्या निवारण

एजेंट जवाब नहीं दे रहा

अगर एजेंट के जवाब नहीं दिख रहे हैं:

1. जांचें कि agent_response कॉलबैक सही ढंग से कॉन्फ़िगर है
2. जांचें कि एजेंट चैट मोड के लिए कॉन्फ़िगर है या textOnly ओवरराइड सेट है
3. सुनिश्चित करें कि WebSocket कनेक्शन सफलतापूर्वक स्थापित है

अगले चरण

• एजेंट व्यवहार कस्टमाइज़ करने के बारे में जानें
• उन्नत इंटरैक्शन के लिए क्लाइंट इवेंट्स देखें
• सुरक्षित बातचीत के लिए ऑथेंटिकेशन सेटअप देखें