Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Konfigurácia viacerých serverov

Lekcia 8 z 12 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Viacero zdrojov, jeden agent
  2. Syntax: nič nové, len viacero položiek
  3. Štítky sa stávajú štrukturálnymi
  4. Ako si Grok vyberá server
  5. Kompletný agent technickej podpory
  6. Kľúčové poznatky

Viacero zdrojov, jeden agent

Remote MCP dosahuje svoj plný potenciál, keď pripojíš Grok k viacerým serverom naraz. Každý prináša svoje vlastné nástroje a model medzi nimi arbitruje na základe prichádzajúcej požiadavky. To je rozdiel medzi agentom, ktorý vie robiť jednu vec, a agentom, ktorý dokáže viesť vyšetrovanie: skontroluje stav služby, potom históriu zákazníka, následne článok o riešení problémov, a to všetko bez toho, aby si napísal jediný riadok kódu pre orchestráciu.

Syntax: nič nové, len viacero položiek

Neexistuje žiadny špeciálny režim pre viacero serverov, ktorý by bolo treba aktivovať. Jednoducho pridáš viacero objektov MCP do zoznamu 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"),
]

Rovnaký princíp platí pre Responses API vo formáte OpenAI, kde sa každý server stáva slovníkom v zozname. Táto verzia pridáva popisy, ktoré, ako uvidíš, prestávajú byť voliteľné hneď, ako použiješ viac ako jeden server.

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"
    },
]

Štítky sa stávajú štrukturálnymi

server_label, ktorý bol doteraz len pomôckou pre čitateľnosť, sa tu stáva nevyhnutným. Predstav si veľmi častý scenár: pripojíš svoju internú dokumentáciu aj DeepWiki a oba systémy vystavujú nástroj s názvom search. Bez odlišných štítkov by dva nástroje mali rovnaký názov a Grok by nemal spôsob, ako sa rozhodnúť. So štítkami deepwiki__search dopytuje dokumentáciu GitHubu, zatiaľ čo internal-docs__search vyhľadáva vo tvojej znalostnej báze – ide o dva jasne oddelené nástroje, medzi ktorými si model vyberá na základe popisov a priebehu konverzácie.

Stačia tri pravidlá, aby si sa nikdy nedostal do problémov. Každý štítok musí byť v konfigurácii jedinečný. Musí odrážať zdroj dát, nie technickú funkciu, pretože práve pôvod odlišuje servery od seba, nie to, čo robia. A musí zostať krátky, no nesmie byť zameniteľný. Nasledujúci kontrast ilustruje rozdiel medzi týmito dvoma prístupmi:

# Dobré: opisné a odlišné štítky
server_label="deepwiki"
server_label="crm"
server_label="jira"

# Zlé: nejednoznačné štítky
server_label="server1"
server_label="server2"
server_label="tools"

Štítky v druhom rade sú latentnou pascou. Fungujú v deň, keď ich napíšeš, pretože vieš, čo server1 obsahuje. O šesť mesiacov neskôr, pri čítaní záznamu o incidente, už nikto nevie, čo znamenajú – a model to, samozrejme, nikdy nevedel.

Ako si Grok vyberá server

Keď model čelí viacerým serverom, skríži štyri zdroje informácií, aby sa rozhodol. Začne požiadavkou používateľa, teda tým, čo sa skutočne žiada. Následne konzultuje server_description každého servera, čo mu hovorí, na čo každý z nich všeobecne slúži. Zíde o úroveň nižšie k názvom a popisom samotných nástrojov, pričom každý nástroj nesie svoje vlastné. A berie do úvahy kontext konverzácie, keďže predchádzajúce správy ovplyvňujú výber: ak ti klient už o tri kroky skôr poskytol svoje číslo účtu, Grok vie, že môže zavolať crm__get_customer bez toho, aby sa pýtal znova.

Z týchto štyroch zdrojov máš nad druhým najväčšiu kontrolu a práve preto sa popisy stávajú v režime s viacerými servermi kritickými. Bez popisov sa Grok spolieha len na názvy nástrojov – search oproti inému search, bez indície, čo indexujú. Chyby vo výbere, ktoré z toho vyplývajú, sú tým mätúcejšie, že pôsobia náhodne: model si vyberie správne len v polovici prípadov, čistou náhodou.

Kompletný agent technickej podpory

Táto konfigurácia spája všetko vyššie uvedené do kompletného prípadu použitia.

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"]
    ),
]

Zákazník napíše „moja služba už nefunguje“. Grok najprv skontroluje, či prebieha nejaký incident, prostredníctvom status__get_current_status, konzultuje účet zákazníka pomocou crm__get_customer, aby zistil, o ktorú službu ide, a následne vyhľadá článok o riešení problémov cez knowledge__search_articles. Táto sekvencia nie je nikde zapísaná v tvojom kóde: vyplýva z popisov a položenej otázky. Všimni si tiež, že každý server zostáva obmedzený len na operácie čítania – sila viacerých serverov nikdy neodstraňuje potrebu allowlistu.

Kľúčové poznatky

  • Pre viacero serverov odovzdaj viacero objektov MCP v zozname tools
  • Každý server musí mať jedinečný a opisný server_label
  • Hodnoty server_description sú nevyhnutné na nasmerovanie Groku na správny server
  • Grok automaticky vyberie vhodný server na základe požiadavky a kontextu
  • Obmedz nástroje každého servera pomocou allowed_tool_names, aby si minimalizoval šum