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

Filtriranje domen

Lekcija 5 od 16 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Nadzor virov iskanja
  2. Dva medsebojno izključujoča parametra
  3. Uporaba allowed_domains (seznam dovoljenih)
  4. Uporaba excluded_domains (seznam blokiranih)
  5. Skladnja SDK-ja
  6. Omejitve in najboljša praksa
  7. Ključne ugotovitve

Nadzor virov iskanja

Privzeto spletno iskanje preišče celoten splet. To dobro deluje za splošna vprašanja, pogosto pa odpove pri strokovnih primerih uporabe, kjer potrebuješ zanesljive in nadzorovane vire. Filtriranje domen ti omogoča, da omejiš ali izključiš določena spletna mesta.

Dva medsebojno izključujoča parametra

Spletno iskanje ponuja dva filtra:

  • allowed_domains: omeji iskanje na določene domene (seznam dovoljenih)
  • excluded_domains: iz rezultatov izključi določene domene (seznam blokiranih)

Ta dva parametra sta medsebojno izključujoča. V istem zahtevku ne moreš uporabiti obeh. Če poskusiš, API vrne napako.

Vsak parameter sprejme polje največ 5 domen.

Uporaba allowed_domains (seznam dovoljenih)

Ta parameter uporabi, ko točno veš, katere vire želiš uporabiti. Na primer pri akademskem raziskovanju:

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 išče samo po teh treh domenah. S tem zagotoviš, da rezultati prihajajo iz preverjenih znanstvenih virov.

Primeri uporabe seznama dovoljenih

  • Akademsko raziskovanje: omejitev na arxiv.org, scholar.google.com, nature.com
  • Tehnična dokumentacija: omejitev na uradna spletna mesta tehnologij
  • Konkurenčna obveščevalna dejavnost: omejitev na spletna mesta konkurentov
  • Skladnost s predpisi: omejitev na vladne ali regulativne vire

Uporaba excluded_domains (seznam blokiranih)

Ta parameter uporabi, ko želiš široko iskanje, vendar moraš izključiti nezanesljive ali nepomembne vire:

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 išče po celotnem spletu, razen po izključenih domenah.

Primeri uporabe seznama blokiranih

  • Izključitev forumov: izogibanje nepreverjenim mnenjem
  • Izključitev agregatorjev: izogibanje podvojeni vsebini
  • Izključitev konkurentov: njihova vsebina se ne pojavi v tvojih rezultatih
  • Izključitev plačljivih vsebin: izogibanje mestom z nedostopno vsebino

Skladnja SDK-ja

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"]
})]

Upoštevaj konvencijo camelCase (allowedDomains) v JavaScript SDK-ju.

Omejitve in najboljša praksa

Omejitev na 5 domen se morda zdi restriktivna. V praksi te prisili k selektivnosti pri izbiri virov, kar izboljša kakovost rezultatov. Če potrebuješ več prilagodljivosti, lahko izvedeš več zahtevkov z različnimi domenami in rezultate združiš na strani odjemalca.

Ko uporabljaš allowed_domains, zagotovi, da izbrane domene pokrivajo zahtevano temo. Preveč omejujoča domena lahko modelu prepreči iskanje ustreznih informacij, zaradi česar bi lahko odgovoril brez najnovejših podatkov.

Ključne ugotovitve

  • Na voljo sta dva parametra: allowed_domains (seznam dovoljenih) in excluded_domains (seznam blokiranih)
  • Medsebojno izključujoča: v istem zahtevku ju ne moreš kombinirati
  • Največ 5 domen na parameter
  • Seznam dovoljenih je idealen za nadzorovane in zanesljive vire
  • Seznam blokiranih deluje za široka iskanja z nekaj izključitvami