Εγκατάσταση πρακτόρων στο Microsoft Teams

Το Microsoft Teams παρουσιάζει μοναδικές προκλήσεις ανάπτυξης για τους υπαλλήλους του Copilot Studio λόγω του μόνιμου περιβάλλοντος συνομιλίας του. Σε αντίθεση με τις αναπτύξεις που βασίζονται στο web όπου γίνεται αυτόματη επαναφορά των περιόδων λειτουργίας, το Teams διατηρεί νήματα συνομιλίας επ' αόριστον, το οποίο μπορεί να οδηγήσει σε μη ενημερωμένο περιβάλλον, λήξη διακριτικού και παλιό περιεχόμενο στο cache.

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

Βασικά ζητήματα που καλύπτονται:

  • Διαχείριση κύκλου ζωής περιόδου λειτουργίας και χειρισμός αδράνειας
  • Τεχνικές εντοπισμού σφαλμάτων για μόνιμες συνομιλίες
  • Έλεγχος εκδόσεων και ενημέρωση στρατηγικών ανάπτυξης
  • Μοτίβα υλοποίησης για συγκεκριμένες ομάδες

Ακολουθήστε αυτές τις πρακτικές για να δημιουργήσετε ισχυρούς παράγοντες που αποδίδουν με συνέπεια στο περιβάλλον του Teams, παρέχοντας σαφή σχόλια στους χρήστες σχετικά με τις αλλαγές κατάστασης και τη συμπεριφορά του συστήματος.

Γιατί η ανάπτυξη του Teams είναι διαφορετική

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

Η διατήρηση του Teams δημιουργεί διάφορους κινδύνους:

  • Παλιό πλαίσιο: Το ιστορικό συνομιλιών παραμένει έως ότου διαγραφεί.
  • Λήξη διακριτικού: Οι συνδέσεις μπορούν να λήξουν κατά τη διάρκεια μεγάλων περιόδων λειτουργίας.
  • Όρια περιβάλλοντος: Τα συσσωρευμένα μηνύματα μπορούν να υπερβαίνουν τα όρια μοντέλου.
  • Ενημέρωση προσωρινής αποθήκευσης: Οι χρήστες ενδέχεται να συνεχίσουν να αλληλεπιδρούν με παλαιότερη λογική.

Είναι απαραίτητη η προληπτική κρατική διαχείριση και η σαφής καθοδήγηση των χρηστών.

Διαχείριση του κύκλου ζωής της συνεδρίας

Διαχειριστείτε τον κύκλο ζωής περιόδου λειτουργίας με χειρισμό αδράνειας.

Υλοποίηση επαναφοράς αδράνειας

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

  1. Προσθέστε το έναυσμα αδράνειας και ορίστε ένα χρονικό όριο (για παράδειγμα, 15 λεπτά).
  2. Προσθέστε έναν ή περισσότερους κόμβους απαλοιφής μεταβλητών τιμών για να καταργήσετε μεταβλητές περιόδου λειτουργίας και ιστορικό συνομιλίας, για να αποτρέψετε την υπερχείλιση περιβάλλοντος.
  3. Τερματίστε τη συζήτηση και επισημάνετε την περίοδο λειτουργίας ως επίλυση.

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

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

Παροχή καθοδήγησης μετά την επαναφορά

Μετά την εκκαθάριση της κατάστασης, στείλτε ένα μήνυμα που εξηγεί τι συνέβη. Για παράδειγμα: "Φαίνεται ότι η συζήτησή μας έμεινε αδρανής, επομένως, εκκαθαρίζω το προηγούμενο περιβάλλον για ασφάλεια. Πείτε "γεια" για επανεκκίνηση."

Επειδή ConversationStart ενεργοποιείται μόνο μία φορά, την πρώτη φορά που προστίθεται ένας πράκτορας, το θέμα Χαιρετισμού γίνεται το αποτελεσματικό σημείο έναρξης σας. Προτρέποντας το χρήστη να πει "hello" εξασφαλίζει ότι η λογική εκκίνησης εκτελείται σωστά.

Προσφορά εντολής επαναφοράς αυτοεξυπηρέτησης

Προσθέστε μηνύματα που πληροφορούν τους χρήστες ότι μπορούν να πληκτρολογήσουν μια συγκεκριμένη εντολή: "Εάν κάτι φαίνεται λάθος, δοκιμάστε να πληκτρολογήσετε για να ανανεώσετε την /debug clearstate κατάστασή μου".

Αυτή η εντολή επιβάλλει πλήρη επαναφορά συνομιλίας:

  • Καθαρισμός κατάστασης συνομιλίας
  • Καταργεί τις πληροφορίες σύνδεσης στο cache
  • Επανέλεγχος συνδέσεων
  • Φορτώνει την πιο πρόσφατη έκδοση του agent

