Ugrađeni alati za Responses API
Na ovoj stranici
Dodavanje mogućnosti modelu
Grok modeli nisu ograničeni samo na generiranje teksta. Korištenjem parametra tools možeš im omogućiti pristup alatima koji značajno proširuju njihove mogućnosti: pretraživanje weba u stvarnom vremenu, pretraživanje na platformi X (bivši Twitter), izvršavanje Python koda i tvoje vlastite prilagođene funkcije.
Četiri vrste alata
web_search
Omogućuje modelu pretraživanje informacija na webu u stvarnom vremenu:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the latest news on AI in Europe?",
"tools": [{"type": "web_search"}]
}
Model automatski odlučuje kada će izvršiti pretraživanje. Rezultati se integriraju u njegov odgovor uz navođenje izvora.
x_search
Pretražuje objave na platformi X (bivši Twitter):
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the tech community saying about the latest iPhone?",
"tools": [{"type": "x_search"}]
}
Ovo je posebno korisno za praćenje javnog mnijenja, trendova i reakcija u stvarnom vremenu.
code_interpreter
Izvršava Python kod na strani poslužitelja radi izračuna, analize podataka ili izrade grafikona:
{
"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 piše Python kod, izvršava ga na xAI poslužiteljima i integrira rezultate u svoj odgovor.
function
Tvoje vlastite funkcije koje model može pozvati. Model generira argumente, ali tvoj kod izvršava funkciju:
{
"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 više alata
U jedan zahtjev možeš proslijediti do 128 alata. Model odabire onaj (ili one) koji najbolje odgovaraju:
{
"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"}
]
}
U ovom primjeru model bi mogao prvo upotrijebiti web_search kako bi pronašao rezultate, a zatim code_interpreter kako bi ih formatirao u tablicu.
Alati na strani poslužitelja naspram alata na strani klijenta
Razlika je temeljna:
-
Alati na strani poslužitelja (
web_search,x_search,code_interpreter): Automatski ih izvršavaju xAI poslužitelji. Ne moraš ništa poduzeti – model pokreće pretraživanje ili kod, dohvaća rezultat i integrira ga u svoj odgovor. -
Alati na strani klijenta (
function): Model generira poziv funkcije s argumentima, a zatim pauzira generiranje. Tvoj kod izvršava funkciju, a ti šalješ rezultat natrag u novom zahtjevu.
Ova razlika izravno utječe na arhitekturu tvoje aplikacije, što ćeš vidjeti u sljedećim lekcijama.
Ključne točke
- Četiri vrste alata:
web_search,x_search,code_interpreter,function - Prva tri rade na strani poslužitelja – nije potrebna tvoja infrastruktura
- Alati tipa
functionrade na strani klijenta – tvoj kod rukuje izvršavanjem - Možeš kombinirati do 128 alata po zahtjevu
- Model automatski odlučuje kada i koje alate koristiti