Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Sisäiset työkalut Responses API:lle

Oppitunti 9 / 16 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Mallin ominaisuuksien laajentaminen
  2. Neljä työkalutyyppiä
  3. Useiden työkalujen yhdistäminen
  4. Palvelinpuolen ja asiakaspuolen työkalut
  5. Keskeiset asiat

Mallin ominaisuuksien laajentaminen

Grok-mallit eivät rajoitu pelkkään tekstin tuottamiseen. tools-parametrin avulla voit antaa niille pääsyn työkaluihin, jotka laajentavat niiden kykyjä merkittävästi: reaaliaikainen verkkohaku, haku X:stä (entinen Twitter), Python-koodin suorittaminen ja omat mukautetut funktiosi.

web_search
Real-time web search
x_search
Search on X
code
Python Interpreter
function
Custom functions

Neljä työkalutyyppiä

Mahdollistaa mallille tiedon haun verkosta reaaliajassa:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What's the latest news on AI in Europe?",
  "tools": [{"type": "web_search"}]
}

Malli päättää automaattisesti, milloin haku suoritetaan. Tulokset integroidaan vastaukseen lähdeviitteineen.

Hakee viestejä X:stä (entinen Twitter):

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What is the tech community saying about the latest iPhone?",
  "tools": [{"type": "x_search"}]
}

Erityisen hyödyllinen yleisen mielipiteen, trendien ja reaaliaikaisten reaktioiden seuraamiseen.

code_interpreter

Suorittaa Python-koodia palvelinpuolella laskutoimituksia, data-analyysiä tai kaavioiden luontia varten:

{
  "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"}]
}

Malli kirjoittaa Python-koodin, suorittaa sen xAI:n palvelimilla ja integroi tulokset vastaukseensa.

function

Omat funktiosi, joita malli voi kutsua. Malli generoi argumentit, mutta sinun koodisi suorittaa funktion:

{
  "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"]
    }
  }]
}

Useiden työkalujen yhdistäminen

Voit välittää jopa 128 työkalua yhdessä pyynnössä. Malli valitsee niistä sopivan (tai sopivat):

{
  "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"}
  ]
}

Tässä esimerkissä malli saattaa ensin käyttää web_search-työkalua tulosten löytämiseen ja sen jälkeen code_interpreter-työkalua niiden muotoilemiseksi taulukoksi.

Palvelinpuolen ja asiakaspuolen työkalut

Ero on perustavanlaatuinen:

  • Palvelinpuolen työkalut (web_search, x_search, code_interpreter): xAI:n palvelimet suorittavat nämä automaattisesti. Sinun ei tarvitse tehdä mitään – malli käynnistää haun tai koodin, hakee tuloksen ja integroi sen vastaukseensa.

  • Asiakaspuolen työkalut (function): Malli generoi funktiokutsun argumentteineen ja keskeyttää sitten generoinnin. Sinun koodisi suorittaa funktion, ja lähetät tuloksen takaisin uudessa pyynnössä.

Tällä erolla on suora vaikutus sovelluksesi arkkitehtuuriin, kuten näet seuraavissa oppitunneissa.

Keskeiset asiat

  • Neljä työkalutyyppiä: web_search, x_search, code_interpreter, function
  • Kolme ensimmäistä suoritetaan palvelinpuolella – et tarvitse omaa infrastruktuuria
  • function-työkalut suoritetaan asiakaspuolella – sinun koodisi hoitaa suorituksen
  • Voit yhdistää jopa 128 työkalua pyyntöä kohden
  • Malli päättää automaattisesti, milloin ja mitkä työkalut se käyttää