Dvije kategorije alata Grok
Na ovoj stranici
Razumijevanje ekosustava alata Grok API-ja
Grok API radi više od pukog generiranja teksta. Nudi skup alata koji modelu omogućuju interakciju s vanjskim svijetom: pretraživanje informacija u stvarnom vremenu, analizu podataka na društvenim mrežama ili izvršavanje Python koda. Da bi iskoristio te mogućnosti, moraš razumjeti kako su organizirane.
Grok API razlikuje dvije temeljne kategorije alata. Ta razlika određuje tko izvršava alat, gdje se odvija obrada i što moraš upravljati kao programer.
Ugrađeni alati — na strani poslužitelja
Ugrađeni alati izvršavaju se izravno na poslužiteljima tvrtke xAI. Kada model odluči upotrijebiti jedan od tih alata, izvršavanje je automatsko i transparentno. Ne moraš upravljati nikakvom infrastrukturom niti obrađivati međurezultate.
Evo pet dostupnih ugrađenih alata:
- Web Search (
web_search): Pretraživanje weba u stvarnom vremenu, s filtriranjem po domenama i automatskim citiranjem izvora - X Search (
x_search): Pretraživanje na platformi X/Twitter, s filtriranjem po računima i datumima - Code Execution (
code_interpreter/code_execution): Izvršavanje Python koda u sigurnom izoliranom okruženju (sandbox) - Collections Search (
collections_search/file_search): Pretraživanje unutar dokumenata koje si prethodno prenio/la - Remote MCP (
mcp): Povezivanje s vanjskim MCP (Model Context Protocol) poslužiteljima
Da bi omogućio/la ugrađeni alat, jednostavno ga dodaj u polje tools u svom zahtjevu:
{
"tools": [{"type": "web_search"}]
}
Pozivanje funkcija — na strani klijenta
Pozivanje funkcija (Function Calling) funkcionira drugačije. Definiraš prilagođene funkcije koje model može pozvati. No, za razliku od ugrađenih alata, tvoj kôd na strani klijenta izvršava funkciju i vraća rezultat modelu.
Tijek je sljedeći:
- U zahtjevu opisuješ svoje funkcije (naziv, parametri, opis)
- Model analizira korisnikov zahtjev
- Ako utvrdi da je potrebna funkcija, vraća poziv funkcije s argumentima
- Tvoj kôd izvršava funkciju (API poziv, upit bazi podataka, izračun…)
- Šalješ rezultat natrag modelu
- Model formulira svoj konačni odgovor
Ovaj pristup daje ti potpunu kontrolu: ti odlučuješ što tvoje funkcije rade, s kojim podacima rukuju i kako se povezuju s tvojom infrastrukturom.
Kada koristiti koju kategoriju
Ugrađeni alati idealni su kada trebaš pristup informacijama u stvarnom vremenu (web, društvene mreže) ili kada moraš izvršiti izračune bez upravljanja infrastrukturom. Pozivanje funkcija poželjnije je kada trebaš komunicirati sa svojim vlastitim sustavima: internim bazama podataka, poslovnim API-jima ili bilo kojom uslugom specifičnom za tvoju aplikaciju.
Možeš kombinirati obje kategorije u jednom zahtjevu. Na primjer, možeš omogućiti Web Search dok istovremeno definiraš prilagođenu funkciju koja sprema rezultate u tvoju bazu podataka.
Ključne točke
- Grok API nudi dvije kategorije alata: ugrađene alate (izvršava xAI) i pozivanje funkcija (izvršava tvoj kôd)
- Ugrađeni alati ne zahtijevaju infrastrukturu na strani klijenta
- Pozivanje funkcija nudi potpunu kontrolu, ali zahtijeva više razvoja
- Obje se kategorije mogu kombinirati u jednom zahtjevu
- Ovaj tečaj fokusira se na tri glavna ugrađena alata: Web Search, X Search i Code Execution