Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Aktiviraj pretraživanje weba u API-ju

Lekcija 4 od 16 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Omogući Groku pristup webu u stvarnom vremenu
  2. Preduvjeti: Responses API
  3. Osnovna aktivacija
  4. Aktivacija s xAI SDK-om (Python)
  5. Aktivacija s OpenAI SDK-om
  6. Aktivacija s Vercel AI SDK-om
  7. Kombiniraj pretraživanje weba s drugim alatima
  8. Ključne točke

Ažurirano 2. studenoga 2026. Na temelju dokumentacije xAI: uz xai-sdk, pretraživanje weba omogućuje se funkcijom web_search() uvezenom iz xai_sdk.tools, unutar razgovora stvorenog pomoću client.chat.create; stari primjer koji je pozivao client.tools.web_search() i client.responses.create() ne postoji u ovom SDK-u. Izvor: Web Search.

Omogući Groku pristup webu u stvarnom vremenu

Pretraživanje weba najčešće korišteni integrirani alat u Grok API-ju. Modelu omogućuje traženje ažurnih informacija na webu, čime se prevladava prirodno ograničenje njegovih podataka za obuku. Aktivacija je jednostavna, no postoji nekoliko ključnih točaka koje moraš savladati za učinkovitu uporabu.

Odgovori
Potreban API
5
Filtrirane domene
Automatski
Uključene citacije
$5
/ 1.000 poziva

Preduvjeti: Responses API

Pretraživanje weba dostupno je isključivo na Responses API-ju. Stari Chat Completions API nudio je sustav „Live Search“ koji je sada zastario. Ako još uvijek koristiš Chat Completions za pretraživanje weba, moraš prijeći na Responses API.

Responses API koristi client.responses.create() umjesto client.chat.completions.create(). Struktura zahtjeva i odgovora razlikuje se, ali i xAI SDK i OpenAI SDK podržavaju oba pristupa.

Osnovna aktivacija

Pretraživanje weba omogućuješ dodavanjem objekta {"type": "web_search"} u polje tools svog zahtjeva:

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

To je sve što ti treba za osnovno pretraživanje weba. Model automatski određuje treba li izvršiti pretraživanje i formulira optimalni upit za pretraživanje na temelju korisničke poruke.

Aktivacija s xAI SDK-om (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 pruža funkciju web_search() koja generira objekt konfiguracije alata. Također prihvaća allowed_domains ili excluded_domains—do pet domena, i nikada obje opcije u istom zahtjevu.

Aktivacija s OpenAI SDK-om

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 radi s Grok API-jem jednostavnom promjenom base_url. Sintaksa alata ostaje identična.

Aktivacija s Vercel AI SDK-om

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 koristi xai.tools.webSearch() poštujući konvenciju camelCase u JavaScriptu.

Kombiniraj pretraživanje weba s drugim alatima

Možeš istovremeno omogućiti više alata. Model će odabrati najprikladniji ili će ih koristiti uzastopno:

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

U ovom primjeru model može pretraživati podatke na webu, a zatim ih analizirati pomoću izvršavanja koda.

Ključne točke

  • Pretraživanje weba dostupno je isključivo na Responses API-ju—Chat Completions je zastario za ovu značajku
  • Omogući ga s {"type": "web_search"} u polju tools
  • Model automatski odlučuje kada i kako pretraživati
  • Svi SDK-ovi (xAI, OpenAI, Vercel AI) podržavaju pretraživanje weba
  • U istom zahtjevu možeš istovremeno omogućiti više alata