Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Többkiszolgálós konfiguráció

8. lecke 12 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Több forrás, egyetlen ügynök
  2. Szintaxis: semmi új, csak több bejegyzés
  3. A címkék strukturálissá válnak
  4. Hogyan választ kiszolgálót a Grok?
  5. Egy végpontok közötti ügyfélszolgálati ügynök
  6. Főbb megállapítások

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 tools listá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_names paraméterrel a zaj csökkentése érdekében