Διαχείριση εξωτερικών διακομιστών εργαλείων MCP

Σημείωμα

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

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

Τι κάνει

Ο βοηθός ανοίγει ένα περιβάλλον εργασίας διαχειριστή όπου μπορείτε να διαχειριστείτε τις καταχωρήσεις εξωτερικού διακομιστή εργαλείων MCP για το περιβάλλον Dynamics 365. Οι διακομιστές εργαλείων MCP (Model Context Protocol) είναι τελικά σημεία HTTPS που εκθέτουν πρόσθετα εργαλεία που μπορεί να καλέσει ο Service Agent κατά τη διάρκεια μιας συνομιλίας.

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

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

  • Διαχείριση των διακομιστών MCP μου.
  • Καταχωρήστε έναν εξωτερικό διακομιστή εργαλείων.
  • Εμφάνιση των εγγραφών διακομιστή MCP.
  • Προσθέστε ένα τελικό σημείο εργαλείου τρίτου κατασκευαστή.
  • Ανοίξτε τον διαχειριστή διακομιστή MCP.
  • Θέλω να καταχωρήσω ένα τελικό σημείο εργαλείου.

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

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

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

  • Χρειάζεστε το προνόμιο Service Agent Maker Customize για τη διαχείριση εγγραφών.
  • Κάθε καταχώριση απαιτεί ένα μοναδικό πρόθεμα εργαλείου (3-20 πεζούς αλφαριθμητικούς χαρακτήρες ή παύλες) που ονομάζει τα εργαλεία του διακομιστή.
  • Χρησιμοποιείτε πάντα το κουμπί Δοκιμή σύνδεσης πριν αποθηκεύσετε μια νέα καταχώρηση για να επαληθεύσετε ότι το τελικό σημείο είναι προσβάσιμο.
  • Το περιβάλλον σας υποστηρίζει έως και 20 εγγραφές εξωτερικού διακομιστή MCP.
  • Τα προθέματα που ταιριάζουν με τους χώρους ονομάτων εργαλείων πρώτου μέρους (όπως "υποθέσεις", "email" ή "mcp") είναι δεσμευμένα και δεν μπορούν να χρησιμοποιηθούν.

Συμβουλή

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

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

Αφού εμφανιστεί το widget εγγραφής, μπορείτε να κάνετε τα εξής:

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

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

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

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

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

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

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

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

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

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

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

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

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

Σχολιασμούς

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

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

Δράση

Δεδομένα εισόδου Περιγραφή Υποχρεωτικό
open, list open (προεπιλογή) ή list. Και τα δύο επιστρέφουν το γραφικό στοιχείο διαχείρισης εγγραφής. Η τιμή καταγράφει την πρόθεση αλληλεπίδρασης που ζητήθηκε. όχι

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

Δεδομένα εισόδου Περιγραφή Υποχρεωτικό
— Προαιρετικό. Μια .dynamics.com διεύθυνση URL περιβάλλοντος. Όταν παρέχεται, παρακάμπτει το τρέχον επιλεγμένο περιβάλλον. όχι

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

Αυτό το εργαλείο αποδίδει ένα διαδραστικό γραφικό στοιχείο διαχείρισης εγγραφής.

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

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

Διαδραστικό widget διαχείρισης εγγραφών

Και για τις δύο ενέργειες, το γραφικό στοιχείο εμφανίζει τη διεπαφή διαχείρισης εγγραφών όπου οι διαχειριστές μπορούν να περιηγηθούν, να προσθέσουν, να επεξεργαστούν, να δοκιμάσουν και να διαγράψουν εγγραφές διακομιστή MCP. Η action τιμή παραμένει μια υπόδειξη πρόθεσης στην απάντηση.

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

Χρήση manage_mcp_registration όταν:

  • Ο χρήστης λέει "διακομιστής MCP", "εξωτερικός διακομιστής εργαλείων", "τελικό σημείο εργαλείου τρίτου μέρους" ή "εγγραφή τελικού σημείου εργαλείου".
  • Ο χρήστης επικολλά μια διεύθυνση URL διακομιστή HTTPS και θέλει να την καταχωρήσει.
  • Ο χρήστης ζητά να διαχειριστεί, να προβάλει ή να διαμορφώσει τις ενσωματώσεις εξωτερικών εργαλείων.

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

  • Ο χρήστης αναφέρει έναν εκπρόσωπο Copilot Studio, έναν δευτερεύοντα παράγοντα ή έναν παράγοντα MCS—δρομολόγηση προς manage_copilot_studio_registration.
  • Ο χρήστης θέλει να αναθέσει σε ένα δημοσιευμένο bot—διαδρομή προς manage_copilot_studio_registration.
Εργαλείο Σχέση
save_mcp_registration Εργαλείο που καλείται από widget και διατηρεί μια νέα ή ενημερωμένη καταχώριση
delete_registration Εργαλείο που καλείται από widget και καταργεί μια καταχώριση με type: "mcp"
test_mcp_registration_connection Εργαλείο που καλείται από widget που ελέγχει τη συνδεσιμότητα σε ένα τελικό σημείο
manage_copilot_studio_registration Ισοδύναμο περιβάλλον εργασίας χρήστη διαχειριστή για εγγραφές εκπροσώπου του Copilot Studio

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

Σημείο εισόδου μόνο για ανάγνωση με δυνατότητα μετάλλαξης κατάντη.

Το ίδιο το εργαλείο δεν αλλάζει δεδομένα. Το γραφικό στοιχείο που αποδίδει καλεί save_mcp_registration, delete_registration με type: "mcp", και test_mcp_registration_connection για να εκτελέσει λειτουργίες εγγραφής.