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

Externí nástroje a podporované SDK

Lekce 3 z 12 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Tři vstupní body ke stejnému mechanismu
  2. Natívní SDK xAI
  3. Responses API kompatibilní s OpenAI
  4. Voice Agent API
  5. Co se napříč rozhraními nemění
  6. Klíčové poznatky

Tři vstupní body ke stejnému mechanismu

xAI zpřístupňuje vzdálené MCP prostřednictvím tří rozhraní. Každé cílí na jiný typ vývojáře: jedno pro nové projekty, druhé pro migrované projekty a třetí pro specifické kontexty použití. Chování MCP je ve všech třech případech naprosto stejné; mění se pouze syntaxe konfigurace a okolní nástroje. Tvá volba tedy závisí na tvém stávajícím technologickém zásobníku, nikoliv na schopnostech samotného protokolu.

Natívní SDK xAI

Toto je metoda, kterou xAI doporučuje. Poskytuje pomocnou funkci mcp(), která shrne celou konfiguraci do jediného volání funkce.

from xai_sdk import Client
from xai_sdk.tools import mcp

client = Client(api_key=os.getenv("XAI_API_KEY"))

chat = client.chat.create(
    model="grok-4.20-0309-reasoning",
    tools=[
        mcp(server_url="https://mcp.deepwiki.com/mcp")
    ],
    include=["verbose_streaming"],
)

Pomocná funkce mcp() přijímá všechny konfigurační parametry MCP – URL, štítek, popis, povolené nástroje, autentizaci – a sama se postará o jejich správné naformátování pro API. Jde o nejúspornější syntaxi a co je klíčové, o tu, u které nejméně pravděpodobně uděláš chybu, protože názvy klíčů a jejich vnoření jsou vyřešeny za tebe. Tuto cestu zvol pro nový projekt bez omezení kompatibility, pro jakékoli rychlé prototypování a kdykoliv využíváš funkce specifické pro xAI, jako je výše zmíněné podrobné streamování (verbose streaming).

Responses API kompatibilní s OpenAI

Toto rozhraní přijímá přesně formát API OpenAI. Existuje z jednoho konkrétního důvodu: aby tým, který již svou aplikaci napsal v tomto formátu, nemusel vše přepisovat, když chce vyzkoušet Grok. Změna se omezuje pouze na API klíč a základní URL.

from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input=[{"role": "user", "content": "Explain the React project"}],
    tools=[{
        "type": "mcp",
        "server_url": "https://mcp.deepwiki.com/mcp",
        "server_label": "deepwiki",
    }],
)

Zde je server MCP deklarován jako prvek pole tools s typem "mcp" a parametry jako páry klíč-hodnota ve stejném objektu. Žádná pomocná funkce: slovník píšeš ručně, což оставляет více prostoru pro překlep v názvu klíče.

Tato kompatibilita má svou cenu a měl bys ji znát dříve, než na ní začneš stavět. Dva parametry dostupné v nativním SDK zde chybí: require_approval, který ti umožňuje vyžadovat lidské schválení před spuštěním nástroje MCP, a connector_id, který spravuje konektory OpenAI. Pokud tvůj agent zpracovává citlivé operace a spoléhal jsi na manuální validaci, je toto omezení blokující a mělo by tě navést zpět k nativnímu SDK xAI. Responses API zůstává správnou volbou pro migraci z OpenAI bez přepisu kódu, pro projekty s více poskytovateli, kde střídáš Grok s jinými modely, a pro týmy již obeznámené s tímto formátem.

Voice Agent API

Třetí rozhraní je navrženo pro hlasové agenty. Typickým scénářem je telefonní asistent, který potřebuje uprostřed konverzace nahlédnout do znalostní báze, zkontrolovat stav objednávky nebo dotázat externí systém – aniž by volající zaznamenal nevysvětlitelné ticho.

Konfigurace MCP následuje stejný formát jako v ostatních SDK, se stejnými parametry server_url, server_label a dalšími. Rozdíl spočívá v tom, co se děje po volání nástroje: výsledek je integrován do toku syntézy řeči, místo aby byl vykreslen jako text. To tvaruje způsob, jakým píšeš popisy svých nástrojů a rámuješ jejich odpovědi, protože uživatel nikdy neuvidí tabulku ani seznam – pouze je uslyší.

Co se napříč rozhraními nemění

Ať už použiješ jakékoli SDK, sekvence je stejná. Grok objeví nástroje vystavené serverem MCP, vybere ten, který odpovídá požadavku, zformuluje volání se správnými parametry a následně integruje výsledek do své odpovědi. Žádné ze tří rozhraní nedělá model více či méně zdatným ve výběru nástroje.

Rozdíly tedy leží jinde: úspornost syntaxe, dostupné periferní funkce – podrobné streamování v SDK xAI, kompatibilita formátu v Responses API, syntéza řeči ve Voice Agent – a dva parametry chybějící ve formátu OpenAI. Rozhoduj se na základě těchto kritérií a neuděláš chybu.

Klíčové poznatky

  • Natívní SDK xAI s funkcí mcp() je nejjednodušší a nejkompletnější metoda
  • Responses API (formát OpenAI) usnadňuje migraci, ale nepodporuje require_approval ani connector_id
  • Voice Agent API propojuje hlasové agenty s nástroji MCP
  • Chování MCP je ve všech třech případech identické; mění se pouze syntaxe
  • Volbu proveď na základě svého stávajícího technologického zásobníku a specifických potřeb