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

Ota verkkohaku käyttöön Grok API:ssa

Oppitunti 1 / 14 Päivitetty 3. marraskuuta 2026 Aloittelija
Tällä sivulla
  1. Miksi Grok kannattaa yhdistää reaaliaikaiseen verkkoon
  2. Responses API: Ainoa tuettu päätepiste
  3. Viisivaiheinen suoritusvirta
  4. Käyttö eri SDK:iden kanssa
  5. Käytännön harjoitus
  6. Keskeiset asiat

Päivitetty 2. marraskuuta 2026. xAI:n dokumentaation perusteella: xai-sdk:lla verkkohaku aktivoituu xai_sdk.tools-moduulista tuotavan web_search()-funktion kautta keskustelussa, joka on luotu client.chat.create-funktiolla; vanha esimerkki kutsui client.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()-funktiota xai-sdk-asiakkaalla, jolla ei ole responses-attribuuttia: tällä SDK:lla haku kulkee client.chat.create(..., tools=[web_search()])-kutsun kautta, ja client.responses.create() kuuluu openai-SDK:hon, joka on osoitettu osoitteeseen https://api.x.ai/v1. Vercel AI SDK -esimerkki välitti työkalut taulukkona eikä tuonut generateText:ää sisään: ne määritellään objektissa, kuten xAI:n dokumentaatiossa. Koodi on varmistettu versioilla xai-sdk 1.21.0 ja openai 3.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.

Verkkohaku Grokilla

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.

$5
per 1 000 kutsua
5
suodatettavaa verkkotunnusta
0
hallittavaa infrastruktuuria
Automaattinen
lähdeviitteet mukana

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:

  1. Analyysi: malli arvioi, vaatiiko kysymys tuoreita tietoja
  2. Päätös: se päättää joko hakea tietoa tai vastata sisäisellä tiedollaan
  3. Suoritus: verkkohaku suoritetaan palvelinpuolella (sinun ei tarvitse tehdä mitään)
  4. Käsittely: tulokset analysoidaan ja syntetisoidaan
  5. 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"} kohtaan tools (openai-SDK, Responses API) tai web_search() kohtaan client.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