Καταγραφή τηλεμετρίας με το Application Insights

Σημαντικό

Οι δυνατότητες του Power Virtual Agents αποτελούν τώρα μέρος του Microsoft Copilot Studio μετά από σημαντικές επενδύσεις σε παραγωγική τεχνητή νοημοσύνη και βελτιωμένες ενσωματώσεις στο Microsoft Copilot.

Ορισμένα άρθρα και στιγμιότυπα οθόνης ενδέχεται να αναφέρονται στο Power Virtual Agents ενώ ενημερώνουμε την τεκμηρίωση και το εκπαιδευτικό περιεχόμενο.

Αυτό το άρθρο εξετάζει τον τρόπο με τον οποίο μπορείτε να συλλαμβάνετε δεδομένα τηλεμετρίας από τον Microsoft Copilot Studio copilot για χρήση στο Azure Application Insights.

Εκτός από τις εγγενείς δυνατότητες ανάλυσης εντός του Microsoft Copilot Studio, μπορείτε να στείλετε δεδομένα τηλεμετρίας στο Application Insights. Η τηλεμετρία παρέχει πληροφορίες σχετικά με τον copilot σας, μέσω της παρακολούθησης:

• Μηνύματα καταγραφής και συμβάντα που αποστέλλονται προς και από τον copilot σας
• Θέματα που ενεργοποιούνται κατά τη διάρκεια συζητήσεων με τους χρήστες
• Προσαρμοσμένα συμβάντα τηλεμετρίας που μπορούν να αποσταλούν από τα θέματα σας

Σημαντικό

Το Application Insights είναι μια δυνατότηα του Azure Monitor, ένα επεκτάσιμο εργαλειο διαχείρισης απόδοσης εφαρμογής (APM) που σάς επιτρέπει να παρακολουθείτε τις live εφαρμογές σας. Απαιτεί μια συνδρομή στο Microsoft Azure.

Εφαρμογή Web

Συνδέστε το Copilot Studio copilot με το Application Insights

Για να συνδεθείτε στο copilot στο Application Insights πρέπει πρώτα να προσθέσετε το κλειδί λειτουργίας στο έργο.

1. Μεταβείτε στη σελίδα λεπτομερειών Copilot στην περιοχή Ρυθμίσεις.

2. Αλλάξτε στην καρτέλα Για προχωρημένους.

3. Εντός της ενότητας Application Insights , συμπληρώστε τη ρύθμιση Συμβολοσειρά σύνδεσης. Ανατρέξτε στην τεκμηρίωση της Παρακολούθησης Azure για να μάθετε πώς μπορείτε να εντοπίσετε τη συμβολοσειρά σύνδεσης.

4. Προαιρετικά, μπορείτε να επιλέξετε να ενεργοποιήσετε μία από τις εξής ρυθμίσεις.

   • Δραστηριότητες καταγραφής: Εάν είναι ενεργοποιημένες, καταγράφονται οι λεπτομέρειες των εισερχόμενων/εξερχόμενων μηνυμάτων και συμβάντων.

   • Καταγραφή ευαίσθητων ιδιοτήτων δραστηριότητας: Εάν είναι ενεργοποιημένες, οι τιμές ορισμένων ιδιοτήτων που θα μπορούσαν να θεωρούνται ευαίσθητες στα εισερχόμενα/εξερχόμενα μηνύματα και συμβάντα συμπεριλαμβάνονται στα αρχεία καταγραφής. Οι ιδιότητες που θεωρείται πιθανό να είναι ευαίσθητες είναι το userid, το όνομα, το κείμενο και η γλώσσα (οι ιδιότητες κειμένου και ομιλούν εφαρμόζονται μόνο στα μηνύματα).

Ανάλυση τηλεμετρίας bot με το Application Insights

Μετά τη σύνδεση του bot στο Application Insights, δεδομένα τηλεμετρίας θα καταγράφονται όταν οι χρήστες αλληλεπιδρούν με το bot, συμπεριλαμβανομένων των δοκιμών εντός του Microsoft Copilot Studio. Για να δείτε τα καταγεγραμμένα δεδομένα τηλεμετρίας, μεταβείτε στην ενότητα Αρχεία καταγραφής του πόρου Application Insights σας στο Azure.

Από εδώ, μπορείτε να χρησιμοποιήσετε ερωτήματα Kusto για να θέσετε ερωτήματα και να αναλύσετε τα δεδομένα σας. Δείτε ερωτήματα παράδειγμα.

Παραδείγματα ερωτημάτων

Ένα ερώτημα μπορεί να είναι τόσο απλό όσο ο καθορισμός ενός μεμονωμένου πίνακα, όπως customEvents, ο οποίος εμφανίζει όλα τα προσαρμοσμένα συμβάντα τηλεμετρίας που καταγράφονται από το Microsoft Copilot Studio. Ωστόσο, μπορείτε, επίσης, να χρησιμοποιήσετε ερωτήματα Kusto για να περιορίσετε περαιτέρω τα αποτελέσματα, όπως:

• Προσθήκη χρονικού διαστήματος
• Επέκταση των αποτελεσμάτων σας χρησιμοποιώντας προσαρμοσμένες διαστάσεις. Οι προσαρμοσμένες ιδιότητες είναι προσαρμοσμένες ιδιότητες που καταγράφονται, μαζί με τα προκατασκευασμένα πεδία, όπως η χρονική σήμανση ή το όνομα συμβάντος
• Μια ρήτρα όπου για τον περιορισμό των δεδομένων που επιστρέφονται βάσει μιας συνθήκης
• Χρήση περισσότερων ενσωματωμένων συναρτήσεων Kusto για να καθορίσετε τι και πώς εμφανίζονται οι πληροφορίες

