Dve kategoriji orodij Grok
Na tej strani
Razumevanje ekosistema orodij API Grok
API Grok ne služi le za generiranje besedila. Ponuja nabor orodij, ki modelu omogočajo interakcijo z zunanjim svetom: iskanje informacij v realnem času, analizo podatkov na družbenih omrežjih ali izvajanje kode Python. Da bi izkoristil te zmogljivosti, moraš razumeti, kako so organizirana.
API Grok razlikuje dve temeljni kategoriji orodij. Ta razlika določa, kdo orodje izvaja, kje poteka obdelava in kaj moraš kot razvijalec upravljati.
Vgrajena orodja — na strani strežnika
Vgrajena orodja delujejo neposredno na strežnikih xAI. Ko se model odloči uporabiti eno od teh orodij, je izvedba samodejna in pregledna. Ni ti treba upravljati nobene infrastrukture ali obdelovati vmesnih rezultatov.
Tukaj je pet razpoložljivih vgrajenih orodij:
- Web Search (
web_search): Iskanje po spletu v realnem času s filtriranjem domen in samodejnimi citati - X Search (
x_search): Iskanje po platformi X/Twitter s filtriranjem računov in datumov - Code Execution (
code_interpreter/code_execution): Izvajanje kode Python v varnem izoliranem okolju (peskovnik) - Collections Search (
collections_search/file_search): Iskanje po dokumentih, ki si jih predhodno naložil - Remote MCP (
mcp): Povezava z zunanjimi strežniki MCP (Model Context Protocol)
Če želiš omogočiti vgrajeno orodje, ga preprosto dodaj v polje tools v svojem zahtevku:
{
"tools": [{"type": "web_search"}]
}
Klicanje funkcij — na strani odjemalca
Klicanje funkcij (Function Calling) deluje drugače. Definiraš funkcije po meri, ki jih model lahko pokliče. Za razliko od vgrajenih orodij pa tvoja koda na strani odjemalca funkcijo izvede in modelu vrne rezultat.
Potek je naslednji:
- V zahtevku opišeš svoje funkcije (ime, parametri, opis)
- Model analizira uporabnikovo zahtevo
- Če ugotovi, da je funkcija potrebna, vrne klic funkcije z argumenti
- Tvoja koda izvede funkcijo (klic API-ja, poizvedba v bazi podatkov, izračun …)
- Modelu pošlješ rezultat nazaj
- Model oblikuje svoj končni odgovor
Ta pristop ti daje popoln nadzor: sam se odločiš, kaj tvoje funkcije počnejo, s katerimi podatki delujejo in kako so povezane s tvojo infrastrukturo.
Kdaj uporabiti posamezno kategorijo
Vgrajena orodja so idealna, ko potrebuješ dostop do informacij v realnem času (splet, družbena omrežja) ali moraš izvajati izračune brez upravljanja infrastrukture. Klicanje funkcij je bolj primerno, ko moraš komunicirati s svojimi sistemi: internimi bazami podatkov, poslovnimi API-ji ali katero koli storitvijo, specifično za tvojo aplikacijo.
Obe kategoriji lahko združiš v enem samem zahtevku. Na primer, lahko omogočiš Web Search in hkrati definiraš funkcijo po meri, ki rezultate shrani v tvojo bazo podatkov.
Ključne ugotovitve
- API Grok ponuja dve kategoriji orodij: vgrajena orodja (izvaja jih xAI) in klicanje funkcij (izvaja jih tvoja koda)
- Vgrajena orodja ne zahtevajo infrastrukture na strani odjemalca
- Klicanje funkcij ponuja popoln nadzor, vendar zahteva več razvoja
- Obe kategoriji lahko združiš v enem zahtevku
- Ta tečaj se osredotoča na tri glavna vgrajena orodja: Web Search, X Search in Code Execution