रीयल-टाइम मॉनिटरिंग
रीयल-टाइम मॉनिटरिंग
लाइव बातचीत देखें और सक्रिय कॉल के दौरान कंट्रोल कमांड भेजें
रीयल-टाइम मॉनिटरिंग WebSocket के ज़रिए एजेंट की बातचीत को लाइव देखने और सक्रिय कॉल को रिमोट से कंट्रोल करने की सुविधा देती है। यह फ़ीचर बातचीत की घटनाओं को रीयल-टाइम में दिखाता है और कंट्रोल कमांड के ज़रिए हस्तक्षेप करने देता है।
ओवरव्यू
मॉनिटरिंग सेशन ट्रांसक्रिप्ट, एजेंट के जवाब और सुधारों समेत बातचीत की घटनाओं को रीयल-टाइम में स्ट्रीम करते हैं। आप सक्रिय चैट बातचीत के दौरान कॉल समाप्त करने, फ़ोन नंबर पर ट्रांसफ़र करने या ह्यूमन टेकओवर सक्षम करने के लिए कंट्रोल कमांड भी भेज सकते हैं।
WebSocket एंडपॉइंट
मॉनिटरिंग एंडपॉइंट का उपयोग करके लाइव बातचीत से कनेक्ट करें:
{conversation_id} को उस बातचीत की ID से बदलें जिसे आप मॉनिटर करना चाहते हैं।
ऑथेंटिकेशन
ऑथेंटिकेशन के लिए ये ज़रूरी हैं:
- API key अनुमतियां: आपकी API key में
ElevenLabs Agents Writeस्कोप होना चाहिए - वर्कस्पेस एक्सेस: आपके पास एजेंट के वर्कस्पेस का
EDITORएक्सेस होना चाहिए - हेडर फ़ॉर्मैट:
xi-api-keyहेडर के ज़रिए अपनी API key शामिल करें
उदाहरण कनेक्शन
कॉन्फ़िगरेशन
बातचीत मॉनिटर करने से पहले, अपने एजेंट की सेटिंग्स में यह फ़ीचर सक्षम करें:
इवेंट चुनें
वे इवेंट चुनें जिन्हें आप मॉनिटर करना चाहते हैं। उपलब्ध इवेंट की पूरी सूची के लिए क्लाइंट इवेंट्स देखें।
इन इवेंट को मॉनिटर नहीं किया जा सकता: VAD स्कोर, टर्न प्रॉबेबिलिटी मेट्रिक्स और पिंग्स।
मॉनिटर करने के लिए कनेक्ट करने से पहले बातचीत सक्रिय होनी चाहिए। बातचीत शुरू होने से पहले आप उसे मॉनिटर नहीं कर सकते।
कंट्रोल कमांड
बातचीत नियंत्रित करने के लिए WebSocket के ज़रिए JSON कमांड भेजें:
कॉल समाप्त करें
सक्रिय बातचीत तुरंत समाप्त करें।
फ़ोन नंबर पर ट्रांसफ़र करें
कॉल को दिए गए फ़ोन नंबर पर ट्रांसफ़र करें।
transfer_to_number सिस्टम टूल पहले से कॉन्फ़िगर होना चाहिए।रीयल-टाइम कॉन्टेक्स्ट अपडेट
सक्रिय बातचीत में कॉन्टेक्स्ट या निर्देश जोड़ें, ताकि एजेंट अपने जवाबों में नई जानकारी का इस्तेमाल कर सके।
ह्यूमन टेकओवर सक्षम करें
चैट बातचीत के लिए AI एजेंट मोड से ह्यूमन ऑपरेटर मोड पर स्विच करें।
ह्यूमन के रूप में मैसेज भेजें
चैट बातचीत में ह्यूमन ऑपरेटर के रूप में यूज़र को मैसेज भेजें।
ह्यूमन टेकओवर अक्षम करें
कंट्रोल को ह्यूमन ऑपरेटर से वापस AI एजेंट को दें।
उपयोग के मामले
रीयल-टाइम मॉनिटरिंग कई ऑपरेशनल स्थितियों में मदद करती है:
सीमाएं
असिंक्रोनस इवेंट डिलीवरी
मॉनिटरिंग इवेंट बातचीत को असिंक्रोनस रूप से भेजे जाते हैं और वे मुख्य बातचीत इवेंट के क्रम में नहीं आ सकते। इवेंट प्रोसेस करते समय, बातचीत के सटीक समय को फिर से बनाने के लिए इवेंट के क्रम पर निर्भर न रहें।
ऑडियो डेटा उपलब्ध नहीं है
मॉनिटरिंग एंडपॉइंट केवल टेक्स्ट इवेंट और मेटाडेटा स्ट्रीम करता है। मॉनिटरिंग इवेंट में रॉ ऑडियो डेटा शामिल नहीं होता।
पुराने इवेंट की सीमा
सक्रिय बातचीत से कनेक्ट होने पर केवल लगभग आखिरी 100 इवेंट कैश किए जाते हैं और उपलब्ध होते हैं। पहले के इवेंट वापस नहीं पाए जा सकते।
इवेंट फ़िल्टरिंग प्रतिबंध
कस्टम इवेंट चयन सक्षम होने पर VAD स्कोर, टर्न प्रॉबेबिलिटी मेट्रिक्स और पिंग इवेंट मॉनिटर नहीं किए जा सकते।
कनेक्शन टाइमिंग
बातचीत शुरू होने के बाद आपको कनेक्ट करना होगा। बातचीत शुरू होने से पहले मॉनिटरिंग एंडपॉइंट इस्तेमाल नहीं किया जा सकता।
ज़रूरी अनुमतियां
API keys में ElevenLabs Agents Write स्कोप होना चाहिए और बातचीत मॉनिटर करने के लिए आपके पास EDITOR वर्कस्पेस एक्सेस होना चाहिए।
