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

Filtriranje domena

Lekcija 5 od 16 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Kontrola izvora pretraživanja
  2. Dva međusobno isključiva parametra
  3. Korištenje allowed_domains (popis dopuštenih)
  4. Korištenje excluded_domains (popis blokiranih)
  5. Sintaksa SDK-a
  6. Ograničenja i najbolje prakse
  7. Ključne točke

Kontrola izvora pretraživanja

Zadano, Web Search pretražuje cijeli web. To dobro funkcionira za opće upite, ali često nije dovoljno za profesionalne slučajeve uporabe gdje su potrebni pouzdani i kontrolirani izvori. Filtriranje domena omogućuje ti ograničavanje ili isključivanje određenih web-mjesta.

Dva međusobno isključiva parametra

Web Search nudi dva parametra za filtriranje:

  • allowed_domains: ograničava pretraživanje na navedene domene (popis dopuštenih)
  • excluded_domains: isključuje određene domene iz rezultata (popis blokiranih)

Ova su dva parametra međusobno isključiva. Ne možeš ih koristiti oba u istom zahtjevu. Pokušaš li to učiniti, API će vratiti pogrešku.

Svaki parametar prihvaća polje od najviše 5 domena.

Korištenje allowed_domains (popis dopuštenih)

Ovaj parametar koristi kada točno znaš koje izvore želiš konzultirati. Na primjer, za akademsko istraživanje:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest publications on transformers?",
    tools=[{
        "type": "web_search",
        "allowed_domains": ["arxiv.org", "nature.com", "science.org"]
    }]
)

Model pretražuje samo ove tri domene. Time se osigurava da rezultati dolaze iz provjerenih znanstvenih izvora.

Slučajevi uporabe popisa dopuštenih

  • Akademsko istraživanje: ograniči na arxiv.org, scholar.google.com, nature.com
  • Tehnička dokumentacija: ograniči na službena mjesta tehnologija
  • Konkurentska obavještajna djelatnost: ograniči na mjesta konkurenata
  • Usklađenost s propisima: ograniči na vladine ili regulatorne izvore

Korištenje excluded_domains (popis blokiranih)

Ovaj parametar koristi kada želiš široko pretraživanje, ali moraš isključiti nepouzdane ili nebitne izvore:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the best JavaScript frameworks in 2026?",
    tools=[{
        "type": "web_search",
        "excluded_domains": ["reddit.com", "quora.com"]
    }]
)

Model pretražuje cijeli web osim isključenih domena.

Slučajevi uporabe popisa blokiranih

  • Isključi forume: izbjegni neprovjerena mišljenja
  • Isključi agregatore: izbjegni duplicirani sadržaj
  • Isključi konkurente: zadrži njihov sadržaj izvan svojih rezultata
  • Isključi paywallove: izbjegni mjesta s nedostupnim sadržajem

Sintaksa SDK-a

xAI SDK

tools=[client.tools.web_search(
    allowed_domains=["arxiv.org", "nature.com"]
)]

OpenAI SDK

tools=[{
    "type": "web_search",
    "excluded_domains": ["reddit.com"]
}]

Vercel AI SDK

tools: [xai.tools.webSearch({
  allowedDomains: ["arxiv.org", "nature.com"]
})]

Imaj na umu konvenciju camelCase (allowedDomains) u JavaScript SDK-u.

Ograničenja i najbolje prakse

Ograničenje od 5 domena može se činiti restriktivnim. U praksi te prisiljava da budeš selektivan pri odabiru izvora, što poboljšava kvalitetu rezultata. Ako ti treba više fleksibilnosti, možeš pokrenuti više zahtjeva s različitim domenama i agregirati rezultate na strani klijenta.

Kada koristiš allowed_domains, osiguraj da odabrane domene pokrivaju traženu temu. Previše restriktivna domena može spriječiti model da pronađe relevantne informacije, što bi ga moglo navesti da odgovori bez ažurnih podataka.

Ključne točke

  • Dostupna su dva parametra: allowed_domains (popis dopuštenih) i excluded_domains (popis blokiranih)
  • Međusobno isključivi: ne možeš ih kombinirati u istom zahtjevu
  • Maksimalno 5 domena po parametru
  • Popis dopuštenih idealan je za kontrolirane i pouzdane izvore
  • Popis blokiranih djeluje za široka pretraživanja s nekoliko izuzetaka