रीयल-टाइम मॉनिटरिंग

लाइव बातचीत देखें और सक्रिय कॉल के दौरान कंट्रोल कमांड भेजें

रीयल-टाइम मॉनिटरिंग WebSocket के ज़रिए एजेंट की बातचीत को लाइव देखने और सक्रिय कॉल को रिमोट से कंट्रोल करने की सुविधा देती है। यह फ़ीचर बातचीत की घटनाओं को रीयल-टाइम में दिखाता है और कंट्रोल कमांड के ज़रिए हस्तक्षेप करने देता है।

यह फ़ीचर केवल एंटरप्राइज़ के लिए है।

ओवरव्यू

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

WebSocket एंडपॉइंट

मॉनिटरिंग एंडपॉइंट का उपयोग करके लाइव बातचीत से कनेक्ट करें:

wss://api.elevenlabs.io/v1/convai/conversations/{conversation_id}/monitor

{conversation_id} को उस बातचीत की ID से बदलें जिसे आप मॉनिटर करना चाहते हैं।

ऑथेंटिकेशन

ऑथेंटिकेशन के लिए ये ज़रूरी हैं:

  • API key अनुमतियां: आपकी API key में ElevenLabs Agents Write स्कोप होना चाहिए
  • वर्कस्पेस एक्सेस: आपके पास एजेंट के वर्कस्पेस का EDITOR एक्सेस होना चाहिए
  • हेडर फ़ॉर्मैट: xi-api-key हेडर के ज़रिए अपनी API key शामिल करें

उदाहरण कनेक्शन

const ws = new WebSocket('wss://api.elevenlabs.io/v1/convai/conversations/conv_123/monitor', {
headers: {
'xi-api-key': 'your_api_key_here',
},
});

कॉन्फ़िगरेशन

बातचीत मॉनिटर करने से पहले, अपने एजेंट की सेटिंग्स में यह फ़ीचर सक्षम करें:

1

एजेंट सेटिंग्स पर जाएं

डैशबोर्ड में अपने एजेंट का कॉन्फ़िगरेशन पेज खोलें।

2

मॉनिटरिंग सक्षम करें

Advanced सेटिंग्स पैनल में “Monitoring” विकल्प टॉगल करें।

एजेंट सेटिंग्स में मॉनिटरिंग टॉगल

3

इवेंट चुनें

वे इवेंट चुनें जिन्हें आप मॉनिटर करना चाहते हैं। उपलब्ध इवेंट की पूरी सूची के लिए क्लाइंट इवेंट्स देखें।

इन इवेंट को मॉनिटर नहीं किया जा सकता: VAD स्कोर, टर्न प्रॉबेबिलिटी मेट्रिक्स और पिंग्स।

मॉनिटर करने के लिए कनेक्ट करने से पहले बातचीत सक्रिय होनी चाहिए। बातचीत शुरू होने से पहले आप उसे मॉनिटर नहीं कर सकते।

कंट्रोल कमांड

बातचीत नियंत्रित करने के लिए WebSocket के ज़रिए JSON कमांड भेजें:

सक्रिय बातचीत तुरंत समाप्त करें।

// End the active conversation
ws.send(JSON.stringify({
command_type: "end_call"
}));

कॉल को दिए गए फ़ोन नंबर पर ट्रांसफ़र करें।

// Transfer to a phone number
ws.send(JSON.stringify({
command_type: "transfer_to_number",
parameters: {
phone_number: "+1234567890"
}
}));
एजेंट में transfer_to_number सिस्टम टूल पहले से कॉन्फ़िगर होना चाहिए।

सक्रिय बातचीत में कॉन्टेक्स्ट या निर्देश जोड़ें, ताकि एजेंट अपने जवाबों में नई जानकारी का इस्तेमाल कर सके।

// Send a contextual update to the agent
ws.send(JSON.stringify({
command_type: "contextual_update",
parameters: {
contextual_update: "<your update text>"
}
}));

चैट बातचीत के लिए AI एजेंट मोड से ह्यूमन ऑपरेटर मोड पर स्विच करें।

// Enable human takeover
ws.send(JSON.stringify({
command_type: "enable_human_takeover"
}));

चैट बातचीत में ह्यूमन ऑपरेटर के रूप में यूज़र को मैसेज भेजें।

// Send a message as a human operator
ws.send(JSON.stringify({
command_type: "send_human_message",
parameters: {
text: "How can I help you?"
}
}));

कंट्रोल को ह्यूमन ऑपरेटर से वापस AI एजेंट को दें।

// Disable human takeover and return to AI
ws.send(JSON.stringify({
command_type: "disable_human_takeover"
}));

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

रीयल-टाइम मॉनिटरिंग कई ऑपरेशनल स्थितियों में मदद करती है:

क्वालिटी एश्योरेंस

गुणवत्ता मानक सुनिश्चित करने और ट्रेनिंग के अवसर पहचानने के लिए एजेंट की बातचीत को रीयल-टाइम में मॉनिटर करें।

ह्यूमन एस्केलेशन

ऐसी बातचीत पहचानें जिसमें ह्यूमन हस्तक्षेप चाहिए और AI एजेंट से आसानी से टेकओवर करें।

एनालिटिक्स डैशबोर्ड

बातचीत के मेट्रिक्स और परफ़ॉर्मेंस इंडिकेटर्स को इकट्ठा करने वाले रीयल-टाइम मॉनिटरिंग डैशबोर्ड बनाएं।

कॉल सेंटर निगरानी

एक साथ कई एजेंट बातचीत की निगरानी करें और ज़रूरत पड़ने पर हस्तक्षेप करें।

ऑटोमेटेड हस्तक्षेप

बातचीत की सामग्री का विश्लेषण करने और खास स्थितियों के आधार पर कार्रवाई शुरू करने वाले ऑटोमेटेड सिस्टम लागू करें।

ट्रेनिंग और कोचिंग

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

सीमाएं

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

मॉनिटरिंग एंडपॉइंट केवल टेक्स्ट इवेंट और मेटाडेटा स्ट्रीम करता है। मॉनिटरिंग इवेंट में रॉ ऑडियो डेटा शामिल नहीं होता।

सक्रिय बातचीत से कनेक्ट होने पर केवल लगभग आखिरी 100 इवेंट कैश किए जाते हैं और उपलब्ध होते हैं। पहले के इवेंट वापस नहीं पाए जा सकते।

कस्टम इवेंट चयन सक्षम होने पर VAD स्कोर, टर्न प्रॉबेबिलिटी मेट्रिक्स और पिंग इवेंट मॉनिटर नहीं किए जा सकते।

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

API keys में ElevenLabs Agents Write स्कोप होना चाहिए और बातचीत मॉनिटर करने के लिए आपके पास EDITOR वर्कस्पेस एक्सेस होना चाहिए।

संबंधित संसाधन