Többkiszolgálós konfiguráció
Ezen az oldalon
Több forrás, egyetlen ügynök
A Remote MCP akkor éri el a teljes potenciálját, ha egyszerre több kiszolgálóhoz is csatlakoztatod a Grokot. Mindegyik kiszolgáló a saját eszközeit hozza magával, és a modell a beérkező kérés alapján dönt közöttük. Ez választja el azokat az ügynököket, amelyek csak egyetlen dologra képesek, azoktól, amelyek képesek egy teljes kivizsgálást levezetni: ellenőrzik egy szolgáltatás állapotát, majd átnézik az ügyféltörténetet, végül pedig egy hibaelhárítási cikket keresnek elő – mindezt anélkül, hogy neked egyetlen sor orchestrációs kódot kellene írnod.
Szintaxis: semmi új, csak több bejegyzés
Nincs külön „többkiszolgálós mód“, amit engedélyezned kellene. Egyszerűen több MCP objektumot adsz hozzá a tools listához.
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"),
]
Ugyanez az elv vonatkozik az OpenAI formátumú Responses API-ra is, ahol minden kiszolgáló egy-egy szótár (dictionary) lesz a listában. Ebben a verzióban leírásokat is hozzáadunk; ahogy látni fogod, ezek több kiszolgáló használata esetén már nem opcionálisak.
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"
},
]
A címkék strukturálissá válnak
A server_label, amely eddig csupán az olvashatóságot segítette, itt alapvető fontosságúvá válik. Vegyünk egy nagyon gyakori forgatókönyvet: csatlakoztatod a belső dokumentációd és a DeepWiki-t, és mindkettő exposes egy search nevű eszközt. Különálló címkék nélkül két eszköznek lenne ugyanaz a neve, és a Groknak nem lenne módja a döntésre. Címkékkel a deepwiki__search a GitHub dokumentációját kérdezi le, míg az internal-docs__search a saját tudásbázisodat keresi át – két jól elkülönített eszköz, amelyek között a modell a leírások és a beszélgetés menete alapján választ.
Három szabály elég ahhoz, hogy sose fuss problémába. Minden címkének egyedinek kell lennie a konfiguráción belül. A címkének az adatforrást kell tükröznie, nem pedig a technikai funkciót, mert a származás különbözteti meg a kiszolgálókat egymástól, nem pedig az, amit csinálnak. Végül pedig rövidnek kell maradnia, anélkül, hogy felcserélhetővé válna. Az alábbi kontraszt szemlélteti a két megközelítés közötti különbséget:
# Jó: leíró és eltérő címkék
server_label="deepwiki"
server_label="crm"
server_label="jira"
# Rossz: félreérthető címkék
server_label="server1"
server_label="server2"
server_label="tools"
A második sorozat címkéi lappangó csapdák. Azon a napon működnek, amikor megírod őket, mert te tudod, mit tartalmaz a server1. Hat hónappal később, amikor egy incidensnaplót olvasol át, már senki sem tudja – a modell pedig sosem tudta.
Hogyan választ kiszolgálót a Grok?
Több kiszolgáló esetén a modell négy információforrást vet össze a döntéshez. Először a felhasználói kérést vizsgálja, vagyis azt, amit ténylegesen kértek. Ezután megtekinti az egyes kiszolgálók server_description mezőjét, amely megmondja neki, mire szolgál az adott kiszolgáló globálisan. Egy szinttel lejjebb megy az eszközök neveihez és leírásaihoz, mivel minden eszköz hordozza a sajátját. Végül figyelembe veszi a beszélgetés kontextusát is, hiszen a korábbi üzenetek befolyásolják a kiválasztást: ha az ügyfél már három körrel korábban megadta a számlaszámát, a Grok tudja, hogy hívhatja a crm__get_customer eszközt anélkül, hogy újra kérdeznie kellene.
E négy forrás közül a másodikon van a legnagyobb kontrollod, és éppen ezért válnak a leírások kritikussá többkiszolgálós módban. Leírások nélkül a Grok kizárólag az eszköznevekre hagyatkozik – egy search szemben egy másik search-sel, bármilyen utalás nélkül arra, hogy mit indexelnek. Az ebből eredő kiválasztási hibák annál zavaróbbak, mert véletlenszerűnek tűnnek: a modell az esetek felében szerencséből választ helyesen.
Egy végpontok közötti ügyfélszolgálati ügynök
Ez a konfiguráció egy teljes használati esetben gyűjti össze a fentieket.
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"]
),
]
Amikor egy ügyfél azt írja: „nem működik a szolgáltatásom“, a Grok először ellenőrzi, van-e folyamatban lévő incidens a status__get_current_status segítségével, majd lekéri az ügyfél fiókját a crm__get_customer eszközzel, hogy megtudja, melyik szolgáltatásról van szó, végül pedig keres egy hibaelhárítási cikket a knowledge__search_articles útján. Ez a szekvencia sehol sincs megírva a kódodban: a leírásokból és a feltett kérdésből ered. Jegyezd meg azt is, hogy minden kiszolgáló továbbra is korlátozva marad a saját olvasási műveleteire – a többkiszolgálós rendszer ereje nem szünteti meg az engedélyezési lista (allowlist) szükségességét.
Főbb megállapítások
- Többkiszolgálós használathoz adj meg több MCP objektumot a
toolslistában - Minden kiszolgálónak egyedinek és leírónak kell lennie a
server_labelértékének - A
server_descriptionértékek elengedhetetlenek ahhoz, hogy a Grok a megfelelő kiszolgálót válassza - A Grok automatikusan kiválasztja a megfelelő kiszolgálót a kérés és a kontextus alapján
- Korlátozd az egyes kiszolgálók eszközeit az
allowed_tool_namesparaméterrel a zaj csökkentése érdekében