Αποθήκευση εξωτερικής εγγραφής MCP

Σημείωμα

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

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

Τι κάνει

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Ρόλος διαχειριστή συστήματος ή διαχειριστή υπηρεσίας Copilot.

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

Ιδιοκτησία	Τιμή
Όνομα χρήστη	Αποθήκευση εξωτερικής εγγραφής MCP
Όνομα εσωτερικού εργαλείου	save_mcp_registration
Σκοπός	Διατηρεί μια νέα ή ενημερωμένη εγγραφή εξωτερικού διακομιστή MCP

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

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

Σχολιασμούς

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

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

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

Δεδομένα εισόδου	Περιγραφή	Απαιτείται
displayName, , nameendpoint, authScope, , mode, toolPrefix,tools	Περιέχει τα στοιχεία εγγραφής διακομιστή, συμπεριλαμβανομένων των displayName, name (μοναδικό αναγνωριστικό), endpoint (HTTPS URL), authScope (πεδίο στόχου Entra OBO), mode, toolPrefixκαι tools πίνακας.	Όχι

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

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

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

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

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

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

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

Ενημέρωση widget

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

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

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

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

Εργαλείο	Σχέση
manage_mcp_registration	Το εργαλείο εκκίνησης που ανοίγει το γραφικό στοιχείο εγγραφής
delete_mcp_registration	Καταργεί μια καταχώριση
test_mcp_registration_connection	Ελέγχει τη συνδεσιμότητα πριν από την αποθήκευση

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

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