Mešanje orodij na strežniku in odjemalcu
Na tej strani
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:
- Uporabi
web_searchza iskanje informacij (samodejno izvajanje na strežniku) - Pokliče
save_to_databaseza 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_callodjemalcu, 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