Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Dve kategoriji orodij Grok

Lekcija 1 od 16 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Razumevanje ekosistema orodij API Grok
  2. Vgrajena orodja — na strani strežnika
  3. Klicanje funkcij — na strani odjemalca
  4. Kdaj uporabiti posamezno kategorijo
  5. Ključne ugotovitve

Razumevanje ekosistema orodij API Grok

Pregled orodij v dokumentaciji 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.

🔍
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

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:

  1. V zahtevku opišeš svoje funkcije (ime, parametri, opis)
  2. Model analizira uporabnikovo zahtevo
  3. Če ugotovi, da je funkcija potrebna, vrne klic funkcije z argumenti
  4. Tvoja koda izvede funkcijo (klic API-ja, poizvedba v bazi podatkov, izračun …)
  5. Modelu pošlješ rezultat nazaj
  6. 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