Χρησιμοποιήστε το ίχνος δραστηριότητας για να αποσφαλματώσετε τον agent σας

Η ανίχνευση δραστηριότητας σε εκπροσώπους που υποστηρίζονται από την πλεξούδα GitHub Copilot στο Microsoft Copilot Studio σάς δείχνει ακριβώς πώς το copilot σας επεξεργάζεται κάθε μήνυμα. Χρησιμοποιήστε το για να κατανοήσετε τη λογική αλυσίδα σκέψης του παράγοντα σας, να επαληθεύσετε την απόδοση προέλευσης γνώσης, να επιβεβαιώσετε την εκτέλεση εργαλείων και να αντιμετωπίσετε σφάλματα.

Σημείωμα

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

Η χρέωση βάσει χρήσης ισχύει για τη χρήση, τη δημιουργία, τη δοκιμή και την αξιολόγηση πρακτόρων. Αυτές οι ενέργειες ενδέχεται να καταναλώσουν πιστώσεις Copilot.

Προϋποθέσεις

  • Ένας πράκτορας που δημιουργήθηκε με την πλεξούδα GitHub Copilot
  • Τουλάχιστον μία δοκιμαστική συνομιλία στην καρτέλα Προεπισκόπηση

Ανοίξτε την ιχνηλάτηση δραστηριότητας

  1. Ανοίξτε τον παράγοντα σας στο Copilot Studio και επιλέξτε την καρτέλα Προεπισκόπηση.

  2. Βεβαιωθείτε ότι ο διακόπτης προεπισκόπησης τελικού χρήστη είναι απενεργοποιημένος (η προεπιλεγμένη προβολή δημιουργού). Το ίχνος δραστηριότητας εμφανίζεται δίπλα στο παράθυρο συνομιλίας και παρουσιάζει λεπτομέρειες επεξεργασίας για κάθε μήνυμα.

  3. Στείλτε ένα μήνυμα στον παράγοντα σας. Το ίχνος δραστηριότητας ενημερώνεται σε πραγματικό χρόνο καθώς ο παράγοντας επεξεργάζεται το μήνυμα.

Κατανοήστε το ίχνος δραστηριότητας

Το ίχνος δραστηριότητας εμφανίζει μια προβολή αλυσίδας σκέψης (CoT) της επεξεργασίας του παράγοντα σας. Κάθε βήμα στο ίχνος εμφανίζεται ως κόμβος που δείχνει τι έκανε ο παράγοντας και γιατί.

Τύποι κόμβων

Το ίχνος μπορεί να περιλαμβάνει τους ακόλουθους τύπους κόμβων:

Τύπος κόμβου Τι δείχνει
Μήνυμα χρήστη Το μήνυμα που στείλατε στον παράγοντα
Απάντηση παράγοντα Η απάντηση που δημιούργησε ο πράκτορας
Γνώση Μια προέλευση γνώσης που συμβουλεύτηκε ο παράγοντας για τεκμηρίωση. Αποδίδεται ως πτυσσόμενη κάρτα «Αναζητημένη γνώση» που εμφανίζει τις πηγές για κάθε προέλευση γνώσης στην οποία έχει γίνει πρόσβαση, καθώς και συνδέσεις παραπομπής όταν είναι διαθέσιμες.
Εκτελέστηκε ενέργεια Κλήση σύνδεσης ή εργαλείου, που αποδίδεται ως πτυσσόμενη κάρτα και εμφανίζει τη σύνδεση, τις συμπληρωμένες παραμέτρους εισόδου και τη διάρκεια παράδοσης
Εργαλείο Ένα εργαλείο που κάλεσε ο παράγοντας για να εκτελέσει μια ενέργεια ή να ανακτήσει δεδομένα
Σύνδεση Μια σύνδεση που χρησιμοποιούσε ο πράκτορας για πρόσβαση σε εξωτερικά δεδομένα
Ροή Μια ροή παράγοντα που ενεργοποιήθηκε
Δεξιότητα Μια δεξιότητα που εκτελέστηκε
Σφάλμα Σφάλμα που παρουσιάστηκε κατά την επεξεργασία
Πλήρης Μια πράσινη ένδειξη ελέγχου που εμφανίζεται στο κάτω μέρος του ίχνους όταν ολοκληρωθούν όλες οι κλήσεις εργαλείων

