Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Įgalinti žiniatinklio paiešką Grok API

Paskaita 1 iš 14 Atnaujinta 2026 m. lapkričio 3 d. Pradedantisiems
Šiame puslapyje
  1. Kodėl verta sujungti Grok su realiuoju laiku veikiančiu internetu
  2. „Responses“ API: vienintelis palaikomas galinis taškas
  3. Penkių žingsnių vykdymo eiga
  4. Naudojimas su skirtingais SDK
  5. Praktinė užduotis
  6. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 2 d. Remiantis xAI dokumentacija: naudojant xai-sdk, žiniatinklio paieška aktyvuojama per web_search() funkciją, importuojamą iš xai_sdk.tools, pokalbio, sukurto client.chat.create, kontekste; senajame pavyzdyje buvo kviečiama client.tools.web_search(), ko šiame SDK nėra. Šaltinis: Web Search.

Atnaujinta 2026 m. lapkričio 3 d. Pirmajame pavyzdyje xai-sdk klientui buvo kviečiama client.responses.create(), tačiau šis objektas neturi responses atributo: naudojant šį SDK, paieška vykdoma per client.chat.create(..., tools=[web_search()]), o client.responses.create() priklauso openai SDK, nukreiptam į https://api.x.ai/v1. Vercel AI SDK pavyzdyje įrankiai buvo perduodami kaip masyvas ir nebuvo importuojama generateText: jie deklaruojami objekte, kaip nurodyta xAI dokumentacijoje. Kodas patikrintas su xai-sdk 1.21.0 ir openai 3.42.1 versijomis. Šaltinis: Web Search.

Kodėl verta sujungti Grok su realiuoju laiku veikiančiu internetu

Klasikiniai kalbos modeliai dirba su žiniomis, kurios buvo „užšaldytos“ jų mokymo datos momentu. Kūrėjui, kuriančiam programėles, kurioms reikia naujausių duomenų (akcijų kainų, naujienų, sporto rezultatų, oro prognozių), šis apribojimas yra nepriimtinas. Grok API įrankis web_search išsprendžia šią problemą leisdamas modeliui realiuoju laiku ieškoti informacijos internete tiesiai iš tavo API užklausos.

Žiniatinklio paieška su Grok

Skirtingai nei kiti tiekėjai, reikalaujantys trečiųjų šalių integracijų arba atskirų papildinių, xAI siūlo žiniatinklio paiešką kaip serverio pusėje integruotą įrankį. Tau nereikia valdyti jokios infrastruktūros: modelis pats nusprendžia, kada ieškoti, įvykdo užklausą ir integruoja rezultatus į savo atsakymą.

$5
už 1 000 kvietimų
5
filtruojamų domenų
0
valdytinos infrastruktūros
Auto
citatos įtrauktos

„Responses“ API: vienintelis palaikomas galinis taškas

Žiniatinklio paieška veikia tik per Responses API. Senasis „Chat Completions“ galinis taškas turėjo search_parameters parametrą, tačiau dabar jis yra pasenęs. Jei migruoji nuo senosios API, turėsi pritaikyti savo kvietimus.

Aktyvavimas vyksta pridėjus web_search įrankį į tools masyvą savo užklausoje:

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="Koks šiandien oras Paryžiuje?",
    tools=[{"type": "web_search"}],
)

print(response.output_text)

Šiame pavyzdyje naudojamas openai SDK, suderinamas su xAI Responses API; toliau pateiktas vietinis xAI SDK veikia per pokalbį.

Tai viskas. Modelis išanalizuoja tavo užuominą, nustato, ar jam reikia naujausios informacijos, ir automatiškai inicijuoja paiešką. Tau nereikia valdyti kvietimų ciklo ar sąlyginės logikos.

Penkių žingsnių vykdymo eiga

Kai siunči užklausą su įjungta web_search, procesas vyksta pagal specifinę seką:

  1. Analizė: modelis įvertina, ar klausimui reikia naujausių duomenų
  2. Sprendimas: jis pasirenka – ieškoti ar atsakyti remdamasis vidinėmis žiniomis
  3. Vykdymas: žiniatinklio paieška vykdoma serverio pusėje (tu nieko nevaldai)
  4. Apdorojimas: rezultatai analizuojami ir sintezuojami
  5. Atsakymas: galutinis tekstas sugeneruojamas kartu su susijusiomis citatomis

Šis mechanizmas reiškia, kad modelis gali nuspręsti neieškoti, jei klausimas to nepateisina. Pavyzdžiui, klausimas apie fotosintezės apibrėžimą greičiausiai nesukels žiniatinklio paieškos.

Naudojimas su skirtingais SDK

xAI SDK suteikia specialią funkciją web_search(), kurią perduodi į pokalbio įrankių sąrašą:

# Vietinis 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("Naujausios DI naujienos Europoje"))

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

Naudojant openai SDK, tai yra pamokos pradžioje matytas kvietimas: client.responses.create() su base_url="https://api.x.ai/v1" ir tools=[{"type": "web_search"}].

JavaScript kalbai skirtam Vercel AI SDK:

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

const { text, sources } = await generateText({
  model: xai.responses('grok-4.5'),
  prompt: "Naujausios DI naujienos Europoje",
  tools: {
    web_search: xai.tools.webSearch(),
  },
});

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

Praktinė užduotis

Sukurk scenarijų, kuriuo užklausi Grok apie tau pasirinktą aktualų įvykį. Patikrink, ar atsakyme yra naujausios informacijos (datos, įvykiai, nutikę po modelio žinių ribos datos). Tada užduok tą patį klausimą be web_search įrankio, kad pamatytum skirtumą.

Svarbiausi punktai

  • Žiniatinklio paieška aktyvuojama naudojant {"type": "web_search"} masyve tools (openai SDK, Responses API) arba web_search() funkcijoje client.chat.create (xai-sdk)
  • Ji veikia tik per Responses API (ne per Chat Completions)
  • Modelis savarankiškai nusprendžia, kada reikia ieškoti
  • Citatos automatiškai įtraukiamos į atsakymą
  • Kaina yra 5 USD už 1 000 įrankio kvietimų, plius sunaudoti tokenai