Ρύθμιση των παραμέτρων μιας δεξιότητας Bot Framework για χρήση στο Copilot Studio

Το Copilot Studio σάς επιτρέπει να επεκτείνετε το copilot σας χρησιμοποιώντας δεξιότητες Bot Framework Εάν έχετε ήδη δημιουργήσει και αναπτύξει bot στον οργανισμό σας (με χρήση του Bot Framework SDK και εργαλείων προ-κώδικα) για συγκεκριμένα σενάρια, μπορείτε να μετατρέψετε αυτά τα bot σε δεξιότητα και να εγγράψετε αυτήν την δεξιότητα σε κάποιο Copilot Studio copilot.

Σημείωμα

Για να προσθέσετε μια δεξιότητα μέσα από την εφαρμογή Copilot Studio στο Microsoft Teams, πρέπει να έχετε μια μεμονωμένη συνδρομή Microsoft Copilot Studio.

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

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

• Εξέταση των περιορισμών και της επικύρωσης για δεξιότητες που χρησιμοποιούνται στο Copilot Studio

Σημαντικό

Τα copilot Copilot Studio υποστηρίζουν μόνο ενσωματωμένες δεξιότητες με χρήση του Bot Framework SDK έκδοση 4.12.0+.

Τα κλασικά bot συνομιλίας υποστηρίζουν μόνο δεξιότητες ενσωματωμένες χρησιμοποιώντας Bot Framework SDK έκδοση 4.7+.

Εάν χρησιμοποιείτε το Bot Framework Composer, συνιστάται ιδιαίτερα να χρησιμοποιήσετε το Composer 2.x. Εάν θέλετε να χρησιμοποιήσετε ένα υφιστάμενο copilot του Composer 1.x, πρώτα μετεγκαταστήστε το στο Composer 2.x πριν το χρησιμοποιήσετε ως δεξιότητα.

Για να διαμορφώσετε μια δεξιότητα, η σχετική εγγραφή εφαρμογής στο Microsoft Entra ID για την ικανότητά σας θα πρέπει να οριστεί σε Διαμόρφωση πολλαπλών μισθωτών.

Ενέργειες ροών και δεξιοτήτων

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

	Ενέργειες ροής	Ενέργειες δεξιότητας
Persona	Οι συντάκτες copilot έχουν τη δυνατότητα να δημιουργήσουν Ροές για να τις ενσωματώσουν σε κάθε συνομιλία copilot	Οι προγραμματιστές μπορούν να δημιουργήσουν, να αναπτύξουν και να φιλοξενήσουν προσαρμοσμένες δεξιότητες στο δικό τους περιβάλλον
Συνομιλία	Χρησιμοποιήστε Ροές για απλές λειτουργίες. Για παράδειγμα, κάντε μια παραγγελία ή λάβετε την κατάσταση παραγγελίας.	Χρησιμοποιήστε δεξιότητες για πολύπλοκες πολλαπλές λειτουργίες. Για παράδειγμα, προγραμματίστε μια σύσκεψη ή κάντε κράτηση για μια πτήση.
Απάντηση	Χρησιμοποιήστε τις Ροές για την αποστολή μιας απόκρισης copilot. Για παράδειγμα, εμφανίστε ένα εξατομικευμένο μήνυμα ή εσνωματωμένες εικόνες.	Χρησιμοποιήστε δεξιότητες για να στείλετε τυχόν υποστηριζόμενες απαντήσεις copilot. Για παράδειγμα, εμφανίστε μια προσαρμόσιμη κάρτα ή στείλτε τυχαίες αποκρίσεις.
Ενέργειες	Χρησιμοποιήστε τις Ροές για να ενεργοποιήσετε απλές ενέργειες από την πλευρά του διακομιστή. Για παράδειγμα, καλέστε ένα HTTP API ή ενεργοποιήστε μια προσαρμοσμένη σύνδεση.	Χρησιμοποιήστε δεξιότητες για να ενεργοποιήσετε συμβάντα και ενέργειες από την πλευρά του διακομιστή και του υπολογιστή-πελάτη. Για παράδειγμα, μεταβείτε σε μια σελίδα μετά την απόκριση copilot.

Ρύθμιση δεξιότητας

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

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

Για να προσθέσετε μια δεξιότητα στο copilot σας:

1. Στο τμήμα παραθύρου περιήγησης, αναπτύξτε τις Ρυθμίσεις και επιλέξτε Δεξιότητες.

2. Στο επάνω μέρος της σελίδας Δεξιότητες, επιλέξτε Προσθήκη δεξιότητας.

3. Αντιγράψτε το αναγνωριστικό του copilot σας και δώστε το στον προγραμματιστή δεξιοτήτων σας.

   

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

5. Επιλέξτε Επόμενο για να ξεκινήσει η διαδικασία επικύρωσης. Όταν η επικύρωση ολοκληρωθεί με επιτυχία, η δεξιότητα σας προστίθεται στο copilot σας. Τώρα μπορείτε να χρησιμοποιήσετε αυτήν την δεξιότητα στα θέματά σας.

Ζητήματα συμμόρφωσης

