Konfigurācija vairākiem serveriem
Šajā lapā
Vairāki avoti, viens aģents
Attālinātais MCP pilnībā atklāj savu potenciālu, kad vienlaikus pieslēdz Grok vairākiem serveriem. Katrs no tiem nodrošina savus rīkus, un modelis, ņemot vērā saņemto pieprasījumu, izvēlas starp tiem. Tieši tas atšķir aģentu, kas spēj veikt tikai vienu darbību, no aģenta, kas spēj veikt izmeklēšanu: pārbaudīt servisa statusu, tad klienta vēsturi, pēc tam atrast problēmu novēršanas rakstu, un tev nav jāuzraksta neviena orķestrācijas koda rinda.
Sintakse: nekas jauns, tikai vairāki ieraksti
Nav jāaktivizē nekāds īpašs režīms darbam ar vairākiem serveriem. Tev vienkārši jāpievieno vairāki MCP objekti sarakstam 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"),
]
Tas pats princips attiecas uz Responses API OpenAI formātā, kur katrs serveris kļūst par vārdnīcu sarakstā. Šajā versijā tiek pievienoti apraksti, kas, kā drīz pamanīsi, vairs nav izvēles iespēja, tiklīdz izmanto vairāk nekā vienu serveri.
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"
},
]
Etiķetes kļūst par struktūras pamatu
Līdz šim server_label kalpoja tikai lasāmības uzlabošanai, taču šeit tā kļūst obligāta. Iedomājies ļoti izplatītu scenāriju: tu pieslēdz savu iekšējo dokumentāciju un DeepWiki, un abi eksponē rīku ar nosaukumu search. Bez atšķirīgām etiķetēm diviem rīkiem būtu vienāds nosaukums, un Grok nevarētu izdarīt izvēli. Ar etiķetēm deepwiki__search veic vaicājumu GitHub dokumentācijā, bet internal-docs__search meklē tavā zināšanu bāzē – tie ir divi skaidri nodalīti rīki, starp kuriem modelis izvēlas, balstoties uz aprakstiem un sarunas gaitu.
Lai nekad nerastos problēmas, pietiek ievērot trīs noteikumus. Katrai etiķetei konfigurācijā jābūt unikālai. Tai jāatspoguļo datu avots, nevis tehniskā funkcija, jo tieši izcelsme atšķir serverus cits no cita, nevis to, ko tie dara. Tai arī jābūt īsai, bet ne savstarpēji aizvietojamai. Zemāk redzamais kontrasts ilustrē atšķirību starp abām pieejām:
# Labi: aprakstošas un atšķirīgas etiķetes
server_label="deepwiki"
server_label="crm"
server_label="jira"
# Slikti: neskaidras etiķetes
server_label="server1"
server_label="server2"
server_label="tools"
Otrās sērijas etiķetes ir slazds. Tās strādā tajā dienā, kad tās uzraksti, jo tu zini, ko satur server1. Sešus mēnešus vēlāk, pārlasot incidentu žurnālu, neviens vairs nezina – un pats modelis to nekad nav zinājis.
Kā Grok izvēlas serveri
Saskaroties ar vairākiem serveriem, modelis salīdzina četrus informācijas avotus, lai pieņemtu lēmumu. Tas sākas ar lietotāja pieprasījumu, proti, ar to, kas tieši tiek prasīts. Tad tas aplūko katra servera server_description, kas norāda, kam katrs no tiem kopumā ir paredzēts. Tas nolaižas vienu līmeni zemāk līdz pašu rīku nosaukumiem un aprakstiem, jo katram rīkam ir savi. Un tas ņem vērā sarunas kontekstu, jo iepriekšējie ziņojumi ietekmē izvēli: ja klients jau pirms trim replikām ir norādījis savu konta numuru, Grok zina, ka var izsaukt crm__get_customer, nejautājot to atkārtoti.
No šiem četriem avotiem otrais ir tas, kuru tu vari visvairāk kontrolēt, un tieši tāpēc apraksti kļūst kritiski svarīgi režīmā ar vairākiem serveriem. Bez aprakstiem Grok paļaujas tikai uz rīku nosaukumiem – search pret citu search, bez norādes, ko tie indeksē. No tā izrietošās kļūdas izvēlē ir jo mulsinošākas, ka šķiet nejaušas: modelis pusē gadījumu izvēlas pareizi, vienkārši veiksmes dēļ.
Pilna cikla atbalsta aģents
Šī konfigurācija apvieno visu iepriekš minēto vienotā lietojuma gadījumā.
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"]
),
]
Klients raksta: „mans serviss vairs nedarbojas”. Grok vispirms pārbauda, vai nav notiekoša incidenta, izmantojot status__get_current_status, tad aplūko klienta kontu ar crm__get_customer, lai uzzinātu, par kuru servisu ir runa, un visbeidzot meklē problēmu novēršanas rakstu, izmantojot knowledge__search_articles. Šī secība nav ierakstīta tavā kodā: tā izriet no aprakstiem un uzdotā jautājuma. Ņem vērā arī to, ka katrs serveris joprojām ir ierobežots tikai ar lasīšanas operācijām – vairāku serveru iespējas nekad neatceļ nepieciešamību pēc atļauto rīku saraksta (allowlist).
Galvenās atziņas
- Lai strādātu ar vairākiem serveriem, sarakstā
toolsnorādi vairākus MCP objektus - Katram serverim jābūt unikālai un aprakstošai
server_label server_descriptionvērtības ir obligātas, lai virzītu Grok pie pareizā servera- Grok automātiski izvēlas atbilstošo serveri, balstoties uz pieprasījumu un kontekstu
- Ierobežo katra servera rīkus ar
allowed_tool_names, lai samazinātu troksni