Ota verkkohaku käyttöön rajapinnassa
Tällä sivulla
Päivitetty 2. marraskuuta 2026. xAI:n dokumentaation mukaan:
xai-sdk:lla verkkohaku otetaan käyttöönxai_sdk.tools-moduulista tuotavallaweb_search()-funktiolla keskustelussa, joka on luotuclient.chat.create-funktiolla; vanha esimerkki, jossa kutsuttiinclient.tools.web_search()jaclient.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.
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ä