Περιγραφή και επιτρεπόμενα εργαλεία
Σε αυτήν τη σελίδα
Δύο προαιρετικοί μοχλοί, δύο πολύ διαφορετικά αποτελέσματα
Το URL και η ετικέτα αρκούν για να establish τη σύνδεση, αλλά δεν λένε στο Grok πώς να χρησιμοποιήσει τον διακομιστή. Δύο προαιρετικές παράμετροι καλύπτουν αυτό το κενό και αλληλοσυμπληρώνονται: το server_description εξηγεί σε τι χρησιμεύει ο διακομιστής, ενώ το allowed_tools—ή allowed_tool_names ανάλογα με το SDK—αποφασίζει τι επιτρέπεται να αγγίξει. Το πρώτο καθοδηγεί, το δεύτερο περιορίζει.
server_description: δώστε πλαίσιο στο μοντέλο
Αυτή η παράμετρος παρέχει στο Grok μια περιγραφή σε φυσική γλώσσα των δυνατοτήτων του διακομιστή. Το μοντέλο τη χρησιμοποιεί για να αποφασίσει: πρέπει να κάνει ερώτημα σε αυτόν τον διακομιστή, σε κάποιον άλλον ή σε κανέναν;
mcp(
server_url="https://api.example.com/mcp",
server_label="docs",
server_description="Διακομιστής τεχνικής τεκμηρίωσης. Σας επιτρέπει να αναζητάτε άρθρα, να συμβουλεύεστε οδηγούς και να λαμβάνετε παραδείγματα κώδικα για το εσωτερικό API."
)
Χωρίς αυτή την περιγραφή, το Grok έχει μόνο τα μεμονωμένα ονόματα και τις περιγραφές των εκτεθειμένων εργαλείων. Λειτουργεί, αλλά το μοντέλο συλλογίζεται χωρίς τη μεγάλη εικόνα: βλέπει μια συλλογή εργαλείων χωρίς να γνωρίζει τι σχηματίζουν συλλογικά. Μια καλή περιγραφή του προσφέρει τρία πράγματα που κανένα όνομα εργαλείου δεν μπορεί να μεταδώσει: πότε είναι σχετικός αυτός ο διακομιστής και όχι κάποιος άλλος, τον τύπο των αιτημάτων που πρέπει να δρομολογηθούν εκεί και—συχνά παραβλεπόμενο, συχνά καθοριστικό—τι δεν κάνει ο διακομιστής, γεγονός που αποφεύγει κλήσεις καταδικασμένες να αποτύχουν.
Γράψτε αυτή την περιγραφή σαν να εξηγούσατε την υπηρεσία σε έναν συνάδελφο που joins στο project. Να είστε συγκεκριμένοι: «Βάση δεδομένων τεχνικής τεκμηρίωσης προϊόντος» είναι χρήσιμη, ενώ απλώς «Τεκμηρίωση» όχι. Ονομάστε τις ενέργειες που είναι πραγματικά εφικτές, όπως «σας επιτρέπει να αναζητάτε, να διαβάζετε και να ενημερώνετε tickets». Και αν το πεδίο εφαρμογής είναι περιορισμένο, δηλώστε το ξεκάθαρα: «πρόσβαση μόνο για ανάγνωση, χωρίς τροποποιήσεις» θα γλιτώσει το μοντέλο από μια αποτυχημένη προσπάθεια.
allowed_tools: στενέψτε το πεδίο εφαρμογής
Εξ ορισμού, η σύνδεση του Grok σε έναν διακομιστή MCP injectάρει όλα τα εργαλεία που εκθέτει εκείνος ο διακομιστής στο context του μοντέλου, χωρίς εξαίρεση. Σε ένα CRM, αυτό σημαίνει ότι η δημιουργία, η τροποποίηση και η διαγραφή επαφών είναι προσβάσιμες ακριβώς όπως η αναζήτηση.
mcp(server_url="https://api.example.com/mcp",
server_label="crm")
# Το Grok βλέπει ΟΛΑ τα εργαλεία: create_contact, update_contact,
# delete_contact, search_contacts, export_data, κ.λπ.
Η παράμετρος allowed_tool_names αντιστρέφει αυτή τη συμπεριφορά θεσπίζοντας μια ρητή λίστα επιτρεπόμενων (whitelist). Οτιδήποτε δεν βρίσκεται σε αυτή γίνεται αόρατο για το μοντέλο.
mcp(server_url="https://api.example.com/mcp",
server_label="crm",
allowed_tool_names=["search_contacts", "get_contact_details"])
# Το Grok βλέπει μόνο τα search_contacts και get_contact_details
Γιατί να περιορίσετε, ακόμα και όταν όλα λειτουργούν
Ο πρώτος λόγος είναι η ασφάλεια και ακολουθεί την αρχή του ελάχιστου προνομίου. Αν η εφαρμογή σας χρειάζεται μόνο ανάγνωση, μην αφήνετε εργαλεία τροποποίησης ή διαγραφής στην εμβέλεια του μοντέλου. Μια επιτυχής ένεση prompt—μια κακόβουλη οδηγία που γλιστρά σε ένα έγγραφο που αναλύει το Grok—δεν μπορεί να ενεργοποιήσει ένα delete_contact που δεν εκτέθηκε ποτέ. Η λίστα επιτρεπόμενων μετατρέπει ένα πιθανό περιστατικό σε μη γεγονός.
# Μόνο για ανάγνωση για ένα δημόσιο chatbot
allowed_tool_names=["search_database", "get_record", "format_data"]
Ο δεύτερος λόγος είναι η απόδοση. Κάθε εκτεθειμένο εργαλείο καταλαμβάνει χώρο στο παράθυρο context, καθώς το όνομα, η περιγραφή και το σχήμα παραμέτρων του πρέπει να χωρέσουν εκεί. Ένας διακομιστής MCP που δημοσιεύει πενήντα εργαλεία καταναλώνει σημαντικό όγκο πριν καν ο χρήστης κάνει την ερώτησή του. Μειώνοντας τον αριθμό σε πέντε πραγματικά χρήσιμα εργαλεία, ανακτάτε αυτόν τον χώρο για αυτό που έχει σημασία: την ίδια τη συνομιλία.
Ο τρίτος λόγος είναι η ακρίβεια. Όσο πιο εκτεταμένος είναι ο κατάλογος, τόσο περισσότερο διστάζει το μοντέλο μεταξύ παρόμοιων εργαλείων—και δύο εργαλεία με παρόμοιες περιγραφές παράγουν ασταθείς επιλογές από την μία εκτέλεση στην άλλη. Ένας κατάλογος σφιχτά προσαρμοσμένος στη χρήση σας κάνει την επιλογή σημαντικά πιο αξιόπιστη.
Κάντε τα δύο να λειτουργήσουν μαζί
Το αποτέλεσμα γίνεται πραγματικά καθαρό όταν συνδυάζετε και τις δύο παραμέτρους, υπό την προϋπόθεση ότι αφηγούνται την ίδια ιστορία.
mcp(
server_url="https://api.example.com/mcp",
server_label="crm",
server_description="CRM μόνο για ανάγνωση. Αναζήτηση και προβολή επαφών και εταιρειών.",
allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)
Εδώ, η περιγραφή ανακοινώνει πρόσβαση μόνο για ανάγνωση και η λίστα επιτρεπόμενων το εγγυάται τεχνικά. Προσοχή στην αντίθετη κατάσταση, η οποία συμβαίνει συχνότερα από όσο νομίζετε: μια περιγραφή κληρονομημένη από μια προηγούμενη έκδοση που υπόσχεται δυνατότητες εγγραφής, οι οποίες έχουν πλέον αφαιρεθεί από τη λίστα επιτρεπόμενων. Το μοντέλο θα επιχειρήσει την κλήση, θα αποτύχει και εσείς θα χάσετε χρόνο κυνηγώντας ένα bug που δεν υπάρχει. Αναθεωρείτε πάντα αυτές τις δύο παραμέτρους μαζί, ποτέ χωριστά.
Βασικά σημεία
- Το
server_descriptionβοηθά το Grok να καταλάβει πότε να χρησιμοποιήσει αυτόν τον διακομιστή MCP - Χωρίς το
allowed_tools, όλα τα εργαλεία του διακομιστή injectάρονται στο context - Ο περιορισμός των εργαλείων ενισχύει την ασφάλεια, την απόδοση και την ακρίβεια
- Συνδυάστε την περιγραφή και τον περιορισμό για βέλτιστο έλεγχο
- Γράψτε την περιγραφή ως μια εξήγηση σε φυσική γλώσσα των δυνατοτήτων του διακομιστή