Sisseehitatud tööriistad vastuste API-le
Sellel lehel
Mudeli võimete laiendamine
Groki mudelid ei piirdu ainult teksti genereerimisega. Kasutades parameetrit tools, saad anda neile juurdepääsu tööriistadele, mis laiendavad oluliselt nende võimalusi: reaalajas veebiotsing, otsing X-is (varem Twitter), Pythoni koodi käivitamine ja sinu enda kohandatud funktsioonid.
Neli tööriista tüüpi
web_search
Võimaldab mudelil otsida teavet veebist reaalajas:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the latest news on AI in Europe?",
"tools": [{"type": "web_search"}]
}
Mudel otsustab automaatselt, millal otsingut teha. Tulemused integreeritakse selle vastusesse koos viidetega.
x_search
Otsib postitusi X-is (varem Twitter):
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the tech community saying about the latest iPhone?",
"tools": [{"type": "x_search"}]
}
Eriti kasulik avaliku arvamuse, trendide ja reaalajas reaktsioonide tabamiseks.
code_interpreter
Käivitab Pythoni koodi serveripoolselt arvutuste, andmeanalüüsi või diagrammide loomise jaoks:
{
"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"}]
}
Mudel kirjutab Pythoni koodi, käivitab selle xAI serverites ja integreerib tulemused oma vastusesse.
function
Sinu enda funktsioonid, mida mudel saab kutsuda. Mudel genereerib argumendid, kuid sinu kood käivitab funktsiooni:
{
"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"]
}
}]
}
Mitme tööriista kombineerimine
Saad saata ühes päringus kuni 128 tööriista. Mudel valib sobiva (või sobivad):
{
"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"}
]
}
Selles näites võib mudel esmalt kasutada web_search tulemuste leidmiseks ja seejärel code_interpreter nende tabelisse vormindamiseks.
Serveripoolsed vs kliendipoolsed tööriistad
See eristus on fundamentaalne:
-
Serveripoolsed tööriistad (
web_search,x_search,code_interpreter): xAI serverid käivitavad need automaatselt. Sa ei pea midagi tegema – mudel käivitab otsingu või koodi, toob tulemuse ja integreerib selle oma vastusesse. -
Kliendipoolsed tööriistad (
function): Mudel genereerib funktsioonikutse koos argumentidega ja seejärel peatab genereerimise. Sinu kood käivitab funktsiooni ja sa saadad tulemuse tagasi uues päringus.
See erinevus mõjutab otseselt sinu rakenduse arhitektuuri, nagu näed järgmistes tundides.
Peamised punktid
- Neli tööriista tüüpi:
web_search,x_search,code_interpreter,function - Esimesed kolm töötavad serveripoolselt – sinu poolt infrastruktuuri vaja ei ole
functiontööriistad töötavad kliendipoolselt – sinu kood haldab käivitamist- Saad kombineerida kuni 128 tööriista ühe päringu kohta
- Mudel otsustab automaatselt, millal ja milliseid tööriistu kasutada