Dve kategórie nástrojov Grok
Na tejto strane
Pochopte ekosystém nástrojov API Grok
API Grok robí viac než len generovanie textu. Poskytuje súbor nástrojov, ktoré umožňujú modelu interagovať s vonkajším svetom: vyhľadávať informácie v reálnom čase, analyzovať údaje na sociálnych sieťach alebo spúšťať kód v Pythone. Aby si tieto schopnosti využil, musíš pochopiť, ako sú organizované.
API Grok rozlišuje dve základné kategórie nástrojov. Toto rozlíšenie určuje, kto nástroj vykonáva, kde prebieha spracovanie a čo musíš ako vývojár riadiť.
Vstavané nástroje – na strane servera
Vstavané nástroje bežia priamo na serveroch xAI. Keď sa model rozhodne použiť jeden z týchto nástrojov, exekúcia je automatická a transparentná. Nemusíš spravovať žiadnu infraštruktúru ani spracovávať priebežné výsledky.
Tu je päť dostupných vstavaných nástrojov:
- Web Search (
web_search): Vyhľadávanie na webe v reálnom čase s filtrovaním domén a automatickým citovaním zdrojov - X Search (
x_search): Vyhľadávanie na sieti X/Twitter s filtrovaním podľa účtu a dátumu - Code Execution (
code_interpreter/code_execution): Spúšťanie kódu v Pythone v zabezpečenom izolovanom prostredí (sandbox) - Collections Search (
collections_search/file_search): Vyhľadávanie v dokumentoch, ktoré si predtým nahral - Remote MCP (
mcp): Pripojenie k externým serverom MCP (Model Context Protocol)
Ak chceš povoliť vstavaný nástroj, stačí ho pridať do poľa tools vo svojej požiadavke:
{
"tools": [{"type": "web_search"}]
}
Volanie funkcií – na strane klienta
Volanie funkcií (Function Calling) funguje inak. Definuješ vlastné funkcie, ktoré môže model volať. Na rozdiel od vstavaných nástrojov však tvoj kód na strane klienta funkciu vykoná a vráti výsledok späť modelu.
Postup je nasledovný:
- V požiadavke popíšeš svoje funkcie (názov, parametre, popis)
- Model analyzuje požiadavku používateľa
- Ak zistí, že je potrebná funkcia, vráti volanie funkcie s argumentmi
- Tvoj kód funkciu vykoná (volanie API, dopyt do databázy, výpočet…)
- Výsledok pošleš späť modelu
- Model sformuluje svoju konečnú odpoveď
Tento prístup ti dáva plnú kontrolu: ty rozhoduješ, čo tvoje funkcie robia, s akými dátami pracujú a ako sa pripájajú k tvojej infraštruktúre.
Kedy použiť ktorú kategóriu
Vstavané nástroje sú ideálne, keď potrebuješ prístup k informáciám v reálnom čase (web, sociálne siete) alebo potrebuješ vykonávať výpočty bez nutnosti spravovať infraštruktúru. Volanie funkcií je vhodnejšie, keď potrebuješ interagovať s vlastnými systémami: internými databázami, firemnými API alebo akoukoľvek službou špecifickou pre tvoju aplikáciu.
Obe kategórie môžeš kombinovať v jednej požiadavke. Napríklad môžeš povoliť Web Search a zároveň definovať vlastnú funkciu, ktorá uloží výsledky do tvojej databázy.
Kľúčové poznatky
- API Grok ponúka dve kategórie nástrojov: vstavané nástroje (vykonáva xAI) a volanie funkcií (vykonáva tvoj kód)
- Vstavané nástroje nevyžadujú žiadnu infraštruktúru na strane klienta
- Volanie funkcií ponúka plnú kontrolu, ale vyžaduje si viac vývoja
- Obe kategórie je možné kombinovať v jednej požiadavke
- Tento kurz sa zameriava na tri hlavné vstavané nástroje: Web Search, X Search a Code Execution