Διαμόρφωση πολλαπλών διακομιστών
Σε αυτήν τη σελίδα
Πολλαπλές πηγές, ένας μόνο πράκτορας
Το Remote MCP αποδίδει στο έπακρο όταν συνδέετε το Grok με πολλαπλούς διακομιστές ταυτόχρονα. Κάθε διακομιστής φέρνει τα δικά του εργαλεία και το μοντέλο κάνει διαιτησία μεταξύ τους με βάση το εισερχόμενο αίτημα. Αυτό είναι που ξεχωρίζει έναν πράκτορα που μπορεί να κάνει ένα μόνο πράγμα από έναν πράκτορα ικανό να διεξάγει μια έρευνα: έλεγχος της κατάστασης μιας υπηρεσίας, στη συνέχεια του ιστορικού ενός πελάτη και έπειτα ενός άρθρου αντιμετώπισης προβλημάτων, χωρίς εσείς να γράφετε ούτε μία γραμμή κώδικα ενορχήστρωσης.
Σύνταξη: τίποτα νέο, απλώς πολλαπλές εγγραφές
Δεν υπάρχει κάποια ειδική λειτουργία πολλαπλών διακομιστών που πρέπει να ενεργοποιήσετε. Απλώς προσθέτετε πολλαπλά αντικείμενα MCP στη λίστα tools.
from xai_sdk.tools import mcp
tools = [
mcp(server_url="https://mcp.deepwiki.com/mcp", server_label="deepwiki"),
mcp(server_url="https://your-custom-tools.com/mcp", server_label="custom"),
mcp(server_url="https://api.example.com/tools", server_label="api-tools"),
]
Η ίδια αρχή ισχύει για το Responses API σε μορφή OpenAI, όπου κάθε διακομιστής γίνεται ένα λεξικό μέσα στη λίστα. Σε αυτή την έκδοση προστίθενται περιγραφές, οι οποίες, όπως θα δείτε, παύουν να είναι προαιρετικές μόλις χρησιμοποιήσετε περισσότερους από έναν διακομιστές.
tools = [
{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki",
"server_description": "Documentation for GitHub open-source projects"
},
{
"type": "mcp",
"server_url": "https://your-custom-tools.com/mcp",
"server_label": "custom",
"server_description": "Internal company tools"
},
{
"type": "mcp",
"server_url": "https://api.example.com/tools",
"server_label": "api-tools",
"server_description": "Data and analytics API"
},
]
Οι ετικέτες γίνονται δομικές
Το server_label, που μέχρι τώρα λειτουργούσε ως βοήθημα αναγνωσιμότητας, εδώ καθίσταται απαραίτητο. Σκεφτείτε ένα πολύ συνηθισμένο σενάριο: συνδέετε την εσωτερική σας τεκμηρίωση και το DeepWiki, και και τα δύο εκθέτουν ένα εργαλείο με το όνομα search. Χωρίς διακριτικές ετικέτες, δύο εργαλεία έχουν το ίδιο όνομα και το Grok δεν έχει τρόπο να αποφασίσει. Με τις ετικέτες, το deepwiki__search κάνει ερώτημα στην τεκμηρίωση του GitHub, ενώ το internal-docs__search αναζητά στη βάση γνώσεών σας — δύο σαφώς διαχωρισμένα εργαλεία μεταξύ των οποίων το μοντέλο επιλέγει με βάση τις περιγραφές και τη ροή της συνομιλίας.
Τρεις κανόνες αρκούν για να μην αντιμετωπίσετε ποτέ πρόβλημα. Κάθε ετικέτα πρέπει να είναι μοναδική στη διαμόρφωση. Πρέπει να αντανακλά την πηγή δεδομένων και όχι την τεχνική λειτουργία, διότι η προέλευση είναι που διαχωρίζει τους διακομιστές μεταξύ τους, όχι το τι κάνουν. Και πρέπει να παραμένει σύντομη χωρίς να γίνεται interchangeable. Η αντίθεση παρακάτω απεικονίζει το χάσμα μεταξύ των δύο προσεγγίσεων:
# Good: descriptive and distinct labels
server_label="deepwiki"
server_label="crm"
server_label="jira"
# Bad: ambiguous labels
server_label="server1"
server_label="server2"
server_label="tools"
Οι ετικέτες στη δεύτερη σειρά αποτελούν λανθάνουσα παγίδα. Λειτουργούν την ημέρα που τις γράφετε, επειδή εσείς ξέρετε τι περιέχει το server1. Έξι μήνες αργότερα, όταν διαβάζετε ξανά ένα αρχείο συμβάντων, κανείς δεν θυμάται πια — και το μοντέλο, από την πλευρά του, δεν το έμαθε ποτέ.
Πώς επιλέγει ο διακομιστής το Grok
Αντιμέτωπο με πολλαπλούς διακομιστές, το μοντέλο διασταυρώνει τέσσερις πηγές πληροφοριών για να αποφασίσει. Ξεκινά από το αίτημα του χρήστη, δηλαδή από το τι ζητείται πραγματικά. Στη συνέχεια συμβουλεύεται το server_description κάθε διακομιστή, το οποίο του λέει σε τι χρησιμεύει ο καθένας συνολικά. Κατεβαίνει ένα επίπεδο χαμηλότερα, στα ονόματα και τις περιγραφές των ίδιων των εργαλείων, καθώς κάθε εργαλείο φέρει τις δικές του. Και λαμβάνει υπόψη το πλαίσιο της συνομιλίας, αφού τα προηγούμενα μηνύματα επηρεάζουν την επιλογή: αν ο πελάτης σας έχει ήδη δώσει τον αριθμό λογαριασμού του τρεις γύρους νωρίτερα, το Grok γνωρίζει ότι μπορεί να καλέσει το crm__get_customer χωρίς να το ζητήσει ξανά.
Από αυτές τις τέσσερις πηγές, η δεύτερη είναι αυτή over την οποία έχετε τον μεγαλύτερο έλεγχο, και ακριβώς γι’ αυτό οι περιγραφές καθίστανται κρίσιμες στη λειτουργία πολλαπλών διακομιστών. Χωρίς περιγραφές, το Grok βασίζεται αποκλειστικά στα ονόματα των εργαλείων — ένα search απέναντι σε ένα άλλο search, χωρίς καμία ένδειξη για το τι ευρετηριάζουν. Τα σφάλματα επιλογής που προκύπτουν είναι ακόμη πιο συγχυτικά επειδή φαίνονται τυχαία: το μοντέλο επιλέγει σωστά τις μισές φορές, κατά τύχη.
Ένας πράκτορας υποστήριξης end-to-end
Αυτή η διαμόρφωση συγκεντρώνει όλα τα παραπάνω σε μια ολοκληρωμένη περίπτωση χρήσης.
tools = [
mcp(
server_url="https://kb.monentreprise.com/mcp",
server_label="knowledge",
server_description="Product knowledge base. Help articles, FAQ, troubleshooting guides.",
allowed_tool_names=["search_articles", "get_article"]
),
mcp(
server_url="https://crm.monentreprise.com/mcp",
server_label="crm",
server_description="CRM. Customer history, previous tickets, account information.",
authorization=f"Bearer {os.getenv('CRM_TOKEN')}",
allowed_tool_names=["get_customer", "search_tickets", "get_ticket"]
),
mcp(
server_url="https://status.monentreprise.com/mcp",
server_label="status",
server_description="Service status. Ongoing incidents, scheduled maintenance.",
allowed_tool_names=["get_current_status", "list_incidents"]
),
]
Ένας πελάτης γράφει «η υπηρεσία μου δεν λειτουργεί πια». Το Grok ελέγχει πρώτα αν υπάρχει κάποιο ενεργό συμβάν μέσω του status__get_current_status, συμβουλεύεται τον λογαριασμό του πελάτη με το crm__get_customer για να μάθει ποια υπηρεσία πρόκειται και έπειτα αναζητά ένα άρθρο αντιμετώπισης προβλημάτων μέσω του knowledge__search_articles. Αυτή η ακολουθία δεν είναι γραμμένη πουθενά στον κώδικά σας: πηγάζει από τις περιγραφές και την ερώτηση που τέθηκε. Σημειώστε επίσης ότι κάθε διακομιστής παραμένει περιορισμένος στις δικές του λειτουργίες ανάγνωσης — η δύναμη των πολλαπλών διακομιστών δεν καταργεί ποτέ την ανάγκη για μια λίστα επιτρεπόμενων εργαλείων (allowlist).
Βασικά σημεία
- Περάστε πολλαπλά αντικείμενα MCP στη λίστα
toolsγια πολλαπλούς διακομιστές - Κάθε διακομιστής πρέπει να έχει ένα μοναδικό και περιγραφικό
server_label - Οι τιμές
server_descriptionείναι απαραίτητες για να καθοδηγήσουν το Grok στον σωστό διακομιστή - Το Grok επιλέγει αυτόματα τον κατάλληλο διακομιστή με βάση το αίτημα και το πλαίσιο
- Περιορίστε τα εργαλεία κάθε διακομιστή με το
allowed_tool_namesγια να μειώσετε τον θόρυβο