Įgalinti interneto paiešką API
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 2 d. Remiantis xAI dokumentacija: naudojant
xai-sdk, interneto paieška įgalinama perweb_search()funkciją, importuojamą išxai_sdk.tools, pokalbyje, sukurtame suclient.chat.create; senajame pavyzdyje buvo kviečiamaclient.tools.web_search()irclient.responses.create, ko šiame SDK nėra. Šaltinis: Web Search.
Suteik Grok prieigą prie interneto realiuoju laiku
Interneto paieška yra dažniausiai naudojamas integruotas įrankis Grok API. Ji leidžia modeliui ieškoti naujausios informacijos internete, taip peržengiant natūralią jo mokymo duomenų ribą. Aktyvavimas yra paprastas, tačiau norint jį naudoti efektyviai, reikia įvaldyti keletą svarbių dalykų.
Būtinos sąlygos: „Responses“ API
Interneto paieška galima tik naudojant „Responses“ API. Senasis „Chat Completions“ API turėjo „Live Search“ sistemą, kuri dabar yra pasenusi. Jei vis dar naudoji „Chat Completions“ interneto paieškai, privalai pereiti prie „Responses“ API.
„Responses“ API naudoja client.responses.create() vietoj client.chat.completions.create(). Užklausos ir atsakymo struktūra skiriasi, tačiau abi palaiko tiek xAI SDK, tiek OpenAI SDK.
Pagrindinis aktyvavimas
Interneto paiešką įgalini pridėdamas objektą {"type": "web_search"} į savo užklausos masyvą tools:
{
"model": "grok-4.20-0309-reasoning",
"input": "Kokie yra naujausi dirbtinio intelekto pasiekimai?",
"tools": [
{"type": "web_search"}
]
}
Tai viskas, ko reikia pagrindinei interneto paieškai. Modelis automatiškai nusprendžia, ar atlikti paiešką, ir suformuluoja optimalią paieškos užklausą pagal vartotojo žinutę.
Aktyvavimas naudojant xAI SDK (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("Kokie yra naujausi DI pasiekimai?"))
response = chat.sample()
print(response.content)
print(response.citations)
SDK pateikia funkciją web_search(), kuri sugeneruoja įrankio konfigūracijos objektą. Ji taip pat priima parametrus allowed_domains arba excluded_domains – iki penkių domenų, ir niekada abu kartu toje pačioje užklausoje.
Aktyvavimas naudojant OpenAI SDK
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="Kokie yra naujausi DI pasiekimai?",
tools=[{"type": "web_search"}]
)
OpenAI SDK veikia su Grok API tiesiog pakeitus base_url. Įrankio sintaksė lieka identiška.
Aktyvavimas naudojant Vercel AI SDK
import { xai } from "@ai-sdk/xai";
const response = await generateText({
model: xai("grok-4.20-0309-reasoning"),
prompt: "Kokie yra naujausi DI pasiekimai?",
tools: [xai.tools.webSearch()]
});
Vercel AI SDK naudoja xai.tools.webSearch() laikydamasis „JavaScript“ camelCase konvencijos.
Interneto paieškos derinimas su kitais įrankiais
Gali vienu metu įgalinti kelis įrankius. Modelis pasirinks tinkamiausią arba naudos juos nuosekliai:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
Šiame pavyzdyje modelis gali ieškoti duomenų internete, o tada juos analizuoti naudodamas kodo vykdymą.
Svarbiausi punktai
- Interneto paieška galima tik naudojant „Responses“ API – ši funkcija „Chat Completions“ yra pasenusi
- Įgalink ją pridėdamas
{"type": "web_search"}į masyvątools - Modelis automatiškai nusprendžia, kada ir kaip ieškoti
- Visi SDK (xAI, OpenAI, Vercel AI) palaiko interneto paiešką
- Toje pačioje užklausoje gali vienu metu įgalinti kelis įrankius