Αποθήκευση εγγραφής αντιπροσώπου MCS

Σημείωμα

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

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

Τι κάνει

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

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

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

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

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

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

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

• Πρέπει να εκτελέσετε το Test Connection πριν αποθηκεύσετε μια νέα καταχώρηση. Τα μεταδεδομένα bot από τη δοκιμή χρησιμοποιούνται για τη συμπλήρωση των απαιτούμενων πεδίων.
• Κάθε bot μπορεί να εγγραφεί μόνο μία φορά. Καταργήστε πρώτα την υπάρχουσα εγγραφή εάν πρέπει να εγγράψετε ξανά το ίδιο bot.
• Η περιγραφή που παρέχετε είναι αυτό που βλέπει ο εκπρόσωπος εξυπηρέτησης όταν αποφασίζει εάν θα αναθέσει μια ερώτηση σε αυτόν τον εκπρόσωπο. Κάντε το σαφές και συγκεκριμένο.
• Τα ονόματα σχημάτων πρέπει να είναι μοναδικά σε όλες τις εγγραφές του Copilot Studio στο περιβάλλον σας.

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

Μετά την αποθήκευση, το γραφικό στοιχείο εγγραφής επιστρέφει στην προβολή λίστας. Μπορείτε να κάνετε τα εξής:

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

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

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

Η αποθήκευση μιας καταχώρησης δημιουργεί ή ενημερώνει μια καρτέλα ρύθμισης παραμέτρων στο περιβάλλον Dynamics 365 και ανανεώνει τη λίστα διαθέσιμων εργαλείων του Service Agent.

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

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

• Επεκτασιμότητα Copilot με Copilot Studio που πρόκειται να διαμορφωθεί. Απαιτεί ρόλο διαχειριστή συστήματος ή διαχειριστή υπηρεσίας Copilot.

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

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

Ιδιοκτησία	Τιμή
Όνομα χρήστη	Αποθήκευση εγγραφής αντιπροσώπου MCS
Όνομα εσωτερικού εργαλείου	save_copilot_studio_registration
Σκοπός	Διατηρεί μια νέα ή ενημερωμένη εγγραφή εκπροσώπου Copilot Studio (MCS)

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

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

Σχολιασμούς

Σχόλια	Τιμή	Έννοια
readOnlyHint	false	Αυτό το εργαλείο δημιουργεί ή ενημερώνει δεδομένα εγγραφής.
destructiveHint	false	Οι ενημερώσεις είναι μη καταστροφικές (upsert pattern).
idempotentHint	true	Οι επαναλαμβανόμενες κλήσεις με την ίδια είσοδο παράγουν το ίδιο αποτέλεσμα.
openWorldHint	Δεν έχει οριστεί	Χρησιμοποιεί προεπιλογή.

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

Αντικείμενο εγγραφής

Δεδομένα εισόδου	Περιγραφή	Απαιτείται
botId, name, displayName, , description, inputParameters, environmentId, schemaName, m365AppId	Περιέχει τις λεπτομέρειες εγγραφής εκπροσώπου, συμπεριλαμβανομένων των botId (GUID bot Dataverse), name (μοναδικό αναγνωριστικό), displayName, description, inputParameters, ( environmentId περιβάλλον Power Platform) schemaNameκαι m365AppId.	Όχι

Αναγνωριστικό εγγραφής

Δεδομένα εισόδου	Περιγραφή	Απαιτείται
id	id (προαιρετικός). Όταν παρέχεται, ενημερώνει μια υπάρχουσα εγγραφή. όταν παραλείπεται, δημιουργεί ένα νέο.	Όχι

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

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

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

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

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

Ενημέρωση widget

Το widget ανανεώνεται για να εμφανίσει την αποθηκευμένη εγγραφή.

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

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

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

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

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

Γράψτε (upsert). Δημιουργεί ή ενημερώνει μια εγγραφή εκπροσώπου του Copilot Studio στον χώρο αποθήκευσης εγγραφών σε επίπεδο οργανισμού.