Χρησιμοποιήστε αυτή την εντολή όταν:

  • Το bot φαίνεται "κολλημένο" με ξεπερασμένες πληροφορίες
  • Ο έλεγχος ταυτότητας σύνδεσης έχει λήξει
  • Μετά τις ενημερώσεις της λογικής bot
  • Όταν η συμπεριφορά φαίνεται ασυνεπής

Αύξηση της διαφάνειας και βελτίωση του εντοπισμού σφαλμάτων

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

Χρήση του OnKnowledgeRequested για την αποκάλυψη των ξαναγραμμένων ερωτημάτων

Το Copilot Studio ξαναγράφει ερωτήσεις χρηστών πριν εκτελέσει την ανάκτηση. Εάν ενεργοποιήσετε το OnKnowledgeRequested μηχανισμό, μπορείτε να κάνετε τα εξής:

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

Σημείωμα

Μπορείτε να ρυθμίσετε το OnKnowledgeRequested έναυσμα μόνο σε προβολή κώδικα χρησιμοποιώντας το YAML. Δεν υπάρχει υποστήριξη για σχεδιαστές απεικονίσεων.

Προσθέστε ένα μήνυμα που εμφανίζει τη λέξη-κλειδί και τα ερωτήματα σημασιολογίας που δημιουργούνται. Για παράδειγμα:

kind: AdaptiveDialog
beginDialog:
  kind: OnKnowledgeRequested
  id: main
  actions:
    - kind: SendActivity
      id: sendActivity_debug
      activity: |-    
        **Debug**: sending this lexical query "{System.KnowledgeSearchQuery}"
        **Debug**: sending this semantic query "{System.SearchQuery}"
inputType: {}
outputType: {}

Αυτό το ερώτημα παρέχει πρόσβαση μόνο για ανάγνωση στο βελτιστοποιημένο ερώτημα αναζήτησης (επανάληψη ερωτήματος) που δημιούργησε ο ενορχηστρωτής από την ερώτηση του χρήστη.

Οφέλη:

  • Βοηθά στον εντοπισμό σφαλμάτων αναντιστοιχίας στην πρόθεση.
  • Εμφανίζει στους χρήστες τι αναζητά ο πράκτορας.
  • Δημιουργεί εμπιστοσύνη στις ενέργειες του παράγοντα.
  • Βοηθά τους δημιουργούς κατά τη διάρκεια της δοκιμής.

Στοιχείο ελέγχου έκδοσης και αξιοπιστία ενημερώσεων

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

Έκδοση του bot επιφάνεια σε έναν χαιρετισμό ή σε ένα ειδικό θέμα

Συμπεριλάβετε ένα αναγνωριστικό έκδοσης χρησιμοποιώντας το θέμα Χαιρετισμό ή ένα αποκλειστικό θέμα Έκδοσης:

Contoso Helpdesk Bot – Version 1.3 (Nov 2025)

Ενημερώστε αυτήν την τιμή με κάθε δημοσίευση για να βοηθήσετε τους χρήστες και τις ομάδες υποστήριξης να επαληθεύσουν ποια δόμηση είναι ενεργή. Η ενημέρωση των μετα-δεδομένων έκδοσης ανανεώνει επίσης το περιεχόμενο στο cache. Η αλλαγή του ονόματος ή της περιγραφής του παράγοντα ζητά από το Teams να το φορτώσει ως νέα ενημέρωση.

Ενεργοποίηση της δυνατότητας "Επιβολή νεότερης έκδοσης" κατά τη δημοσίευση

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

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

Ζητήματα υλοποίησης για το Teams

Το Teams έχει μοναδικές συμπεριφορές που απαιτούν ιδιαίτερη προσοχή.

Χειρισμός του θέματος χαιρετισμού ως λογικής εκκίνησης

Δεδομένου ότι ConversationStart ενεργοποιείται μόνο μία φορά, την πρώτη φορά που προστίθεται ένας παράγοντας:

  • Τοποθετήστε τη λογική αρχικοποίησης στο Greeting.
  • Προσθέστε σαφείς οδηγίες στην περιγραφή της εφαρμογής Teams.
  • Υπενθύμιση στους χρήστες: "Μετά από ένα χρονικό όριο, πληκτρολογήστε "hello" για να ξεκινήσετε μια νέα συνομιλία."

Βελτιστοποίηση εναυσμάτων και εναλλακτικών λύσεων

