Vgrajena orodja za API Responses
Na tej strani
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.
Štiri vrste orodij
web_search
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.
x_search
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
functionse 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