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

Veebiotsingu lubamine API-s

Õppetund 4 / 16 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Anna Grokile reaalajas juurdepääs veebile
  2. Eeldused: Responses API
  3. Põhiline aktiveerimine
  4. Aktiveerimine xAI SDK-ga (Python)
  5. Aktiveerimine OpenAI SDK-ga
  6. Aktiveerimine Vercel AI SDK-ga
  7. Kombineeri veebiotsing teiste tööriistadega
  8. Peamised punktid

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

Anna Grokile reaalajas juurdepääs veebile

Veebiotsing on Grok API kõige enam kasutatav integreeritud tööriist. See võimaldab mudelil otsida ajakohast teavet veebist, ületades nii selle treeningandmete loomuliku piirangu. Aktiveerimine on lihtne, kuid tõhusaks kasutamiseks tuleb valdada mõned võtmepunktid.

Responses
Nõutav API
5
Filtreeritavad domeenid
Automaatne
Tsiteeringud kaasatud
$5
/ 1000 päringut

Eeldused: Responses API

Veebiotsing on saadaval ainult Responses API kaudu. Vana Chat Completions API pakkus „Live Search“ süsteemi, mis on nüüd aegunud. Kui kasutad veebiotsinguks endiselt Chat Completionsi, pead migreeruma Responses API-le.

Responses API kasutab meetodit client.responses.create() meetodi client.chat.completions.create() asemel. Päringu ja vastuse struktuur erineb, kuid nii xAI SDK kui ka OpenAI SDK toetavad mõlemat.

Põhiline aktiveerimine

Lubad veebiotsingu, lisades oma päringus massiivi tools objekti {"type": "web_search"}:

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

See on kõik, mida vajad põhitasemel veebiotsinguks. Mudel määrab automaatselt, kas otsingut teha, ja formuleerib kasutaja sõnumi põhjal optimaalse otsingupäringu.

Aktiveerimine xAI SDK-ga (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 pakub funktsiooni web_search(), mis genereerib tööriista konfiguratsiooni objekti. See aktsepteerib ka parameetreid allowed_domains või excluded_domains – kuni viis domeeni, kuid mitte kunagi mõlemat samas päringus.

Aktiveerimine OpenAI SDK-ga

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 töötab Grok API-ga, muutes lihtalt base_url-i. Tööriista süntaks jääb identseks.

Aktiveerimine Vercel AI SDK-ga

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 kasutab JavaScripti camelCase konventsiooni järgi funktsiooni xai.tools.webSearch().

Kombineeri veebiotsing teiste tööriistadega

Saad korraga lubada mitu tööriista. Mudel valib kõige sobivama või kasutab neid järjestikku:

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

Selles näites saab mudel otsida andmeid veebist ja seejärel analüüsida neid koodi käivitamise (Code Execution) abil.

Peamised punktid

  • Veebiotsing on saadaval ainult Responses API kaudu – Chat Completions on selle funktsiooni jaoks aegunud
  • Luba see, lisades massiivi tools objekti {"type": "web_search"}
  • Mudel otsustab automaatselt, millal ja kuidas otsingut teha
  • Kõik SDK-d (xAI, OpenAI, Vercel AI) toetavad veebiotsingut
  • Saad samas päringus korraga lubada mitu tööriista