Για την προστασία του ιδιωτικού απορρήτου του χρήστη, απαιτείται η εγγραφή των δεξιοτήτων ως εφαρμογή στον μισθωτή Microsoft Entra ID του συνδεδεμένου χρήστη.

Αντιμετώπιση προβλημάτων κατά την εγγραφή δεξιοτήτων

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

Μήνυμα σφάλματος	Αντιμετώπιση προβλημάτων / Άμβλυνση
Αντιμετωπίζουμε προβλήματα κατά τη λήψη του δηλωτικού δεξιότητας. (MANIFEST_FETCH_FAILED)	Προσπαθήστε να ανοίξετε τη διεύθυνση URL δηλωτικού σε κάποιο πρόγραμμα περιήγησης στο Web. Εάν η διεύθυνση URL αποδώσει τη σελίδα μέσα σε 10 δευτερόλεπτα, καταχωρήστε εκ νέα την δεξιότητά σας.
Το δηλωτικό δεν είναι συμβατό. (MANIFEST_MALFORMED)	(α) Ελέγξτε αν το δηλωτικό είναι έγκυρο αρχείο JSON. (β) Ελέγξτε εάν το δηλωτικό περιέχει τις απαιτούμενες ιδιότητες Για παράδειγμα, (name, msaAppId, μοναδικό endpoint, activities/id, activities/description, activities/type (μόνο το event ή το message υποστηρίζεται)).
Υπάρχει ασυμφωνία στα τελικά σημεία (MANIFEST_ENDPOINT_ORIGIN_MISMATCH)	Ελέγξτε αν το τελικό σημείο δεξιοτήτων αντιστοιχεί στην καταχώριση εφαρμογής Microsoft Entra IDPublisher domain(προτιμώμενη) ή με το Home page URL πεδίο. Μάθετε περισσότερα σχετικά με τη ρύθμιση της αρχικής σελίδας για τελικά σημεία.
Για να προσθέσετε μια δυνατότητα, πρέπει πρώτα να καταχωρηθεί (APPID_NOT_IN_TENANT)	Ελέγξτε εάν το αναγνωριστικό εφαρμογής της δεξιότητας είναι καταχωρημένο στον μισθωτή του οργανισμού Microsoft Entra ID.
Η σύνδεση δεν είναι έγκυρη. Η σύνδεση πρέπει να αρχίζει με https:// (URL_MALFORMED, URL_NOT_HTTPS)	Πληκτρολογήστε εκ νέου τη σύνδεση ως ασφαλή διεύθυνση URL.
Το δηλωτικό είναι πολύ μεγάλο. (MANIFEST_TOO_LARGE)	Ελέγξτε το μέγεθος του δηλωτικού. Πρέπει να είναι μικρότερο ή ίσο με 500KB.
Αυτή η δεξιότητα έχει ήδη προστεθεί στο copilot σας. (MANIFEST_ALREADY_IMPORTED)	Διαγράψτε τη δεξιότητα και δοκιμάστε ξανά να καταχωρίσετε.
Η δεξιότητα περιορίζεται σε 100 ενέργειες. (LIMITS_TOO_MANY_ACTIONS)	Υπάρχουν πολλές ενέργειες δεξιοτήτων που καθορίζονται σε ένα δηλωτικό δεξιοτήτων. Καταργήστε ενέργειες και προσπαθήστε ξανά.
Οι ενέργειες περιορίζονται σε 25 εισόδους. (LIMITS_TOO_MANY_INPUTS)	Υπάρχουν υπερβολικά πολλές παράμετροι εισόδου ενεργειών δεξιότητας. Καταργήστε παραμέτρους και προσπαθήστε ξανά.
Οι ενέργειες περιορίζονται σε 25 εξόδους. (LIMITS_TOO_MANY_OUTPUTS)	Υπάρχουν υπερβολικά πολλές παράμετροι εξόδου ενεργειών δεξιότητας. Καταργήστε παραμέτρους και προσπαθήστε ξανά.
Κάθε copilot μπορεί να έχει έως και 100 δεξιότητες. (LIMITS_TOO_MANY_SKILLS)	Έχουν προστεθεί πολλές δεξιότητες σε ένα copilot. Καταργήστε μια υπάρχουσα δεξιότητα και προσπαθήστε ξανά.
Φαίνεται ότι παρουσιάστηκε κάποιο σφάλμα. (AADERROR_OTHER)	Παρουσιάστηκε παροδικό σφάλμα κατά την επικύρωση των δεξιοτήτων σας. Προσπαθήστε ξανά.
Παρουσιάστηκε κάποιο σφάλμα κατά τον έλεγχο της δεξιότητάς σας. (ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED)	Ελέγξτε εάν το τελικό σημείο δεξιότητάς σας είναι συνδεδεμένο και ανταποκρίνεται σε μηνύματα.
Αυτή η δεξιότητα δεν επιτρέπει το copilot (ENDPOINT_HEALTHCHECK_UNAUTHORIZED)	Ελέγξτε αν το copilot σας έχει προστεθεί στη λίστα επιτρεπόμενων δεξιοτήτων.