Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Sisseehitatud tööriistad vastuste API-le

Õppetund 9 / 16 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Mudeli võimete laiendamine
  2. Neli tööriista tüüpi
  3. Mitme tööriista kombineerimine
  4. Serveripoolsed vs kliendipoolsed tööriistad
  5. Peamised punktid

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.

web_search
Reaalajas veebiotsing
x_search
Otsing X-is
code
Pythoni interpreter
function
Kohandatud funktsioonid

Neli tööriista tüüpi

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.

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
  • function töö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