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

Mešanje orodij na strežniku in odjemalcu

Lekcija 8 od 14 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Dve kategoriji orodij na isti platformi
  2. Združevanje obeh v enem zahtevku
  3. Hibridni tok
  4. Primeri iz prakse
  5. Obračunavanje za orodja na strežniku
  6. Ključne ugotovitve

Dve kategoriji orodij na isti platformi

API Grok razlikuje dve temeljno različni vrsti orodij glede na način izvajanja. Razumevanje te razlike je ključno za načrtovanje robustnih arhitektur.

Vgrajena orodja (na strani strežnika)

xAI ta orodja samodejno izvrši na svojih strežnikih. Ničesar ne upravljaš – ni lokalnega izvajanja, ni posredovanja rezultatov. Model jih pokliče in prejme rezultate neposredno.

Orodje Identifikator Opis
Web Search web_search Iskanje po spletu v realnem času
X Search x_search Iskanje po omrežju X/Twitter
Code Interpreter code_interpreter Izvajanje Pythona v peskovniku
Collections Search collections_search Iskanje po vaših naloženih dokumentih
Remote MCP mcp Povezava z zunanjimi strežniki MCP

Orodja po meri (na strani odjemalca)

To so tvoje lastne funkcije, definirane prek klicanja funkcij (function calling). Model vrne tool_call, tvoja koda izvrši funkcijo in ti pošlješ rezultat nazaj. To je mehanizem, ki si se ga naučil v prejšnjih lekcijah.

Združevanje obeh v enem zahtevku

Moč API-ja Grok temelji na zmožnosti mešanja orodij na strežniku in odjemalcu v enem samem zahtevku:

tools = [
    # Orodje na strežniku — samodejno izvrši xAI
    {"type": "web_search"},

    # Orodje na odjemalcu — izvrši tvoja koda
    {
        "type": "function",
        "function": {
            "name": "save_to_database",
            "description": "Save information to the database",
            "parameters": {
                "type": "object",
                "properties": {
                    "key": {"type": "string"},
                    "value": {"type": "string"}
                },
                "required": ["key", "value"]
            }
        }
    }
]

Ko model prejme ta zahtevek, lahko:

  1. Uporabi web_search za iskanje informacij (samodejno izvajanje na strežniku)
  2. Pokliče save_to_database za shranjevanje rezultata (vrnitev odjemalcu)

Hibridni tok

Obnašanje se razlikuje glede na vrsto orodja:

  • Orodje na strežniku: model pokliče orodje, xAI ga izvrši, rezultat se samodejno vključi, model nadaljuje
  • Orodje na odjemalcu: model vrne tool_call odjemalcu, izvajanje se ustavi in nadaljuje, ko pošlješ rezultat nazaj

Ko model uporabi obe vrsti v istem zahtevku, se orodja na strežniku izvršijo najprej (brez tvojega posredovanja). Nato, če model potrebuje še orodje na odjemalcu, ti vrne tool_call z rezultati orodij na strežniku, ki so že vključeni v njegov kontekst.

Primeri iz prakse

Iskanje po spletu + poslovna logika

# Uporabnik vpraša: "Poišči ceno Bitcoina in jo shrani"
# Model:
# 1. Pokliče web_search za iskanje cene (strežnik, samodejno)
# 2. Pokliče save_price(symbol="BTC", price=68432) (odjemalec)

Iskanje po X + obvestilo

# "Opozori me na tvite o našem izdelku od včeraj"
# Model:
# 1. Pokliče x_search za iskanje tvitov (strežnik)
# 2. Pokliče send_notification(count=12, summary="...") (odjemalec)

Code Interpreter + shramba

# "Izračunaj povprečje teh podatkov in shrani rezultat"
# Model:
# 1. Pokliče code_interpreter za izračun (strežnik)
# 2. Pokliče save_result(key="avg", value="42.5") (odjemalec)

Obračunavanje za orodja na strežniku

Vgrajena orodja se obračunavajo na dva načina:

  • Žetoni: standardna poraba (vhod + izhod)
  • Klici: fiksni strošek na klic orodja

Model lahko za en zahtevek pokliče več orodij na strežniku – stroški se seštevajo. To imej v mislih, ko omogočiš web_search: model lahko izvede več iskanj za izpopolnitev rezultatov.

Ključne ugotovitve

  • Dve vrsti orodij: strežniška (samodejna) in odjemalska (klicanje funkcij)
  • Strežniška orodja (web_search, x_search, code_interpreter) se izvršijo brez tvojega posredovanja
  • Obe vrsti lahko mešaš v enem samem zahtevku
  • Strežniška orodja se izvršijo najprej, nato model lahko pokliče tvoje funkcije
  • Vsak klic strežniškega orodja se obračuna (žetoni + strošek na klic)
  • Citati se samodejno ustvarijo za podatke iz strežniških orodij