Kombinování serverových a klientských nástrojů
Na této stránce
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:
- Použít
web_searchk nalezení informací (automatické spuštění na serveru) - Zavolat
save_to_databasepro 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_callklientovi, 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