Ota verkkohaku käyttöön Grok API:ssa
Tällä sivulla
Päivitetty 2. marraskuuta 2026. xAI:n dokumentaation perusteella:
xai-sdk:lla verkkohaku aktivoituuxai_sdk.tools-moduulista tuotavanweb_search()-funktion kautta keskustelussa, joka on luotuclient.chat.create-funktiolla; vanha esimerkki kutsuiclient.tools.web_search()-funktiota, jota ei ole olemassa tässä SDK:ssa. Lähde: Web Search.
Päivitetty 3. marraskuuta 2026. Ensimmäinen esimerkki kutsui
client.responses.create()-funktiotaxai-sdk-asiakkaalla, jolla ei oleresponses-attribuuttia: tällä SDK:lla haku kulkeeclient.chat.create(..., tools=[web_search()])-kutsun kautta, jaclient.responses.create()kuuluuopenai-SDK:hon, joka on osoitettu osoitteeseenhttps://api.x.ai/v1. Vercel AI SDK -esimerkki välitti työkalut taulukkona eikä tuonutgenerateText:ää sisään: ne määritellään objektissa, kuten xAI:n dokumentaatiossa. Koodi on varmistettu versioillaxai-sdk1.21.0 jaopenai3.42.1. Lähde: Web Search.
Miksi Grok kannattaa yhdistää reaaliaikaiseen verkkoon
Perinteiset kielimallit toimivat tiedolla, joka on jäädytetty niiden koulutuspäivämäärään. Kehittäjälle, joka rakentaa sovelluksia, jotka vaativat ajantasaista dataa (osakekurssit, uutiset, urheilutulokset, sää), tämä rajoitus on este. Grok API:n web_search-työkalu ratkaisee tämän ongelman antamalla mallin hakea tietoa verkosta reaaliajassa suoraan API-kutsusi kautta.

Toisin kuin muut tarjoajat, jotka vaativat kolmansien osapuolten integraatioita tai erillisiä lisäosia, xAI tarjoaa verkkohaun palvelinpuolen sisäänrakennettuna työkaluna. Sinun ei tarvitse hallita infrastruktuuria: malli päättää, milloin se hakee tietoa, suorittaa kyselyn ja integroi tulokset vastaukseensa.
Responses API: Ainoa tuettu päätepiste
Verkkohaku toimii yksinomaan Responses API:ssa. Vanha Chat Completions -päätepiste tarjosi search_parameters-parametrin, mutta se on nyt vanhentunut. Jos siirryt vanhasta APIsta, sinun on mukautettava kutsujasi.
Aktivointi tapahtuu lisäämällä web_search-työkalu pyyntösi tools-taulukkoon:
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")
response = client.responses.create(
model="grok-4.5",
input="What is the weather like in Paris today?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Tämä esimerkki käyttää openai-SDK:ta, joka yhteensopiva xAI Responses API:n kanssa; alla esiteltävä natiivi xAI SDK toimii keskustelun kautta.
Siinä kaikki. Malli analysoi kehotteesi, määrittää, tarvitseeko se tuoretta tietoa, ja käynnistää haun automaattisesti. Sinun ei tarvitse hallita kutsusilmukkaa tai ehdollista logiikkaa.
Viisivaiheinen suoritusvirta
Kun lähetät pyynnön, jossa web_search on käytössä, prosessi etenee tietyn sekvenssin mukaan:
- Analyysi: malli arvioi, vaatiiko kysymys tuoreita tietoja
- Päätös: se päättää joko hakea tietoa tai vastata sisäisellä tiedollaan
- Suoritus: verkkohaku suoritetaan palvelinpuolella (sinun ei tarvitse tehdä mitään)
- Käsittely: tulokset analysoidaan ja syntetisoidaan
- Vastaus: lopullinen teksti generoidaan siihen liittyvine lähdeviitteineen
Tämä mekanismi tarkoittaa, että malli voi päättää jättää haun väliin, jos kysymys ei sitä perustele. Esimerkiksi fotosynteesin määritelmän kysyminen ei todennäköisesti käynnistä verkkohakua.
Käyttö eri SDK:iden kanssa
xAI SDK tarjoaa erityisen web_search()-funktion, joka välitetään keskustelun työkalulistaan:
# Natiivi xAI SDK
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import web_search
client = Client()
chat = client.chat.create(model="grok-4.5", tools=[web_search()])
chat.append(user("Latest AI news in Europe"))
response = chat.sample()
print(response.content)
print(response.citations)
openai-SDK:lla kyseessä on tunnin alussa nähty kutsu: client.responses.create() parametrilla base_url="https://api.x.ai/v1" ja tools=[{"type": "web_search"}].
Vercel AI SDK:lle JavaScriptissä:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Latest AI news in Europe",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Käytännön harjoitus
Luo skripti, joka kysyy Grokilta valitsemaasi ajankohtaista tapahtumaa. Varmista, että vastaus sisältää tuoreita tietoja (päivämääriä, tapahtumia, jotka ovat sattuneet mallin tiedonkatkaisupäivämäärän jälkeen). Kokeile sitten samaa kysymystä ilman web_search-työkalua nähdäksesi eron.
Keskeiset asiat
- Verkkohaku aktivoituu lisäämällä
{"type": "web_search"}kohtaantools(openai-SDK, Responses API) taiweb_search()kohtaanclient.chat.create(xai-sdk) - Se toimii vain Responses API:ssa (ei Chat Completionsissa)
- Malli päättää itsenäisesti, milloin sen tarvitsee hakea tietoa
- Lähdeviitteet sisällytetään vastaukseen automaattisesti
- Kustannus on 5 dollaria per 1 000 työkalukutsua plus kulutetut tokenit