Application Insights के साथ टेलीमेट्री कैप्चर करें
यह आलेख चर्चा करता है कि आप Azure में उपयोग के लिए अपने सह-पायलट से टेलीमेट्री डेटा कैसे कैप्चर कर सकते हैं। Microsoft Copilot Studio Application Insights
Microsoft Copilot Studioके भीतर मूल विश्लेषण सुविधाओं के अतिरिक्त, आप टेलीमेट्री डेटा भी भेज सकते हैं। Application Insights टेलीमेट्री आपके सह-पायलट के बारे में निम्नलिखित जानकारी प्रदान करती है:
- आपके सह-पायलट को भेजे गए और उनसे प्राप्त लॉग किए गए संदेश और ईवेंट
- उपयोगकर्ता वार्तालाप के दौरान ट्रिगर किए जाने वाले विषय
- कस्टम टेलीमेट्री ईवेंट जो आपके विषयों से भेजे जा सकते हैं
महत्त्वपूर्ण
Application Insights Azure Monitor की एक विशेषता है, जो एक एक्सटेंसिबल एप्लिकेशन परफॉरमेंस मैनेजमेंट (APM) टूल है जो आपको अपने लाइव एप्लिकेशन की निगरानी करने की अनुमति देता है। इसके लिए Microsoft Azure की सदस्यता की आवश्यकता है.
अपने Copilot Studio सह-पायलट को इससे कनेक्ट करें Application Insights
अपने सह-पायलट को Application Insights से कनेक्ट करने के लिए, आपको सबसे पहले प्रोजेक्ट में अपनी इंस्ट्रूमेंटेशन कुंजी जोड़नी होगी।
सेटिंग्स के अंतर्गत सह-पायलट विवरणपृष्ठ पर जाएँ।
उन्नत टैब पर जाएँ.
Application Insights अनुभाग के भीतर, कनेक्शन स्ट्रिंग सेटिंग भरें. अपने कनेक्शन स्ट्रिंग का पता लगाने का तरीका जानने के लिए Azure Monitor दस्तावेज़ देखें.
वैकल्पिक रूप से, आप निम्नलिखित सेटिंग्स में से किसी एक को सक्षम करना चुन सकते हैं।
लॉग गतिविधियाँ: यदि सक्षम किया गया है, तो आने वाले/जाने वाले संदेशों और घटनाओं का विवरण लॉग किया जाता है।
लॉग संवेदनशील गतिविधि गुण: यदि सक्षम किया गया है, तो आने वाले/जाने वाले संदेशों और घटनाओं पर संवेदनशील माने जा सकने वाले कुछ गुणों के मान लॉग में शामिल किए जाते हैं। संभावित रूप से संवेदनशील माने जाने वाले गुण हैं यूजर आईडी, नाम, टेक्स्ट और स्पीक (टेक्स्ट और स्पीक गुण केवल संदेशों पर लागू होते हैं)।
बॉट टेलीमेट्री का विश्लेषण करें Application Insights
आपके द्वारा अपने बॉट को Application Insights से कनेक्ट करने के बाद, जब उपयोगकर्ता बॉट के साथ इंटरैक्ट करते हैं, तो टेलीमेट्री डेटा लॉग किया जाता है, जिसमें Microsoft Copilot Studio के भीतर परीक्षण भी शामिल है। लॉग किए गए टेलीमेट्री डेटा को देखने के लिए, Azure में अपने संसाधन के लॉग अनुभाग पर जाएँ। Application Insights
यहां से, आप अपने डेटा की क्वेरी और विश्लेषण करने के लिए कुस्टो क्वेरीज़ का उपयोग कर सकते हैं। उदाहरण क्वेरीज़ देखें.
उदाहरण प्रश्न
एक क्वेरी एक एकल तालिका निर्दिष्ट करने जितना सरल हो सकता है, जैसे कि customEvents, जो Microsoft Copilot Studio से लॉग किए गए सभी कस्टम टेलीमेट्री इवेंट दिखाता है। लेकिन आप अपने परिणामों को और अधिक सीमित करने के लिए कुस्टो क्वेरीज़ का भी उपयोग कर सकते हैं, जिनमें शामिल हैं; ...
- समय अंतराल जोड़ना
- कस्टम आयाम का उपयोग करके अपने परिणामों का विस्तार करना. कस्टम आयाम कस्टम गुण हैं जिन्हें प्रीबिल्ट फ़ील्ड, जैसे टाइमस्टैम्प या ईवेंट नाम के साथ लॉग किया जाता है
- एक जहाँ किसी शर्त के आधार पर लौटाए गए डेटा को सीमित करने का खंड
- क्या और कैसे जानकारी दिखाई जाए, यह निर्धारित करने के लिए अधिक अंतर्निहित Kusto फ़ंक्शन का उपयोग करना
नीचे दिए गए उदाहरण क्वेरी के परिणामस्वरूप एक लाइन चार्ट प्राप्त होता है जो दर्शाता है कि पिछले 14 दिनों में प्रतिदिन कितने अलग-अलग उपयोगकर्ताओं ने आपके बॉट के साथ संचार किया।
let queryStartDate = ago(14d);
let queryEndDate = now();
let groupByInterval = 1d;
customEvents
| where timestamp > queryStartDate
| where timestamp < queryEndDate
| summarize uc=dcount(user_Id) by bin(timestamp, groupByInterval)
| render timechart
महत्त्वपूर्ण
कुछ क्षेत्रों में डेटा भिन्न-भिन्न होता है तथा प्रयुक्त चैनल के आधार पर कम या ज्यादा लागू होता है। उदाहरण के लिए, आपको क्वेरी में अद्वितीय उपयोगकर्ताओं की सही संख्या केवल तभी मिलेगी जब वे प्रमाणीकृत उपयोगकर्ता हों और उनकी उपयोगकर्ता आईडी सभी वार्तालापों में एक समान हों। अनाम परिदृश्यों में, जहां प्रति वार्तालाप एक यादृच्छिक उपयोगकर्ता आईडी उत्पन्न होती है, उपयोगकर्ता आईडी फ़ील्ड कम उपयोगी होती है।
अपने प्रश्नों से परीक्षण वार्तालापों से टेलीमेट्री को बाहर रखना
आपका बॉट सभी वार्तालापों के लिए टेलीमेट्री लॉग करता है, जिसमें परीक्षण कैनवास के भीतर होने वाली बातचीत भी शामिल है। Microsoft Copilot Studio यदि आप परीक्षण के दौरान एकत्रित टेलीमेट्री को बाहर करना चाहते हैं, तो आप अपनी क्वेरी को designMode कस्टम आयाम के साथ विस्तारित कर सकते हैं जो सभी घटनाओं पर कैप्चर किया जाता है, और अपनी क्वेरी में a where क्लॉज का उपयोग कर सकते हैं।
निम्न उदाहरण में परीक्षण कैनवास के माध्यम से कैप्चर किए गए इवेंट को छोड़कर सभी कस्टम इवेंट दिखाए गए हैं।
customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"
कस्टम आयाम
Microsoft Copilot Studio से प्राप्त अधिकांश विशिष्ट गतिविधि डेटा customDimensions फ़ील्ड में संग्रहीत किया जाता है। आप टेलिमेट्री को परीक्षण वार्तालापों से बाहर करने के लिए क्वेरी में उपयोग किए जा रहे कस्टम आयाम फ़ील्ड को देख सकते हैं .
| क्षेत्र | विवरण | नमूना मान |
|---|---|---|
| प्रकार | गतिविधि का प्रकार | message, conversationUpdate, event, invoke |
| channelId | चैनल पहचानकर्ता | emulator, directline, msteams, webchat |
| सेआईडी | पहचानकर्ता से | <id> |
| नाम से | क्लाइंट से उपयोगकर्ता नाम | John Bonham, Keith Moon, Steve Smith, Steve Gadd |
| लोकेल | क्लाइंट मूल स्थान | en-us, zh-cn, en-GB, de-de, zh-CN |
| प्राप्तकर्ताआईडी | प्राप्तकर्ता पहचानकर्ता | <id> |
| प्राप्तकर्ता का नाम | प्राप्तकर्ता का नाम | John Bonham, Keith Moon, Steve Smith, Steve Gadd |
| पाठ | संदेश में पाठ | find a coffee shop |
| डिज़ाइन मोड | बातचीत परीक्षण कैनवास के भीतर हुई | True / False |
