Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Dvě kategorie nástrojů Grok

Lekce 1 z 16 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Pochopte ekosystém nástrojů API Grok
  2. Vestavěné nástroje – na straně serveru
  3. Volání funkcí – na straně klienta
  4. Kdy použít kterou kategorii
  5. Klíčové poznatky

Pochopte ekosystém nástrojů API Grok

Přehled nástrojů v dokumentaci 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.

🔍
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

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

  1. V požadavku popíšeš své funkce (název, parametry, popis)
  2. Model analyzuje žádost uživatele
  3. Pokud zjistí, že je potřeba funkce, vrátí volání funkce s argumenty
  4. Tvůj kód funkci provede (volání API, dotaz do databáze, výpočet…)
  5. Výsledek odešleš zpět modelu
  6. 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