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

Kombinovanie serverových a klientskych nástrojov

Lekcia 8 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Dve kategórie nástrojov na jednej platforme
  2. Kombinovanie oboch typov v jednej požiadavke
  3. Hybridný tok
  4. Príklady z praxe
  5. Fakturácia za serverové nástroje
  6. Kľúčové poznatky

Dve kategórie nástrojov na jednej platforme

API Grok rozlišuje dva zásadne odlišné typy nástrojov na základe spôsobu ich vykonávania. Pochopenie tohto rozdielu je kľúčové pre navrhovanie robustných architektúr.

Vstavané nástroje (na strane servera)

xAI tieto nástroje vykonáva automaticky na svojich serveroch. Nič neriešiš – žiadne lokálne spúšťanie, žiadne prepieranie výsledkov. Model ich zavolá a výsledky dostane priamo.

Nástroj Identifikátor Popis
Web Search web_search Vyhľadávanie na webe v reálnom čase
X Search x_search Vyhľadávanie na sieti X/Twitter
Code Interpreter code_interpreter Vykonávanie Pythonu v pieskovisku
Collections Search collections_search Vyhľadávanie v tvojich nahraných dokumentoch
Remote MCP mcp Pripojenie k externým serverom MCP

Vlastné funkcie (na strane klienta)

Sú to tvoje vlastné funkcie definované prostredníctvom volania funkcií (function calling). Model vráti tool_call, tvoj kód funkciu vykoná a ty pošleš výsledok späť. Toto je mechanizmus, ktorý si sa naučil v predchádzajúcich lekciách.

Kombinovanie oboch typov v jednej požiadavke

Silou API Grok je možnosť miešať serverové a klientske nástroje v rámci jednej požiadavky:

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

    # Klientsky nástroj – vykonáva tvoj kód
    {
        "type": "function",
        "function": {
            "name": "save_to_database",
            "description": "Uloženie informácií do databázy",
            "parameters": {
                "type": "object",
                "properties": {
                    "key": {"type": "string"},
                    "value": {"type": "string"}
                },
                "required": ["key", "value"]
            }
        }
    }
]

Keď model dostane túto požiadavku, môže:

  1. Použiť web_search na získanie informácií (automatické vykonanie na serveri)
  2. Zavolať save_to_database na uloženie výsledku (vráti sa klientovi)

Hybridný tok

Správanie sa líši podľa typu nástroja:

  • Serverový nástroj: model nástroj zavolá, xAI ho vykoná, výsledok sa automaticky integruje a model pokračuje ďalej.
  • Klientsky nástroj: model vráti tool_call klientovi, vykonávanie sa zastaví a pokračuje až potom, čo pošleš výsledok späť.

Keď model použije oba typy v tej istej požiadavke, serverové nástroje sa vykonajú ako prvé (bez tvojho zásahu). Následne, ak model potrebuje aj klientsky nástroj, vráti ti tool_call už s výsledkami zo serverových nástrojov integrovanými v jeho kontexte.

Príklady z praxe

Vyhľadávanie na webe + business logika

# Používateľ sa pýta: "Nájdi cenu Bitcoinu a ulož ju"
# Model:
# 1. Zavolá web_search na zistenie ceny (serverová strana, automaticky)
# 2. Zavolá save_price(symbol="BTC", price=68432) (klientska strana)

Vyhľadávanie na X + notifikácia

# "Upozorni ma na tweety o našom produkte od včerajška"
# Model:
# 1. Zavolá x_search na nájdenie tweetov (serverová strana)
# 2. Zavolá send_notification(count=12, summary="...") (klientska strana)

Code Interpreter + úložisko

# "Vypočítaj priemer týchto dát a ulož výsledok"
# Model:
# 1. Zavolá code_interpreter na výpočet (serverová strana)
# 2. Zavolá save_result(key="avg", value="42.5") (klientska strana)

Fakturácia za serverové nástroje

Vstavané nástroje sa fakturujú dvoma spôsobmi:

  • Tokeny: štandardná spotreba (vstup + výstup)
  • Volania: fixná cena za každé volanie nástroja

Model môže pre jednu požiadavku zavolať viacero serverových nástrojov – náklady sa sčítavajú. Maj to na pamäti, keď povoľuješ web_search: model môže vykonať viacero vyhľadávaní, aby spresnil svoje výsledky.

Kľúčové poznatky

  • Dva typy nástrojov: serverové (automatické) a klientske (volanie funkcií)
  • Serverové nástroje (web_search, x_search, code_interpreter) sa vykonávajú bez tvojho zásahu
  • Oba typy môžeš kombinovať v jednej požiadavke
  • Serverové nástroje sa vykonajú ako prvé, následne môže model zavolať tvoje funkcie
  • Každé volanie serverového nástroja sa fakturuje (tokeny + poplatok za volanie)
  • Citácie sa pre dáta zo serverových nástrojov generujú automaticky