Κοινή χρήση μέσω

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

  • Άρθρο

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

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

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

Σημαντικό

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

Συνδέστε το 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