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

Kombinování serverových a klientských nástrojů

Lekce 8 z 14 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Dvě kategorie nástrojů na jedné platformě
  2. Kombinace obou typů v jediném požadavku
  3. Hybridní tok
  4. Příklady z praxe
  5. Fakturace serverových nástrojů
  6. Klíčové poznatky

Dvě kategorie nástrojů na jedné platformě

API Grok rozlišuje dva zásadně odlišné typy nástrojů na základě jejich spouštění. Pochopení tohoto rozdílu je klíčové pro navrhování robustních architektur.

Vestavěné nástroje (na straně serveru)

xAI tyto nástroje spouští automaticky na svých serverech. Ničeho se nemusíš ujmout – žádné lokální spouštění, žádné přeposílání výsledků. Model je zavolá a výsledky obdrží přímo.

Nástroj Identifikátor Popis
Web Search web_search Vyhledávání na webu v reálném čase
X Search x_search Vyhledávání na síti X/Twitter
Code Interpreter code_interpreter Spouštění Pythonu v izolovaném prostředí (sandbox)
Collections Search collections_search Vyhledávání v nahraných dokumentech
Remote MCP mcp Připojení k externím serverům MCP

Vlastní funkce (na straně klienta)

Jedná se o tvé vlastní funkce definované prostřednictvím volání funkcí (function calling). Model vrátí tool_call, tvůj kód funkci spustí a ty odešleš výsledek zpět. Tento mechanismus jsi se naučil v předchozích lekcích.

Kombinace obou typů v jediném požadavku

Síla API Grok spočívá ve schopnosti míchat serverové a klientské nástroje v rámci jednoho požadavku:

tools = [
    # Serverový nástroj – automaticky spustí xAI
    {"type": "web_search"},

    # Klientský nástroj – spustí tvůj kód
    {
        "type": "function",
        "function": {
            "name": "save_to_database",
            "description": "Uložení informací do databáze",
            "parameters": {
                "type": "object",
                "properties": {
                    "key": {"type": "string"},
                    "value": {"type": "string"}
                },
                "required": ["key", "value"]
            }
        }
    }
]

Když model tento požadavek obdrží, může:

  1. Použít web_search k nalezení informací (automatické spuštění na serveru)
  2. Zavolat save_to_database pro uložení výsledku (vráceno klientovi)

Hybridní tok

Chování se liší podle typu nástroje:

  • Serverový nástroj: model nástroj zavolá, xAI jej spustí, výsledek se automaticky integruje a model pokračuje.
  • Klientský nástroj: model vrátí tool_call klientovi, provádění se zastaví a obnoví se až poté, co odešleš výsledek zpět.

Pokud model využije oba typy ve stejném požadavku, serverové nástroje se spustí jako první (bez tvého zásahu). Následně, pokud model potřebuje také klientský nástroj, vrátí ti tool_call s výsledky ze serverových nástrojů již integrovanými v jeho kontextu.

Příklady z praxe

Vyhledávání na webu + obchodní logika

# Uživatel se ptá: "Najdi cenu Bitcoinu a ulož ji"
# Model:
# 1. Zavolá web_search pro zjištění ceny (serverová strana, automaticky)
# 2. Zavolá save_price(symbol="BTC", price=68432) (klientská strana)

Vyhledávání na X + oznámení

# "Upozorni mě na tweety o našem produktu od včerejška"
# Model:
# 1. Zavolá x_search pro nalezení tweetů (serverová strana)
# 2. Zavolá send_notification(count=12, summary="...") (klientská strana)

Code Interpreter + úložiště

# "Vypočítej průměr těchto dat a ulož výsledek"
# Model:
# 1. Zavolá code_interpreter pro výpočet (serverová strana)
# 2. Zavolá save_result(key="avg", value="42.5") (klientská strana)

Fakturace serverových nástrojů

Vestavěné nástroje jsou fakturovány dvěma způsoby:

  • Tokeny: standardní spotřeba (vstup + výstup)
  • Volání (Invocations): fixní náklady za každé volání nástroje

Model může pro jeden požadavek zavolat více serverových nástrojů – náklady se sčítají. Měj to na paměti, když povolíš web_search: model může provést více vyhledávání, aby zpřesnil své výsledky.

Klíčové poznatky

  • Dva typy nástrojů: serverové (automatické) a klientské (volání funkcí)
  • Serverové nástroje (web_search, x_search, code_interpreter) se spouštějí bez tvého zásahu
  • Obě typy můžeš kombinovat v jediném požadavku
  • Serverové nástroje se spustí jako první, poté může model zavolat tvé funkce
  • Každé spuštění serverového nástroje je zpoplatněno (tokeny + náklady za volání)
  • Citace jsou pro data ze serverových nástrojů generovány automaticky