Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Omogoči spletno iskanje v API-ju Grok

Lekcija 1 od 14 Posodobljeno 3. november 2026 Začetnik
Na tej strani
  1. Zakaj povezati Grok s spletom v realnem času
  2. API za odgovore: edina podprta končna točka
  3. Petstopenjski tok izvajanja
  4. Uporaba z različnimi SDK-ji
  5. Praktična vaja
  6. Ključne ugotovitve

Posodobljeno 2. novembra 2026. Na podlagi dokumentacije xAI: pri uporabi xai-sdk se spletno iskanje aktivira prek funkcije web_search(), uvožene iz xai_sdk.tools, znotraj pogovora, ustvarjenega z client.chat.create; stari primer je klical client.tools.web_search(), kar v tem SDK-ju ne obstaja. Vir: Web Search.

Posodobljeno 3. novembra 2026. Prvi primer je klical client.responses.create() na odjemalcu xai-sdk, ki nima atributa responses: pri tem SDK-ju poteka iskanje prek client.chat.create(..., tools=[web_search()]), medtem ko client.responses.create() spada v SDK openai, usmerjen na https://api.x.ai/v1. Primer Vercel AI SDK je orodja posredoval kot polje in ni uvozil generateText: ta jih deklarira v objektu, kot je zapisano v dokumentaciji xAI. Koda preverjena z različicama xai-sdk 1.21.0 in openai 3.42.1. Vir: Web Search.

Zakaj povezati Grok s spletom v realnem času

Klasični jezikovni modeli delujejo z znanjem, zamrznjenim na datum njihovega usposabljanja. Za razvijalca, ki gradi aplikacije, ki zahtevajo trenutne podatke (cene delnic, novice, športni rezultati, vreme), je ta omejitev nesprejemljiva. Orodje web_search v API-ju Grok rešuje ta problem tako, da modelu omogoča poizvedbe na spletu v realnem času, neposredno iz vašega klica API.

Spletno iskanje z Grokom

Za razliko od drugih ponudnikov, ki zahtevajo integracije tretjih strani ali ločene vtičnike, xAI ponuja spletno iskanje kot vgrajeno orodje na strani strežnika. Ni vam treba upravljati nobene infrastrukture: model sam odloči, kdaj iskati, izvede poizvedbo in rezultate vključi v svoj odgovor.

$5
na 1.000 klicev
5
domen z možnostjo filtriranja
0
infrastrukture za upravljanje
Samodejno
vključene citacije

API za odgovore: edina podprta končna točka

Spletno iskanje deluje izključno na API-ju za odgovore (Responses API). Stara končna točka Chat Completions je ponujala parameter search_parameters, vendar je zdaj zastarela. Če prehajate s starega API-ja, boste morali prilagoditi svoje klice.

Aktivacija poteka z dodajanjem orodja web_search v polje tools v vaši zahtevi:

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="Kakšno je danes vreme v Parizu?",
    tools=[{"type": "web_search"}],
)

print(response.output_text)

Ta primer uporablja SDK openai, združljiv z API-jem xAI Responses; domači SDK xAI, predstavljen spodaj, poteka prek pogovora.

To je vse. Model analizira vaš poziv, ugotovi, ali potrebuje sveže informacije, in samodejno sproži iskanje. Ni vam treba upravljati zanke klicev ali pogojne logike.

Petstopenjski tok izvajanja

Ko pošljete zahtevo z omogočenim web_search, postopek sledi določenemu zaporedju:

  1. Analiza: model oceni, ali vprašanje zahteva nedavne podatke
  2. Odločitev: se odloči za iskanje ali odgovor z notranjim znanjem
  3. Izvajanje: spletno iskanje teče na strani strežnika (vi ne upravljate ničesar)
  4. Obdelava: rezultati so analizirani in sintetizirani
  5. Odgovor: končno besedilo je ustvarjeno s pripadajočimi citati

Ta mehanizem pomeni, da se model lahko odloči, da ne bo iskal, če vprašanje tega ne upravičuje. Na primer, vprašanje po definiciji fotosinteze verjetno ne bo sprožilo spletnega iskanja.

Uporaba z različnimi SDK-ji

SDK xAI ponuja namensko funkcijo web_search(), ki jo posredujete v seznam orodij pogovora:

# Domači SDK xAI
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("Najnovejše novice o AI v Evropi"))

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

Pri SDK-ju openai gre za klic z začetka lekcije: client.responses.create() z base_url="https://api.x.ai/v1" in tools=[{"type": "web_search"}].

Za Vercel AI SDK v JavaScriptu:

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

const { text, sources } = await generateText({
  model: xai.responses('grok-4.5'),
  prompt: "Najnovejše novice o AI v Evropi",
  tools: {
    web_search: xai.tools.webSearch(),
  },
});

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

Praktična vaja

Ustvari skripto, ki poizveduje pri Groku o trenutnem dogodku po tvoji izbiri. Preveri, ali odgovor vsebuje nedavne informacije (datume, dogodke, ki so se zgodili po datumu zaključka usposabljanja modela). Nato poskusi isto vprašanje brez orodja web_search, da vidiš razliko.

Ključne ugotovitve

  • Spletno iskanje se aktivira z {"type": "web_search"} v tools (SDK openai, API Responses) ali web_search() v client.chat.create (xai-sdk)
  • Deluje samo na API-ju Responses (ne na Chat Completions)
  • Model samostojno odloči, kdaj potrebuje iskanje
  • Citati so samodejno vključeni v odgovor
  • Strošek znaša 5 $ na 1.000 klicev orodja, plus porabljeni žetoni