Sisäiset työkalut Responses API:lle
Tällä sivulla
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.
Neljä työkalutyyppiä
web_search
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.
x_search
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ää