Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Konfigurace více serverů

Lekce 8 z 12 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Více zdrojů, jediný agent
  2. Syntaxe: nic nového, jen více položek
  3. Popisky se stávají strukturálními
  4. Jak Grok vybírá server
  5. Kompletní agent pro podporu
  6. Klíčové poznatky

Více zdrojů, jediný agent

Remote MCP dosahuje svého plného potenciálu, když připojíte Grok k více serverům najednou. Každý z nich přináší vlastní nástroje a model mezi nimi arbitruje na základě příchozího požadavku. To je přesně to, co odlišuje agenta schopného只做 jedné věci od agenta, který dokáže vést vyšetřování: zkontroluje stav služby, poté historii zákazníka a následně článek pro řešení problémů, aniž byste museli napsat jediný řádek orchestračného kódu.

Syntaxe: nic nového, jen více položek

Neexistuje žádný speciální režim pro více serverů, který byste museli aktivovat. Jednoduše přidáte více objektů MCP do seznamu 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"),
]

Stejný princip platí pro Responses API ve formátu OpenAI, kde se každý server stane slovníkem v seznamu. Tato verze přidává popisy, které uvidíte, že již nejsou volitelné, jakmile použijete více než 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"
    },
]

Popisky se stávají strukturálními

server_label, který byl doposud pouze pomůckou pro čitelnost, se zde stává nezbytným. Vezměme si velmi častý scénář: připojíte svou interní dokumentaci a DeepWiki a oba exposingují nástroj s názvem search. Bez odlišných popisků by dva nástroje nesly stejné jméno a Grok by neměl způsob, jak se rozhodnout. Díky popiskům deepwiki__search dotazuje dokumentaci GitHubu, zatímco internal-docs__search prohledává vaši znalostní bázi – dva jasně oddělené nástroje, mezi nimiž model vybírá na základě popisů a průběhu konverzace.

K tomu, abyste se nikdy nedostali do problémů, stačí dodržovat tři pravidla. Každý popisek musí být v konfiguraci jedinečný. Musí odrážet zdroj dat spíše než technickou funkci, protože právě původ odlišuje servery od sebe, nikoliv to, co dělají. A musí zůstat stručný, aniž by se stal zaměnitelným. Následující kontrast ilustruje rozdíl mezi oběma přístupy:

# Dobře: popisné a odlišné popisky
server_label="deepwiki"
server_label="crm"
server_label="jira"

# Špatně: nejednoznačné popisky
server_label="server1"
server_label="server2"
server_label="tools"

Popisky ve druhé sérii jsou latentní pastí. Fungují v den, kdy je napíšete, protože víte, co server1 obsahuje. O šest měsíců později, při pročítání záznamu o incidentu, už to nikdo neví – a model to ostatně nikdy nevěděl.

Jak Grok vybírá server

Při confronted s více servery model zkříží čtyři zdroje informací, aby se rozhodl. Začne uživatelským požadavkem, tedy tím, co je skutečně žádáno. Následně konzultuje server_description každého serveru, který mu říká, k čemu každý z nich obecně slouží. Jde o úroveň níže k názvům a popisům samotných nástrojů, přičemž každý nástroj nese své vlastní. A bere v úvahu kontext konverzace, protože předchozí zprávy ovlivňují výběr: pokud vám klient již před třemi kroky sdělil své číslo účtu, Grok ví, že může zavolat crm__get_customer, aniž by se znovu ptal.

Z těchto čtyř zdrojů máte nad druhým největší kontrolu, a právě proto se popisy stávají v režimu více serverů kritickými. Bez popisů se Grok spoléhá pouze na názvy nástrojů – search proti dalšímu search, bez jakékoli indikace toho, co indexují. Chyby ve výběru, které z toho vyplývají, jsou tím matoucí, že působí náhodně: model vybírá správně jen polovinu času, čistě díky štěstí.

Kompletní agent pro podporu

Tato konfigurace spojuje vše výše uvedené do úplného případu použití.

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 „moje služba již nefunguje“. Grok nejprve zkontroluje, zda probíhá nějaký incident, prostřednictvím status__get_current_status, konzultuje účet zákazníka pomocí crm__get_customer, aby zjistil, o jakou službu jde, a následně vyhledá článek pro řešení problémů přes knowledge__search_articles. Tato sekvence není nikde zapsána ve vašem kódu: vyplývá z popisů a položené otázky. Všimněte si také, že každý server zůstává omezen na své operace čtení – síla více serverů nikdy neodstraňuje potřebu allowlistu.

Klíčové poznatky

  • Pro více serverů předejte více objektů MCP v seznamu tools
  • Každý server musí mít jedinečný a popisný server_label
  • Hodnoty server_description jsou nezbytné pro nasměrování Groku na správný server
  • Grok automaticky vybírá vhodný server na základě požadavku a kontextu
  • Omezte nástroje každého serveru pomocí allowed_tool_names, abyste minimalizovali šum