Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Miješanje poslužiteljskih i klijentskih alata

Lekcija 8 od 14 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Dvije kategorije alata na istoj platformi
  2. Kombiniranje oba tipa u jednom zahtjevu
  3. Hibridni tijek rada
  4. Primjeri iz stvarnog svijeta
  5. Naplata poslužiteljskih alata
  6. Ključne točke

Dvije kategorije alata na istoj platformi

Grok API razlikuje dvije temeljno različite vrste alata na temelju načina izvršavanja. Razumijevanje ove razlike ključno je za dizajniranje pouzdanih arhitektura.

Ugrađeni alati (poslužiteljska strana)

xAI automatski izvršava ove alate na svojim poslužiteljima. Ne upravljaš ničim – nema lokalnog izvršavanja, nema prosljeđivanja rezultata. Model ih poziva i izravno prima rezultate.

Alat Identifikator Opis
Web Search web_search Pretraživanje weba u stvarnom vremenu
X Search x_search Pretraživanje na X/Twitteru
Code Interpreter code_interpreter Izvršavanje Pythona u izoliranom okruženju (sandbox)
Collections Search collections_search Pretraživanje unutar tvojih učitanih dokumenata
Remote MCP mcp Povezivanje s vanjskim MCP poslužiteljima

Prilagođene funkcije (klijentska strana)

To su tvoje vlastite funkcije, definirane putem poziva funkcija (function calling). Model vraća tool_call, tvoj kod izvršava funkciju, a ti šalješ rezultat natrag. To je mehanizam koji si naučio u prethodnim lekcijama.

Kombiniranje oba tipa u jednom zahtjevu

Snaga Grok API-ja leži u mogućnosti miješanja poslužiteljskih i klijentskih alata u jednom zahtjevu:

tools = [
    # Poslužiteljski alat — automatski izvršava xAI
    {"type": "web_search"},

    # Klijentski alat — izvršava tvoj kod
    {
        "type": "function",
        "function": {
            "name": "save_to_database",
            "description": "Spremi informacije u bazu podataka",
            "parameters": {
                "type": "object",
                "properties": {
                    "key": {"type": "string"},
                    "value": {"type": "string"}
                },
                "required": ["key", "value"]
            }
        }
    }
]

Kada model primi ovaj zahtjev, može:

  1. Upotrijebiti web_search za pronalaženje informacija (automatsko izvršavanje na poslužitelju)
  2. Pozvati save_to_database za spremanje rezultata (vraća se klijentu)

Hibridni tijek rada

Ponašanje se razlikuje ovisno o vrsti alata:

  • Poslužiteljski alat: model poziva alat, xAI ga izvršava, rezultat se automatski integrira, model nastavlja rad
  • Klijentski alat: model vraća tool_call klijentu, izvršavanje se zaustavlja i nastavlja tek kada pošalješ rezultat natrag

Kada model koristi obje vrste u istom zahtjevu, poslužiteljski alati se izvršavaju prvi (bez tvoje intervencije). Zatim, ako modelu zatreba i klijentski alat, vraća ti tool_call s rezultatima poslužiteljskih alata već integriranim u njegov kontekst.

Primjeri iz stvarnog svijeta

Web pretraživanje + poslovna logika

# Korisnik pita: "Pronađi cijenu Bitcoina i spremi je"
# Model:
# 1. Poziva web_search za pronalaženje cijene (poslužiteljska strana, automatski)
# 2. Poziva save_price(symbol="BTC", price=68432) (klijentska strana)

X pretraživanje + obavijest

# "Obavijesti me o tweetovima o našem proizvodu od jučer"
# Model:
# 1. Poziva x_search za pronalaženje tweetova (poslužiteljska strana)
# 2. Poziva send_notification(count=12, summary="...") (klijentska strana)

Code Interpreter + pohrana

# "Izračunaj prosjek ovih podataka i spremi rezultat"
# Model:
# 1. Poziva code_interpreter za izračun (poslužiteljska strana)
# 2. Poziva save_result(key="avg", value="42.5") (klijentska strana)

Naplata poslužiteljskih alata

Ugrađeni alati naplaćuju se na dva načina:

  • Tokeni: standardna potrošnja (ulaz + izlaz)
  • Pozivi: fiksni trošak po pozivu alata

Model može pozvati više poslužiteljskih alata za jedan zahtjev – troškovi se zbrajaju. Imaj to na umu kada omogućiš web_search: model može izvršiti višestruka pretraživanja kako bi usavršio svoje rezultate.

Ključne točke

  • Dvije vrste alata: poslužiteljski (automatski) i klijentski (poziv funkcija)
  • Poslužiteljski alati (web_search, x_search, code_interpreter) izvršavaju se bez tvoje intervencije
  • Možeš miješati obje vrste u jednom zahtjevu
  • Poslužiteljski alati se izvršavaju prvi, zatim model može pozvati tvoje funkcije
  • Svaki poziv poslužiteljskog alata se naplaćuje (tokeni + trošak po pozivu)
  • Citati se automatski generiraju za podatke iz poslužiteljskih alata