Το παρακάτω παράδειγμα ερωτήματος οδηγεί σε ένα γράφημα γραμμών που δείχνει πόσοι διακριτοί χρήστες επικοινωνούν με το bot σας ανά ημέρα για τις τελευταίες 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

Σημαντικό

Τα δεδομένα σε ορισμένα πεδία διαφέρουν και ισχύουν λίγο-πολύ, ανάλογα με το κανάλι που χρησιμοποιείται. Για παράδειγμα, θα λάβετε μόνο τη σωστή μέτρηση μοναδικών χρηστών στο ερώτημα, εάν είναι ταυτοποιημένοι χρήστες και τα αναγνωριστικά χρήστη τους είναι συνεπή σε όλες τις συνομιλίες. Σε ανώνυμα σενάρια, όπου δημιουργείται ένα αναγνωριστικό τυχαίου χρήστη ανά συνομιλία, το πεδίο αναγνωριστικού χρήστη είναι λιγότερο χρήσιμο.

Αποκλεισμός της τηλεμετρίας από τις δοκιμαστικές συνομιλίες από τα ερωτήματά σας

Το bot σας καταγράφει τηλεμετρία για όλες τις συνομιλίες, συμπεριλαμβανομένων και εκείνων που γίνονται μέσα στον δοκιμαστικό καμβά Microsoft Copilot Studio. Εάν θέλετε να αποκλείσετε την τηλεμετρία που έχετε συγκεντρώσει κατά τη διάρκεια της δοκιμής, μπορείτε να επεκτείνετε το ερώτημά σας με την designMode προσαρμοσμένη ιδιότητα που αποτυπώνεται σε όλα τα συμβάντα και να χρησιμοποιήσετε έναν όρο όπου στο ερώτημά σας.

Στο ακόλουθο παράδειγμα παρουσιάζονται όλα τα προσαρμοσμένα συμβάντα, με εξαίρεση αυτά που καταγράφονται μέσω του δοκιμαστικού καμβά.

customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"

Προσαρμοσμένες διαστάσεις

Ένα μεγάλο μέρος των δεδομένων συγκεκριμένης δραστηριότητας που λαμβάνονται από το Microsoft Copilot Studio έχει αποθηκευτεί στο πεδίο customDimensions. Μπορείτε να δείτε ένα προσαρμοσμένο πεδίο διαστάσεων που χρησιμοποιείται σε ένα ερώτημα για την εξαίρεση της τηλεμετρίας από τις δοκιμαστικές συνομιλίες.

Πεδίο	Description	Τιμές δείγματος
type	Τύπος δραστηριότητας	message, conversationUpdate, event, invoke
channelId	Αναγνωριστικό καναλιού	emulator, directline, msteams, webchat
fromId	Από αναγνωριστικό	<id>
fromName	Όνομα χρήστη από πελάτη	John Bonham, Keith Moon, Steve Smith, Steve Gadd
locale	Τοπικές ρυθμίσεις προέλευσης πελάτη	en-us, zh-cn, en-GB, de-de, zh-CN
recipientId	Αναγνωριστικό παραλήπτη	<id>
recipientName	Όνομα παραλήπτη	John Bonham, Keith Moon, Steve Smith, Steve Gadd
κείμενο	Κείμενο σε μήνυμα	find a coffee shop
designMode	Συνομιλία που έγινε μέσα στον δοκιμαστικό καμβά	True / False

Κλασική

Σημείωμα

Το Microsoft Copilot Studio υποστηρίζει πλέον αυτές τις δυνατότητες χωρίς το Composer.

Μπορείτε να χρησιμοποιήσετε το Bot Framework Composer με το Microsoft Copilot Studio για να στείλετε δεδομένα συμβάντος σε μια υπηρεσία τηλεμετρίας στο Application Insights. Η τηλεμετρία παρέχει πληροφορίες σχετικά με τις δυνατότητες που χρησιμοποιείτε περισσότερο, εντοπίζει την ανεπιθύμητη συμπεριφορά και παρέχει δεδομένα σχετικά με τη διαθεσιμότητα, την απόδοση και τη χρήση.

Σημαντικό

Το Application Insights είναι μια δυνατότηα του Azure Monitor, ένα επεκτάσιμο εργαλειο διαχείρισης απόδοσης εφαρμογής (APM) που σάς επιτρέπει να παρακολουθείτε τις live εφαρμογές σας. Απαιτεί μια συνδρομή στο Microsoft Azure.

Σύνδεση Application Insights

Για να συνδεθείτε στην υπηρεσία Application Insights στο Composer, πρέπει να προσθέσετε το κλειδί λειτουργίας στο έργο.

1. Στο Composer, μεταβείτε στη σελίδα Ρύθμιση παραμέτρων.

   

2. Ενεργοποίηση Προβολής ρυθμίσεων για προχωρημένους (json).

   

3. Βρείτε την ενότητα applicationInsights και μετά προσθέτε το κλειδί λειτουργίας Application Insights στη ρύθμιση instrumentationKey.

   

Για να μάθετε περισσότερα σχετικά με το πώς να ρυθμίσετε και να χρησιμοποιήσετε το Application Insights και να δημιουργήσετε ερωτήματα για τα προσαρμόσιμα παράθυρα διαλόγου του Composer, δείτε αυτούς τους πόρους:

• Συνδρομή στο Microsoft Azure.
• Γρήγορα αποτελέσματα με το Application Insights.
• Οι βασικές έννοιες της καταγραφής ερωτημάτων στο Azure Monitor.
• Παράδειγμα ερωτημάτων Kusto για προσαρμόσιμο παράθυρο διαλόγου στο Composer.