Παράκαμψη περιγραφής εργαλείου αποθήκευσης

Σημείωμα

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

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

Τι κάνει

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

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

• Προσθέστε μια υπόδειξη δρομολόγησης για να list_cases προτιμήσετε το εργαλείο Copilot Studio.
• Αποθηκεύστε μια παράκαμψη περιγραφής εργαλείου για get_case το with mcs_my_case_tool ως κύριο.
• Προσαρτήστε την επιλογή "Εξετάστε το ενδεχόμενο χρήσης υποθέσεων Contoso για καλύτερη απόδοση επένδυσης (ROI)" στην περιγραφή του εργαλείου υποθέσεων λίστας.

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

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

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

• Μόνο τα ονόματα εργαλείων πρώτου μέρους μπορούν να στοχευθούν. Τα εργαλεία τρίτων πελατών (mcs_*/ext_*) δεν υποστηρίζονται ως στόχοι.
• primaryToolName θα πρέπει να είναι ένα όνομα εργαλείου τρίτου κατασκευαστή πελάτη (mcs_* ή ext_*) για να είναι δυνατός ο υποβιβασμός υπό όρους.
• Το κείμενο υπόδειξης απολυμαίνεται για να αφαιρεθούν οι χαρακτήρες ελέγχου και οι χαρακτήρες μηδενικού πλάτους πριν προσαρτηθούν.
• Η σύνθετη περιγραφή (πρωτότυπο + σύνθημα) πρέπει να παραμείνει εντός 1024 byte. Εάν υπερβεί το όριο, η παράκαμψη παραλείπεται σιωπηλά κατά το χρόνο εκτέλεσης.
• Οι αλλαγές διαδίδονται μέσα σε λίγα λεπτά μετά την αποθήκευση.

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

• Η περιγραφή του εργαλείου λίστας παρακάμπτει για να επαληθεύσει την αλλαγή.
• Διαγραφή παρακάμψεων περιγραφής εργαλείου.
• Έξοδος από τη λειτουργία διαμόρφωσης.

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

Ναι, αυτό αλλάζει τα δεδομένα ρύθμισης παραμέτρων.

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

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

Αυτό το εργαλείο είναι διαθέσιμο στον διακομιστή Dynamics 365 Customer Service MCP και απαιτεί δικαιώματα δημιουργού/διαχειριστή. Δεν απαιτείται πρόσθετη ρύθμιση παραμέτρων.

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

Ιδιότητα	Τιμή
Όνομα εργαλείου	save_tool_description
Πεδίο εφαρμογής	οργανισμός
Αλλάζει δεδομένα	Ναι
Μόνο δημιουργός/διαχειριστής	Ναι

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

Αποθηκεύει τις ενημερώσεις κώδικα παράκαμψης περιγραφής εργαλείου σε επίπεδο οργανισμού. Κάθε patch προσθέτει μια αποστειρωμένη υπόδειξη στην αρχική περιγραφή του εργαλείου πρώτου κατασκευαστή. Όταν καθορίζεται ένα primaryToolName (mcs_*/ext_*), η παράκαμψη εφαρμόζεται κατά τον χρόνο εκτέλεσης μόνο όταν αυτό το εργαλείο τρίτου κατασκευαστή είναι επίσης καταχωρημένο στην ίδια αίτηση (υποβιβασμός υπό όρους). Απορρίπτει τα ονόματα εργαλείων τρίτων πελατών ως στόχους παράκαμψης.

Σχολιασμούς

Σχόλια	Τιμή	Έννοια
readOnlyHint	false	Αυτό το εργαλείο τροποποιεί δεδομένα.
destructiveHint	false	Συγχωνεύει ή αναβαθμίζει μπαλώματα. δεν διαγράφει τις υπάρχουσες παρακάμψεις.
idempotentHint	true	Η αποθήκευση του ίδιου patch δύο φορές παράγει το ίδιο αποτέλεσμα.
openWorldHint	false	δεν καλεί εξωτερικά συστήματα εκτός του ρυθμισμένου πεδίου Dynamics 365.

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

Διορθώσεις

Δεδομένα εισόδου	Περιγραφή	Υποχρεωτικό
patches	Πίνακας tool-description αντικειμένων patch	Ναι

Όνομα εργαλείου

Δεδομένα εισόδου	Περιγραφή	Υποχρεωτικό
toolName	Όνομα εργαλείου πρώτου κατασκευαστή για διαμόρφωση (δεν πρέπει να είναι mcs_*/ext_*)	Ναι

Κείμενο

Δεδομένα εισόδου	Περιγραφή	Υποχρεωτικό
text	Υπόδειξη κειμένου για προσθήκη μετά την αρχική περιγραφή του εργαλείου	Ναι

Όνομα κύριου εργαλείου

Δεδομένα εισόδου	Περιγραφή	Υποχρεωτικό
primaryToolName	Όνομα εργαλείου τρίτου κατασκευαστή πελάτη (mcs_*/ext_*)—η παράκαμψη ισχύει μόνο όταν υπάρχει αυτό το εργαλείο	Όχι

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

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

Μόνο κείμενο

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

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

Χρήση save_tool_description όταν:

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

Μην το χρησιμοποιείτε save_tool_description όταν:

• Ο χρήστης θέλει μόνο να επιθεωρήσει τις παρακάμψεις. Χρησιμοποιήστε list_tool_description.
• Ο χρήστης θέλει να καταργήσει όλες τις παρακάμψεις. Χρησιμοποιήστε delete_tool_description.

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

Εργαλείο	Σχέση
list_tool_description	Παραθέτει τις παρακάμψεις που έχουν ρυθμιστεί πριν ή μετά την αποθήκευση
delete_tool_description	Καταργεί όλες τις παρακάμψεις περιγραφής εργαλείου
browse_agent_config_options	Εξερευνά τις σχετικές επιλογές ρύθμισης παραμέτρων

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

Γράψε.

Δημιουργεί ή ενημερώνει την περιγραφή του εργαλείου για την παράκαμψη των ενημερώσεων κώδικα σε επίπεδο οργανισμού.