Dvě kategorie nástrojů Grok
Na této stránce
Pochopte ekosystém nástrojů API Grok
API Grok umí víc než jen generovat text. Poskytuje sadu nástrojů, které modelu umožňují komunikovat s vnějším světem: vyhledávat aktuální informace, analyzovat data na sociálních sítích nebo spouštět kód v Pythonu. Abys tyto možnosti plně využil, musíš pochopit, jak jsou nástroje uspořádány.
API Grok rozlišuje dvě základní kategorie nástrojů. Toto rozlišení určuje, kdo nástroj spouští, kde probíhá zpracování a co musíš jako vývojář spravovat.
Vestavěné nástroje – na straně serveru
Vestavěné nástroje běží přímo na serverech xAI. Když se model rozhodne některý z nich použít, provede se automaticky a transparentně. Nemusíš spravovat žádnou infrastrukturu ani zpracovávat průběžné výsledky.
Zde je pět dostupných vestavěných nástrojů:
- Web Search (
web_search): Vyhledávání na webu v reálném čase s filtrováním podle domény a automatickým citováním zdrojů - X Search (
x_search): Vyhledávání na síti X/Twitter s filtrováním podle účtu a data - Code Execution (
code_interpreter/code_execution): Spouštění kódu v Pythonu v zabezpečeném izolovaném prostředí (sandbox) - Collections Search (
collections_search/file_search): Vyhledávání v dokumentech, které jsi dříve nahrál - Remote MCP (
mcp): Připojení k externím serverům MCP (Model Context Protocol)
Chceš-li aktivovat vestavěný nástroj, stačí jej přidat do pole tools ve svém požadavku:
{
"tools": [{"type": "web_search"}]
}
Volání funkcí – na straně klienta
Volání funkcí (Function Calling) funguje jinak. Definuješ vlastní funkce, které může model volat. Na rozdíl od vestavěných nástrojů však tvůj kód na straně klienta funkci provede a vrátí výsledek modelu.
Postup je následující:
- V požadavku popíšeš své funkce (název, parametry, popis)
- Model analyzuje žádost uživatele
- Pokud zjistí, že je potřeba funkce, vrátí volání funkce s argumenty
- Tvůj kód funkci provede (volání API, dotaz do databáze, výpočet…)
- Výsledek odešleš zpět modelu
- Model formuluj svou konečnou odpověď
Tento přístup ti dává plnou kontrolu: ty rozhoduješ, co tvé funkce dělají, s jakými daty pracují a jak se připojují k tvé infrastruktuře.
Kdy použít kterou kategorii
Vestavěné nástroje jsou ideální, když potřebuješ přístup k informacím v reálném čase (web, sociální sítě) nebo potřebuješ provádět výpočty bez nutnosti spravovat infrastrukturu. Volání funkcí je vhodnější, když potřebuješ interagovat s vlastními systémy: interními databázemi, firemními API nebo jakoukoli službou specifickou pro tvou aplikaci.
Obě kategorie můžeš kombinovat v jediném požadavku. Můžeš například povolit Web Search a zároveň definovat vlastní funkci, která uloží výsledky do tvé databáze.
Klíčové poznatky
- API Grok nabízí dvě kategorie nástrojů: vestavěné nástroje (spouští xAI) a volání funkcí (spouští tvůj kód)
- Vestavěné nástroje nevyžadují žádnou infrastrukturu na straně klienta
- Volání funkcí nabízí plnou kontrolu, ale vyžaduje více vývoje
- Obě kategorie lze kombinovat v jediném požadavku
- Tento kurz se zaměřuje na tři hlavní vestavěné nástroje: Web Search, X Search a Code Execution