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

Dve kategórie nástrojov Grok

Lekcia 1 z 16 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Pochopte ekosystém nástrojov API Grok
  2. Vstavané nástroje – na strane servera
  3. Volanie funkcií – na strane klienta
  4. Kedy použiť ktorú kategóriu
  5. Kľúčové poznatky

Pochopte ekosystém nástrojov API Grok

Prehľad nástrojov v dokumentácii 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.

🔍
Web Search
Real-time web search
𝕏
X Search
Search on X/Twitter
🐍
Code Execution
Isolated Python sandbox
📁
Collections Search
Search within your documents
🔌
Remote MCP
External MCP servers

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ý:

  1. V požiadavke popíšeš svoje funkcie (názov, parametre, popis)
  2. Model analyzuje požiadavku používateľa
  3. Ak zistí, že je potrebná funkcia, vráti volanie funkcie s argumentmi
  4. Tvoj kód funkciu vykoná (volanie API, dopyt do databázy, výpočet…)
  5. Výsledok pošleš späť modelu
  6. 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