Οι χρήστες ομάδων αλληλεπιδρούν φυσικά και απρόβλεπτα. Βεβαιωθείτε ότι το bot σας:

  • Χειρίζεται πολλές παραλλαγές χαιρετισμού.
  • Περιλαμβάνει αποχαιρετιστήριο χειρισμό.
  • Παρέχει πολλά παραδείγματα εκφράσεων.
  • Προσφέρει φιλικές και χρήσιμες απαντήσεις.
  • Χρησιμοποιεί λέξεις-κλειδιά για να καθοδηγήσει τους χρήστες σε σχετικά θέματα.
  • Χρησιμοποιείται OnKnowledgeRequested για τη διάγνωση χαμένων στόχων.
  • Ανακατευθύνει σε σχετικά θέματα που βασίζονται σε λέξεις-κλειδιά.
  • Ζητά από τους χρήστες να αναδιατυπώσουν εάν το bot έχει κολλήσει πραγματικά.

Έλεγχος συμπεριφοράς πιστοποίησης συνδετήρα

Όταν χρησιμοποιείτε συνδέσεις (ServiceNow, Outlook και άλλες), δοκιμάστε:

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

Υπόδειξη

Οι συνδέσεις ενδέχεται να μην ανανεώνουν τα tokens κατά τη διάρκεια εκτεταμένων συνεδριών. Χρησιμοποιήστε επαναφορά αδράνειας ή /debug clearstate για να επαναλάβετε την προσπάθεια OAuth όταν χρειάζεται. Κοινοποιήστε αυτήν την εντολή για την υποστήριξη ομάδων και χρηστών για γρήγορη αντιμετώπιση προβλημάτων.

Δοκιμή υπό πραγματικές συνθήκες

Καθώς το Teams διατηρεί την κατάστασή του σε όλες τις περιόδους λειτουργίας, οι δοκιμές σας θα πρέπει να αντικατοπτρίζουν την πραγματική εμπειρία χρήστη:

  1. Αναπτύξτε χρησιμοποιώντας τη δυνατότητα Εμφάνιση μόνο σε εμένα.
  2. Δοκιμάστε σενάρια μεγάλης διάρκειας (επιστρέφοντας μετά από ώρες).
  3. Δημοσιεύστε ενημερώσεις και επιβεβαιώστε ότι ο παράγοντας αλλάζει εκδόσεις.
  4. Επικυρώστε την απόδοση της προσαρμόσιμης κάρτας σε υπολογιστές και κινητές συσκευές.
  5. Δοκιμάστε ενέργειες σε διάφορα περιβάλλοντα συνομιλίας.

Λίστα ελέγχου ανάπτυξης

Έτοιμος; Εργασία
✓ Έναυσμα αδράνειας που έχει ρυθμιστεί για εκκαθάριση του ιστορικού συνομιλίας
✓ Τα μηνύματα χρήστη εξηγούν τις επαναφορές και καθοδηγούν στην επανεκκίνηση.
✓ /debug clearstate τεκμηριώθηκε για χρήστες
✓ OnKnowledgeRequested ενεργοποιημένη για διαφάνεια κατά τη διάρκεια της ανάπτυξης
✓ Αναγνωριστικό έκδοσης που περιλαμβάνεται στις αποκρίσεις
✓ Επιβολή νεότερης έκδοσης που ενεργοποιείται ανάλογα με την περίπτωση
✓ Το θέμα «χαιρετισμός» περιλαμβάνει λογική αρχικοποίησης
✓ Η συμπεριφορά επιστροφής είναι φιλική προς τον χρήστη
✓ Έλεγχος ταυτότητας συνδετήρα για λήξη και ανανέωση
✓ Η δοκιμή στο Teams υπό πραγματικές συνθήκες ολοκληρώθηκε

Βασικά συμπεράσματα

  • Διαχειριστείτε τον κύκλο ζωής περιόδου λειτουργίας ρυθμίζοντας εναύσματα αδράνειας και χρησιμοποιώντας επιλογές εκκαθάρισης κατάστασης, κατά περίπτωση.
  • Βελτιώστε τη διαφάνεια εμφανίζοντας τη δραστηριότητα του συστήματος μέσω αναδιατύπωσης ερωτημάτων και μηνυμάτων που σχετίζονται με την κατάσταση.
  • Λογαριασμός για συμπεριφορές ειδικά για το Teams, όπως ο χειρισμός μη αυτόματων χαιρετισμών και η διαχείριση μόνιμης μνήμης.
  • Διατηρήστε την αξιοπιστία του παράγοντα εφαρμόζοντας πρακτικές διαχείρισης εκδόσεων και επιβάλλοντας ενημερώσεις όταν είναι απαραίτητο.
  • Υποστήριξη αυτονομίας χρηστών με την παροχή εντολών αντιμετώπισης προβλημάτων από τον χρήστη και καθοδηγούμενων επιλογών αποκατάστασης.
  • Last updated on