Mitme serveri konfiguratsioon
Sellel lehel
Mitu allikat, üks agent
Remote MCP saavutab oma täieliku potentsiaali, kui ühendad Groki korraga mitme serveriga. Igaüks toob kaasa oma tööriistad ja mudel teeb sissetuleva päringu põhjal nende vahel valiku. Just see eristab agenti, mis oskab teha ainult ühte asja, agentist, kes suudab läbi viia uurimise: kontrollida teenuse olekut, seejärel kliendi ajalugu ja lõpuks tõrkeotsingu artiklit, ilma et peaksid kirjutama ühtegi orkestreerimiskoodi rida.
Süntaks: midagi uut pole, lihtsalt mitu kirjet
Eraldiseisvat mitme serveri režiimi sisse lülitada pole vaja. Lihtsalt lisa tools loendisse mitu MCP objekti.
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"),
]
Same põhimõte kehtib OpenAI vormingus Responses API puhul, kus iga server muutub loendis olevaks sõnastikuks. Selles versioonis lisatakse kirjeldused, mida pead kasutama niipea, kui kasutad rohkem kui ühte serverit – need pole enam valikulised.
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"
},
]
Sildid muutuvad struktuurseks
server_label, mis seni oli vaid loetavuse abivahend, muutub siin hädavajalikuks. Võtame väga levinud stsenaariumi: ühendad oma sisemise dokumentatsiooni ja DeepWiki ning mõlemad pakuvad tööriista nimega search. Ilma erinevate sildita kannaksid kaks tööriista sama nime ja Grokil poleks võimalik otsustada. Siltidega päring deepwiki__search suunatakse GitHubi dokumentatsiooni, samas kui internal-docs__search otsib sinu teadmiste baasist – kaks selgelt eraldatud tööriista, mille vahel mudel valib kirjelduste ja vestluse kulgu põhjal.
Probleemide vältimiseks piisab kolmest reeglist. Iga silt peab konfiguratsioonis olema kordumatu. See peab peegeldama pigem andmeallikat kui tehnilist funktsiooni, sest päritolu eristab servereid üksteisest, mitte see, mida nad teevad. Ja see peab jääma lühikeseks, muutumata seejuures omavahel asendatavaks. Allpool olev kontrast illustreerib kahe lähenemisviisi vahelist erinevust:
# Hea: kirjeldavad ja erinevad sildid
server_label="deepwiki"
server_label="crm"
server_label="jira"
# Halb: mitmetimõistetavad sildid
server_label="server1"
server_label="server2"
server_label="tools"
Teises seerias olevad sildid on varjatud lõks. Need toimivad kirjutamise hetkel, sest tead, mida server1 sisaldab. Kuus kuud hiljem, kui loed üle intsidentide logi, ei tea seda enam keegi – ja mudel ei teadnud seda algusest peale.
Kuidas Grok serverit valib
Mitme serveriga silmitsi seistes võrdleb mudel otsuse tegemiseks nelja teabeallikat. Esiteks vaatab ta kasutaja päringut ehk seda, mida tegelikult küsitakse. Seejärel konsulteerib ta iga serveri server_description-ga, mis ütleb talle, milleks igaüks üldiselt mõeldud on. Ta liigub taseme võrra allapoole tööriistade endi nimede ja kirjeldusteni, kus iga tööriist kannab oma infot. Ja ta võtab arvesse vestluse konteksti, kuna eelmised sõnumid mõjutavad valikut: kui klient andis sulle kolm pööret tagasi oma kontonumbri, teab Grok, et võib kutsuda crm__get_customer ilma uuesti küsimata.
Nendest neljast allikast on teine see, mille üle sul on kõige rohkem kontrolli, ja just seetõttu muutuvad kirjeldused mitme serveri režiimis kriitiliseks. Ilma kirjeldusteta toetub Grok ainult tööriistade nimedele – search teise search vastu, ilma igasuguse vihjeta, mida need indekseerivad. Sellest tulenevad valikuvead on seda segasemad, kuna tunduvad juhuslikud: mudel valib pooltel juhtudel õigesti, puhtalt õnne läbi.
Terviklik tugiteenuse agent
See konfiguratsioon koondab kõik eelneva üheks terviklikuks kasutusjuhuks.
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"]
),
]
Klient kirjutab: „mu teenus ei tööta enam“. Grok kontrollib esmalt, kas käimas on intsident, kasutades status__get_current_status, seejärel vaatab kliendi kontot funktsiooniga crm__get_customer, et teada saada, millise teenusega on tegu, ja lõpuks otsib tõrkeotsingu artiklit kasutades knowledge__search_articles. See jada pole kusagil sinu koodis kirjas: see tuleneb kirjeldustest ja esitatud küsimusest. Pane tähele ka seda, et iga server jääb piiratuks oma lugemisoperatsioonidega – mitme serveri võimsus ei kaota vajadust lubatud nimekirja (allowlist) järele.
Peamised punktid
- Edasta mitme serveri kasutamiseks mitu MCP objekti
toolsloendis - Igal serveril peab olema kordumatu ja kirjeldav
server_label server_descriptionväärtused on hädavajalikud, et juhtida Grok õige serveri juurde- Grok valib automaatselt sobiva serveri, lähtudes päringust ja kontekstist
- Piira iga serveri tööriistu
allowed_tool_namesabil, et vähendada müra