Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Aktiveeri veebiotsing Grok API-s

Õppetund 1 / 14 Värskendatud 3. november 2026 Algajatele
Sellel lehel
  1. Miks ühendada Grok reaalajas veebiga
  2. Responses API: ainus toetatud lõpp-punkt
  3. Viieastmeline täitmise voog
  4. Kasutamine erinevate SDK-dega
  5. Praktiline harjutus
  6. Peamised punktid

Uuendatud 2. novembril 2026. xAI dokumentatsiooni põhjal: xai-sdk puhul aktiveeritakse veebiotsing funktsiooniga web_search(), mis imporditakse moodulist xai_sdk.tools, vestluses, mille loob client.chat.create; vana näide kasutas kutset client.tools.web_search(), mida selles SDK-s ei eksisteeri. Allikas: Web Search.

Uuendatud 3. novembril 2026. Esimeses näites kutsuti xai-sdk kliendil meetodit client.responses.create(), kuid sellel kliendil puudub atribuut responses: selle SDK puhul toimub otsing läbi client.chat.create(..., tools=[web_search()]), samas kui client.responses.create() kuulub openai SDK-le, mis on suunatud aadressile https://api.x.ai/v1. Vercel AI SDK näides anti tööriistad edasi massiivina ja ei imporditud generateText-i: need deklareeritakse objektis, nagu on kirjeldatud xAI dokumentatsioonis. Kood on kontrollitud versioonidega xai-sdk 1.21.0 ja openai 3.42.1. Allikas: Web Search.

Miks ühendada Grok reaalajas veebiga

Klassikalised keelemudelid töötavad teadmistega, mis on külmutatud nende treeningkuupäeva seisuga. Arendajale, kes ehitab rakendusi, mis vajavad aktuaalseid andmeid (aktsiahinnad, uudised, sporditulemused, ilm), on see piirang saatuslik. Grok API tööriist web_search lahendab selle probleemi, võimaldades mudelil teha päringuid veebi reaalajas otse sinu API-kutse kaudu.

Veebiotsing Grokiga

Erinevalt teistest pakkujatest, kes nõuavad kolmandate osapoolte integratsioone või eraldi pistikprogramme, pakub xAI veebiotsingut kui serveripoolset sisseehitatud tööriista. Sul pole taristut, mida hallata: mudel otsustab ise, millal otsingut teha, käivitab päringu ja integreerib tulemused oma vastusesse.

$5
1000 kutse kohta
5
filtreeritavat domeeni
0
hallatavat taristut
Automaatne
viited kaasatud

Responses API: ainus toetatud lõpp-punkt

Veebiotsing toimib eranditult Responses API kaudu. Vana Chat Completionsi lõpp-punkt pakkus parameetrit search_parameters, kuid see on nüüd aegunud. Kui migreerud vanalt API-lt, pead oma kutsed kohandama.

Aktiveerimine toimub, lisades tööriista web_search oma päringus olevasse massiivi tools:

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="Milline on täna Pariisis ilm?",
    tools=[{"type": "web_search"}],
)

print(response.output_text)

See näide kasutab openai SDK-d, mis ühildub xAI Responses API-ga; allpool esitatud loomulik xAI SDK kasutab vestlusliidest.

See ongi kõik. Mudel analüüsib sinu sisendit, teeb kindlaks, kas ta vajab värsket teavet, ja käivitab otsingu automaatselt. Sul ei ole vaja hallata kutsete tsüklit ega tingimuslikku loogikat.

Viieastmeline täitmise voog

Kui saadad päringu, mille puhul on web_search lubatud, järgib protsess kindlat järjestust:

  1. Analüüs: mudel hindab, kas küsimus nõuab värskeid andmeid
  2. Otsus: ta valib, kas teha otsing või vastata oma sisemiste teadmiste põhjal
  3. Täitmine: veebiotsing käivitub serveripoolselt (sina ei haldagi midagi)
  4. Töötlemine: tulemused analüüsitakse ja sünteesitakse
  5. Vastus: lõplik tekst genereeritakse koos vastavate viidetega

See mehhanism tähendab, et mudel võib otsustada mitte otsingut teha, kui küsimus seda ei õigusta. Näiteks fotosünteesi definitsiooni küsimine tõenäoliselt veebiotsingut ei käivita.

Kasutamine erinevate SDK-dega

xAI SDK pakub spetsiaalset funktsiooni web_search(), mille saad edastada vestluse tööriistade loendisse:

# Loomulik 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("Viimased AI uudised Euroopas"))

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

openai SDK puhul on tegemist tunni alguses näidatud kutsega: client.responses.create() koos base_url="https://api.x.ai/v1" ja tools=[{"type": "web_search"}].

Vercel AI SDK jaoks JavaScriptis:

import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';

const { text, sources } = await generateText({
  model: xai.responses('grok-4.5'),
  prompt: "Viimased AI uudised Euroopas",
  tools: {
    web_search: xai.tools.webSearch(),
  },
});

console.log(text);
console.log('Citations:', sources);

Praktiline harjutus

Loo skript, mis küsib Grokilt mõne sinu valitud aktuaalse sündmuse kohta. Veendu, et vastus sisaldab värsket teavet (kuupäevad, sündmused, mis toimusid pärast mudeli teadmiste piirkuupäeva). Seejärel proovi sama küsimust ilma tööriistata web_search, et näha erinevust.

Peamised punktid

  • Veebiotsing aktiveeritakse parameetriga {"type": "web_search"} massiivis tools (openai SDK, Responses API) või funktsiooniga web_search() meetodis client.chat.create (xai-sdk)
  • See toimib ainult Responses API-l (mitte Chat Completionsil)
  • Mudel otsustab autonoomselt, millal on vaja otsingut teha
  • Viited lisatakse vastusele automaatselt
  • Maksumus on 5 dollarit 1000 tööriistakutse kohta, pluss tarbitud tokenid