Filtriranje domena
Na ovoj stranici
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) iexcluded_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