Iebūvētie rīki Responses API
Šajā lapā
Modeļa spēju paplašināšana
Grok modeļi neaprobežojas tikai ar teksta ģenerēšanu. Izmantojot parametru tools, tu vari nodrošināt tiem piekļuvi rīkiem, kas būtiski paplašina to iespējas: tiešsaistes meklēšanu web vidē, meklēšanu platformā X (bijušais Twitter), Python koda izpildi un tavas pašas izveidotās funkcijas.
Četri rīku veidi
web_search
Ļauj modelim reāllaikā meklēt informāciju internetā:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the latest news on AI in Europe?",
"tools": [{"type": "web_search"}]
}
Modelis automātiski izlemj, kad veikt meklēšanu. Rezultāti tiek integrēti tā atbildē kopā ar atsaucēm.
x_search
Meklē ierakstus platformā X (bijušais Twitter):
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the tech community saying about the latest iPhone?",
"tools": [{"type": "x_search"}]
}
Īpaši noderīgi, lai fiksētu sabiedrisko domu, tendences un reakcijas reāllaikā.
code_interpreter
Izpilda Python kodu servera pusē aprēķinu veikšanai, datu analīzei vai grafiku izveidei:
{
"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"}]
}
Modelis uzraksta Python kodu, izpilda to xAI serveros un integrē rezultātus savā atbildē.
function
Tavas pašas funkcijas, ko modelis var izsaukt. Modelis ģenerē argumentus, bet tavs kods izpilda 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"]
}
}]
}
Vairāku rīku kombinēšana
Vienā pieprasījumā tu vari nosūtīt līdz pat 128 rīkiem. Modelis izvēlas to (vai tos), kas vislabāk atbilst uzdevumam:
{
"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"}
]
}
Šajā piemērā modelis vispirms var izmantot web_search, lai atrastu rezultātus, un pēc tam code_interpreter, lai tos noformētu tabulā.
Servera puses un klienta puses rīki
Šī atšķirība ir fundamentāla:
-
Servera puses rīki (
web_search,x_search,code_interpreter): Tos automātiski izpilda xAI serveri. Tev nekas nav jādara – modelis uzsāk meklēšanu vai koda izpildi, saņem rezultātu un integrē to savā atbildē. -
Klienta puses rīki (
function): Modelis ģenerē funkcijas izsaukumu ar argumentiem un pēc tam aptur ģenerēšanu. Tavs kods izpilda funkciju, un tu nosūti rezultātu atpakaļ jaunā pieprasījumā.
Šī atšķirība tieši ietekmē tavas lietotnes arhitektūru, kā redzēsi turpmākajās nodarbībās.
Galvenās atziņas
- Četri rīku veidi:
web_search,x_search,code_interpreter,function - Pirmie trīs darbojas servera pusē – tev nav nepieciešama sava infrastruktūra
- Rīks
functiondarbojas klienta pusē – izpildi nodrošina tavs kods - Vienā pieprasījumā vari kombinēt līdz pat 128 rīkiem
- Modelis automātiski izlemj, kad un kurus rīkus izmantot