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

Omogoči spletno iskanje v API-ju

Lekcija 4 od 16 Posodobljeno 2. november 2026 Razvijalec
Na tej strani
  1. Groku omogoči dostop do spleta v realnem času
  2. Predpogoji: Responses API
  3. Osnovna aktivacija
  4. Aktivacija z xAI SDK (Python)
  5. Aktivacija z OpenAI SDK
  6. Aktivacija z Vercel AI SDK
  7. Združevanje spletnega iskanja z drugimi orodji
  8. Ključne ugotovitve

Posodobljeno 2. novembra 2026. Na podlagi dokumentacije xAI: pri uporabi xai-sdk je spletno iskanje omogočeno prek funkcije web_search(), uvožene iz xai_sdk.tools, v pogovoru, ustvarjenem z client.chat.create; stari primer, ki je klical client.tools.web_search() in client.responses.create, v tem SDK-ju ne obstaja. Vir: Web Search.

Groku omogoči dostop do spleta v realnem času

Spletno iskanje je najbolj uporabljeno integrirano orodje v API-ju Grok. Modelu omogoča iskanje najnovejših informacij na spletu in tako presega naravno omejitev njegovih učnih podatkov. Aktivacija je preprosta, vendar moraš za učinkovito uporabo obvladati nekaj ključnih točk.

Responses
Zahtevani API
5
Domen, ki jih je mogoče filtrirati
Samodejno
Vključeni citati
5 $
/ 1.000 klicev

Predpogoji: Responses API

Spletno iskanje je na voljo izključno v Responses API-ju. Stari API Chat Completions je ponujal sistem „Live Search”, ki je zdaj opuščen. Če za spletno iskanje še vedno uporabljaš Chat Completions, moraš preiti na Responses API.

Responses API namesto client.chat.completions.create() uporablja client.responses.create(). Struktura zahtevka in odgovora se razlikuje, vendar oba podpirata tako xAI SDK kot OpenAI SDK.

Osnovna aktivacija

Spletno iskanje omogočiš tako, da v polje tools svojega zahtevka dodaš objekt {"type": "web_search"}:

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

To je vse, kar potrebuješ za osnovno spletno iskanje. Model samodejno določi, ali naj izvede iskanje, in na podlagi uporabnikovega sporočila oblikuje optimalni iskalni poizvedbi.

Aktivacija z 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("What are the latest advancements in AI?"))

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

SDK ponuja funkcijo web_search(), ki ustvari konfiguracijski objekt orodja. Sprejema tudi parametra allowed_domains ali excluded_domains – do pet domen, nikoli pa obeh hkrati v istem zahtevku.

Aktivacija z 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="What are the latest advancements in AI?",
    tools=[{"type": "web_search"}]
)

OpenAI SDK deluje z API-jem Grok tako, da preprosto spremeniš base_url. Sintaksa orodja ostaja enaka.

Aktivacija z Vercel AI SDK

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 uporablja xai.tools.webSearch() v skladu s konvencijo camelCase za JavaScript.

Združevanje spletnega iskanja z drugimi orodji

Hkrati lahko omogočiš več orodij. Model bo izbral najustreznejše ali pa jih uporabil zaporedno:

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

V tem primeru lahko model poišče podatke na spletu in jih nato analizira z izvajanjem kode (Code Execution).

Ključne ugotovitve

  • Spletno iskanje je na voljo izključno v Responses API-ju – Chat Completions je za to funkcijo opuščen
  • Omogočiš ga z {"type": "web_search"} v polju tools
  • Model samodejno odloči, kdaj in kako iskati
  • Vsi SDK-ji (xAI, OpenAI, Vercel AI) podpirajo spletno iskanje
  • V istem zahtevku lahko hkrati omogočiš več orodij