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

Ota verkkohaku käyttöön rajapinnassa

Oppitunti 4 / 16 Päivitetty 2. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Anna Grokille reaaliaikainen pääsy verkkoon
  2. Edellytykset: Responses-rajapinta
  3. Perusaktivointi
  4. Aktivointi xAI SDK:lla (Python)
  5. Aktivointi OpenAI SDK:lla
  6. Aktivointi Vercel AI SDK:lla
  7. Yhdistä verkkohaku muihin työkaluihin
  8. Keskeiset asiat

Päivitetty 2. marraskuuta 2026. xAI:n dokumentaation mukaan: xai-sdk:lla verkkohaku otetaan käyttöön xai_sdk.tools-moduulista tuotavalla web_search()-funktiolla keskustelussa, joka on luotu client.chat.create-funktiolla; vanha esimerkki, jossa kutsuttiin client.tools.web_search() ja client.responses.create, ei toimi tässä SDK:ssa, koska näitä funktioita ei ole olemassa. Lähde: Web Search.

Anna Grokille reaaliaikainen pääsy verkkoon

Verkkohaku on Grok-rajapinnan käytetyin integroitu työkalu. Se mahdollistaa mallin haun ajantasaisesta tiedosta verkosta, kurottaen umpeen sen koulutusdatan luonnollisen vanhenemisen. Aktivointi on yksinkertaista, mutta tehokkaaseen käyttöön vaaditaan muutaman keskeisen seikan hallintaa.

Responses
Vaadittu rajapinta
5
Suodatettavat verkkotunnukset
Automaattinen
Lähdeviitteet mukana
$5
/ 1 000 hakua

Edellytykset: Responses-rajapinta

Verkkohaku on käytettävissä yksinomaan Responses-rajapinnassa. Vanhempi Chat Completions -rajapinta tarjosi “Live Search” -järjestelmän, joka on nyt vanhentunut. Jos käytät edelleen Chat Completionsia verkkohakuun, sinun on siirryttävä Responses-rajapintaan.

Responses-rajapinta käyttää funktiota client.responses.create() client.chat.completions.create():n sijaan. Pyyntö- ja vastausrakenne eroavat toisistaan, mutta sekä xAI SDK että OpenAI SDK tukevat niitä.

Perusaktivointi

Ottaa verkkohaun käyttöön lisäämällä {"type": "web_search"} -objektin pyyntösi tools-taulukkoon:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What are the latest advancements in artificial intelligence?",
  "tools": [
    {"type": "web_search"}
  ]
}

Tämä riittää perustason verkkohakuun. Malli määrittää automaattisesti, suorittaako se haun, ja muodostaa optimaalisen hakulausekkeen käyttäjän viestin perusteella.

Aktivointi xAI SDK:lla (Python)

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.20-0309-reasoning",
    tools=[web_search()],
)
chat.append(user("What are the latest advancements in AI?"))

response = chat.sample()
print(response.content)
print(response.citations)

SDK tarjoaa web_search()-funktion, joka generoi työkalun konfiguraatio-objektin. Se hyväksyy myös parametrit allowed_domains tai excluded_domains – enintään viisi verkkotunnusta, eikä molempia saa koskaan käyttää samassa pyynnössä.

Aktivointi OpenAI SDK:lla

from openai import OpenAI

client = OpenAI(
    api_key="xai-your-key",
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest advancements in AI?",
    tools=[{"type": "web_search"}]
)

OpenAI SDK toimii Grok-rajapinnan kanssa muuttamalla pelkästään base_url:n. Työkalun syntaksi pysyy identtisenä.

Aktivointi Vercel AI SDK:lla

import { xai } from "@ai-sdk/xai";

const response = await generateText({
  model: xai("grok-4.20-0309-reasoning"),
  prompt: "What are the latest advancements in AI?",
  tools: [xai.tools.webSearch()]
});

Vercel AI SDK käyttää funktiota xai.tools.webSearch() noudattaen JavaScriptin camelCase-nimeämiskäytäntöä.

Yhdistä verkkohaku muihin työkaluihin

Voit ottaa käyttöön useita työkaluja samanaikaisesti. Malli valitsee sopivimman työkalun tai käyttää niitä peräkkäin:

{
  "tools": [
    {"type": "web_search"},
    {"type": "code_interpreter"}
  ]
}

Tässä esimerkissä malli voi hakea dataa verkosta ja analysoida sitä sen jälkeen koodin suorituksen avulla.

Keskeiset asiat

  • Verkkohaku on käytettävissä yksinomaan Responses-rajapinnassa – Chat Completions on vanhentunut tämän ominaisuuden osalta
  • Ota se käyttöön lisäämällä {"type": "web_search"} tools-taulukkoon
  • Malli päättää automaattisesti, milloin ja miten haku suoritetaan
  • Kaikki SDK:t (xAI, OpenAI, Vercel AI) tukevat verkkohakua
  • Voit ottaa käyttöön useita työkaluja samanaikaisesti samassa pyynnössä