Miješanje poslužiteljskih i klijentskih alata
Na ovoj stranici
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:
- Upotrijebiti
web_searchza pronalaženje informacija (automatsko izvršavanje na poslužitelju) - Pozvati
save_to_databaseza 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_callklijentu, 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