Δοκιμή σύνδεσης πράκτορα MCS

Σημείωμα

• Τα εργαλεία και τα παραδείγματα σε αυτήν την τεκμηρίωση απεικονίζουν τις τρέχουσες δυνατότητες. Τα ονόματα εργαλείων, οι περιγραφές, οι παράμετροι, οι μορφές απόκρισης και οι διαθέσιμες λειτουργίες μπορούν να αλλάξουν με την πάροδο του χρόνου.
• Όταν δημιουργείτε πράκτορες, ενοποιήσεις ή λογική ενορχήστρωσης, μην κωδικοποιείτε εξαρτήσεις από συγκεκριμένα ονόματα εργαλείων, δομές παραμέτρων, μεταδεδομένα εργαλείων ή σχήματα απόκρισης. Αντίθετα, σχεδιάστε τη λύση σας για να ανακαλύψετε και να χρησιμοποιήσετε τα διαθέσιμα εργαλεία κατά το χρόνο εκτέλεσης.
• Καθώς η πλατφόρμα εξελίσσεται, η Microsoft μπορεί να προσθέσει, να αφαιρέσει, να μετονομάσει ή να τροποποιήσει εργαλεία και μεταδεδομένα εργαλείων. Η σχεδίαση σε σχέση με τις δυνατότητες και όχι με συγκεκριμένα αναγνωριστικά εργαλείων συμβάλλει στη διατήρηση της συμβατότητας μεταξύ των ενημερώσεων υπηρεσίας.

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

Τι κάνει

Όταν επιλέγετε Δοκιμή σύνδεσης στη φόρμα εγγραφής εκπροσώπου Copilot Studio, αυτό το εργαλείο επαληθεύει ότι ο παράγοντας εξυπηρέτησης μπορεί να επικοινωνήσει με το επιλεγμένο bot. Εκτελεί έναν έλεγχο τριών σταδίων: λήψη της ταυτότητας και των μετα-δεδομένων του bot από το Dataverse, επίλυση του περιβάλλοντος Power Platform και επαλήθευση προσβασιμότητας μέσω του SDK παραγόντων.

Εάν η σύνδεση είναι επιτυχής, το εργαλείο επιστρέφει την ταυτότητα bot, το όνομα σχήματος, το επιλυμένο αναγνωριστικό περιβάλλοντος, μια προεπισκόπηση περιγραφής μόνο για ανάγνωση, τη χρονική σήμανση ανάκτησης και το αποτέλεσμα προσβασιμότητας. Αυτά τα δεδομένα συμπληρώνουν τη φόρμα εγγραφής. Εάν η σύνδεση αποτύχει, το εργαλείο επιστρέφει ένα σταδιακό σφάλμα που υποδεικνύει ποιο βήμα απέτυχε (για παράδειγμα, το bot δεν βρέθηκε, το bot είναι ανενεργό, το περιβάλλον δεν επιλύθηκε ή το SDK δεν είναι προσβάσιμο).

Δοκιμάστε προτροπές όπως

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

Τι θα δείτε στη συνομιλία

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

Χρήσιμες συμβουλές

• Πάντα να δοκιμάζετε πριν αποθηκεύσετε. Τα μεταδεδομένα bot από μια επιτυχημένη δοκιμή συμπληρώνουν τα απαιτούμενα πεδία στη φόρμα εγγραφής.
• Εάν η δοκιμή αποτύχει στο στάδιο "το bot δεν βρέθηκε", βεβαιωθείτε ότι το αναγνωριστικό bot είναι σωστό και ότι το bot έχει δημοσιευτεί στο Copilot Studio.
• Εάν η δοκιμή αποτύχει στο στάδιο "ανενεργό bot", δημοσιεύστε ξανά το bot στο Copilot Studio για να το ενεργοποιήσετε.
• Εάν η δοκιμή αποτύχει με σφάλμα συγκατάθεσης ή δικαιώματος, ελέγξτε ότι υπάρχουν τα απαιτούμενα δικαιώματα Power Platform για τον λογαριασμό χρήστη σας.
• Το τεστ έχει όριο χρονικού ορίου. Εάν το SDK παραγόντων αργεί να ανταποκριθεί, η δοκιμή μπορεί να αποτύχει ακόμα και αν το bot είναι τεχνικά προσβάσιμο.

Τι συμβαίνει στη συνέχεια

Μετά από μια επιτυχημένη δοκιμή, μπορείτε:

• Αποθηκεύστε αυτήν την εγγραφή.
• Ελέγξτε τα μεταδεδομένα του bot.
• Γράψτε μια περιγραφή για αυτόν τον πράκτορα.

Αλλάζει αυτό τα δεδομένα;

Όχι, αυτό δεν αλλάζει τα δεδομένα.

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

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

Αυτό το εργαλείο απαιτεί τα εξής:

• Επεκτασιμότητα Copilot με Copilot Studio.

Μάθετε περισσότερα στο θέμα Επέκταση Copilot με το Copilot Studio.

Σύνοψη εργαλείου

Ιδιοκτησία	Τιμή
Όνομα χρήστη	Δοκιμή σύνδεσης πράκτορα MCS
Όνομα εσωτερικού εργαλείου	test_copilot_studio_registration_connection
Σκοπός	Ανακτά την προεπισκόπηση ταυτότητας και περιγραφής μόνο για ανάγνωση ενός bot Copilot Studio, επιλύει το περιβάλλον του και επαληθεύει την προσβασιμότητα μέσω του SDK παραγόντων

Συμπεριφορά εργαλείου

Ανακτά την ταυτότητα ενός bot Copilot Studio και μια προεπισκόπηση περιγραφής μόνο για ανάγνωση από το Dataverse, επιλύει το περιβάλλον Power Platform και επαληθεύει την προσβασιμότητα μέσω του SDK παραγόντων. Η προεπισκόπηση δεν διατηρείται ως περιγραφή εγγραφής. Ο δημιουργός συντάσσει αυτό το πεδίο ξεχωριστά. Αυτό είναι ένα εργαλείο υποστήριξης widget που καλείται αυτόματα από το widget διαχείρισης εγγραφών.

Σχολιασμούς

Σχόλια	Τιμή	Έννοια
readOnlyHint	true	Αυτό το εργαλείο δεν τροποποιεί δεδομένα.
destructiveHint	Δεν έχει οριστεί	Άνευ αντικειμένου (εργαλείο μόνο για ανάγνωση).
idempotentHint	Δεν έχει οριστεί	Άνευ αντικειμένου (εργαλείο μόνο για ανάγνωση).
openWorldHint	Δεν έχει οριστεί	Χρησιμοποιεί προεπιλογή (ερωτήματα Dataverse + Power Platform).

Έννοιες εισόδου

Αναγνωριστικό Bot

Δεδομένα εισόδου	Περιγραφή	Υποχρεωτικό
botId	botId (UUID, απαιτείται). Το Dataverse bot.botid του bot του Copilot Studio για δοκιμή.	Ναι

Αναγνωριστικό περιβάλλοντος

Δεδομένα εισόδου	Περιγραφή	Υποχρεωτικό
environmentId	environmentId (UUID, προαιρετικό). Το GUID του περιβάλλοντος Power Platform. Όταν παρέχεται, παραλείπει την κλήση API επίλυσης περιβάλλοντος.	όχι

Διεύθυνση URL οργανισμού

Δεδομένα εισόδου	Περιγραφή	Υποχρεωτικό
orgUrl	orgUrl (προαιρετικός). Παρακάμπτει την τρέχουσα επιλεγμένη διεύθυνση URL περιβάλλοντος.	όχι

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

Αυτό το εργαλείο MCP υποστηρίζεται από μια εφαρμογή MCP.

Τύπος απόκρισης

Ενημέρωση widget με αποτελέσματα δοκιμής σύνδεσης

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

Σημειώσεις δρομολόγησης

Αυτό το εργαλείο καλείται αποκλειστικά από το manage_copilot_studio_registration widget. Μην το επικαλείστε απευθείας.

Σχετικά εργαλεία

Εργαλείο	Σχέση
manage_copilot_studio_registration	Το εργαλείο εκκίνησης που ανοίγει το γραφικό στοιχείο εγγραφής
save_copilot_studio_registration	Αποθηκεύει την καταχώριση με περιγραφή και διαμόρφωση εισόδου που έχει συνταχθεί από τον κατασκευαστή
list_copilot_studio_registration_bots	Παραθέτει τα διαθέσιμα bot για τον επιλογέα bot
delete_registration	Καταργεί μια εγγραφή αντιπροσώπου όταν type το είναι "mcs"

Ταξινόμηση μεταλλάξεων δεδομένων

Μόνο για ανάγνωση. Ελέγχει τη συνδεσιμότητα και ανακτά μεταδεδομένα χωρίς να τροποποιεί δεδομένα.