Προβολή λεπτομερειών κόμβου

  1. Επιλέξτε οποιονδήποτε κόμβο στο ίχνος για να αναπτύξετε τις λεπτομέρειές του.

  2. Εξετάστε τις πληροφορίες που εμφανίζονται, οι οποίες μπορεί να περιλαμβάνουν:

    • Τα δεδομένα εισόδου που έστειλε ο παράγοντας στο βήμα
    • Η έξοδος ή το αποτέλεσμα που επιστράφηκε
    • Χρόνος επεξεργασίας και μετρήσεις
    • Λεπτομέρειες σφάλματος εάν το βήμα απέτυχε

Διόρθωση προβλημάτων προέλευσης γνώσης

Όταν ο παράγοντας σας χρησιμοποιεί γνώση για να απαντήσει σε μια ερώτηση, το ίχνος δείχνει ποιες πηγές έχουν συμβουλευτεί.

  1. Βρείτε τον κόμβο Γνώση στο ίχνος.

  2. Εξετάστε την πηγή για να δείτε σε ποιες προελεύσεις γνώσης έγινε πρόσβαση.

  3. Επιλέξτε μια πηγή για να δείτε το συγκεκριμένο περιεχόμενο που ανακτήθηκε.

  4. Βεβαιωθείτε ότι ο παράγοντας χρησιμοποίησε τη σωστή πηγή και ότι το περιεχόμενο που ανακτήθηκε είναι σχετικό.

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

Εντοπισμός σφαλμάτων στην εκτέλεση εργαλείων

Όταν ο παράγοντας ενεργοποιεί ένα εργαλείο, η ιχνηλασία εμφανίζει τις λεπτομέρειες εκτέλεσης:

  1. Βρείτε τον κόμβο Εργαλείο, Διασύνδεση, Ροή ή δυνατότητα στην ιχνηλασία.

  2. Ελέγξτε τις λεπτομέρειες εκτέλεσης, συμπεριλαμβανομένων των παραμέτρων εισόδου και των αποτελεσμάτων εξόδου.

  3. Βεβαιωθείτε ότι κλήθηκε το σωστό εργαλείο και ότι τα αποτελέσματα είναι τα αναμενόμενα.

  4. Εάν η εκτέλεση ενός εργαλείου απέτυχε, ελέγξτε τις λεπτομέρειες του σφάλματος στον κόμβο.

Για να επαναρυθμίσετε ένα εργαλείο, ανοίξτε την καρτέλα Δόμηση και εντοπίστε το εργαλείο στη ρύθμιση παραμέτρων του παράγοντα σας.

Αντιμετώπιση σφαλμάτων

Όταν συμβαίνουν σφάλματα κατά την επεξεργασία, το ίχνος τα επισημαίνει:

  1. Αναζητήστε κόμβους που επισημαίνονται με ένδειξη σφάλματος στο ίχνος.

  2. Επιλέξτε τον κόμβο σφάλματος για να προβάλετε τις λεπτομέρειες του σφάλματος, συμπεριλαμβανομένου του μηνύματος σφάλματος και του πλαισίου.

  3. Συνήθη προβλήματα περιλαμβάνουν μεταξύ άλλων:

    • Αποτυχίες ελέγχου ταυτότητας για εργαλεία ή συνδέσεις
    • Σφάλματα πρόσβασης στην προέλευση γνώσης
    • Σφάλματα χρονικού ορίου για κλήσεις εργαλείων που διαρκούν πολύ
    • Επισημάνσεις συντονισμού περιεχομένου

  4. Αντιμετωπίστε τη βασική αιτία στην καρτέλα Δόμηση ή στις Ρυθμίσεις και, στη συνέχεια, δοκιμάστε ξανά.

Το ίχνος δραστηριότητας ενσωματώνεται στην καρτέλα Δόμηση για γρήγορη επεξεργασία.

  1. Επιλέξτε οποιαδήποτε πηγή, εργαλείο ή στοιχείο στο ίχνος δραστηριότητας.

  2. Το Copilot Studio μεταβαίνει στο αντίστοιχο στοιχείο στην καρτέλα Δόμηση.

  3. Κάντε τις αλλαγές σας και επιστρέψτε στην καρτέλα Έκδοση προεπισκόπησης για να επαναδοκιμάσετε.

  • Last updated on