Kombinovanie serverových a klientskych nástrojov
Na tejto strane
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:
- Použiť
web_searchna získanie informácií (automatické vykonanie na serveri) - Zavolať
save_to_databasena 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_callklientovi, 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