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

Vgrajena orodja za API Responses

Lekcija 9 od 16 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Dodajanje zmogljivosti modelu
  2. Štiri vrste orodij
  3. Kombiniranje več orodij
  4. Orodja na strežniški strani proti orodjem na odjemalski strani
  5. Ključne ugotovitve

Dodajanje zmogljivosti modelu

Modeli Grok niso omejeni le na generiranje besedila. S parametrom tools jim lahko omogočiš dostop do orodij, ki bistveno razširijo njihove zmožnosti: iskanje po spletu v realnem času, iskanje po platformi X (nekdanji Twitter), izvajanje kode Python in tvoje lastne funkcije.

web_search
Iskanje po spletu v realnem času
x_search
Iskanje po platformi X
code
Interpreter Python
function
Orodja po meri

Štiri vrste orodij

Modelu omogoča iskanje informacij na spletu v realnem času:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What's the latest news on AI in Europe?",
  "tools": [{"type": "web_search"}]
}

Model samodejno odloči, kdaj izvesti iskanje. Rezultati so vključeni v njegov odgovor skupaj z viri.

Išče objave na platformi X (nekdanji Twitter):

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What is the tech community saying about the latest iPhone?",
  "tools": [{"type": "x_search"}]
}

Še posebej uporabno za zajemanje javnega mnenja, trendov in odzivov v realnem času.

code_interpreter

Izvaja kodo Python na strežniški strani za izračune, analizo podatkov ali ustvarjanje grafov:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Calculate the mean and standard deviation of these values: 12, 15, 18, 22, 9, 31",
  "tools": [{"type": "code_interpreter"}]
}

Model napiše kodo Python, jo izvrši na strežnikih xAI in rezultate vključi v svoj odgovor.

function

Tvoje lastne funkcije, ki jih model lahko pokliče. Model generira argumente, vendar tvoja koda izvrši funkcijo:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What's the weather in Paris?",
  "tools": [{
    "type": "function",
    "name": "get_weather",
    "description": "Retrieves the weather for a given city",
    "parameters": {
      "type": "object",
      "properties": {
        "city": {"type": "string", "description": "City name"},
        "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
      },
      "required": ["city"]
    }
  }]
}

Kombiniranje več orodij

V enem zahtevku lahko posreduješ do 128 orodij. Model izbere tisto (ali tista), ki najbolj ustrezajo:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Search for the latest Ligue 1 results and create a scoreboard.",
  "tools": [
    {"type": "web_search"},
    {"type": "code_interpreter"}
  ]
}

V tem primeru lahko model najprej uporabi web_search za iskanje rezultatov, nato pa code_interpreter za njihovo oblikovanje v tabelo.

Orodja na strežniški strani proti orodjem na odjemalski strani

Razlika je temeljna:

  • Orodja na strežniški strani (web_search, x_search, code_interpreter): Samodejno jih izvršijo strežniki xAI. Tebi ni treba storiti ničesar – model sproži iskanje ali kodo, pridobi rezultat in ga vključi v svoj odgovor.

  • Orodja na odjemalski strani (function): Model generira klic funkcije z argumenti, nato pa začasno ustavi generiranje. Tvoja koda izvrši funkcijo, rezultat pa pošlješ nazaj v novem zahtevku.

Ta razlika neposredno vpliva na arhitekturo tvoje aplikacije, kot boš videl v naslednjih lekcijah.

Ključne ugotovitve

  • Štiri vrste orodij: web_search, x_search, code_interpreter, function
  • Prva tri se izvajajo na strežniški strani – od tebe ne zahtevajo nobene infrastrukture
  • Orodja tipa function se izvajajo na odjemalski strani – tvoja koda skrbi za izvršitev
  • Na zahtevo lahko kombiniraš do 128 orodij
  • Model samodejno odloči, kdaj in katera orodja uporabiti