Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Domenų filtravimas

Paskaita 5 iš 16 Atnaujinta 2026 m. liepos 30 d. Kūrėjas
Šiame puslapyje
  1. Paieškos šaltinių valdymas
  2. Du vienas kitą išskiriantys parametrai
  3. allowed_domains naudojimas (leidimų sąrašas)
  4. excluded_domains naudojimas (blokavimo sąrašas)
  5. SDK sintaksė
  6. Ribojimai ir geriausios praktikos
  7. Svarbiausi punktai

Paieškos šaltinių valdymas

Pagal numatytuosius nustatymus „Web Search“ naršo visą internetą. Tai puikiai tinka bendriesiems užklausoms, tačiau profesionaliems atvejams, kai reikia patikimų ir kontroliuojamų šaltinių, to dažnai nepakanka. Domenų filtravimas leidžia apriboti arba pašalinti konkrečias svetaines.

Du vienas kitą išskiriantys parametrai

„Web Search“ siūlo du filtravimo parametrus:

  • allowed_domains: apriboja paiešką nurodytais domenais (leidimų sąrašas)
  • excluded_domains: pašalina konkrečius domenus iš rezultatų (blokavimo sąrašas)

Šie du parametrai yra viena kitą išskiriantys. Toje pačioje užklausoje jų naudoti kartu negalima. Jei bandysi, API grąžins klaidą.

Kiekvienas parametras priima masyvą iš ne daugiau kaip 5 domenų.

allowed_domains naudojimas (leidimų sąrašas)

Šį parametrą naudok tada, kai tiksliai žinai, kuriuos šaltinius nori konsultuoti. Pavyzdžiui, atliekant akademinius tyrimus:

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

Modelis ieškos tik šiuose trijuose domenuose. Tai užtikrina, kad rezultatai bus gauti iš patikrintų mokslinių šaltinių.

Leidimų sąrašo naudojimo atvejai

  • Akademiniai tyrimai: apriboti arxiv.org, scholar.google.com, nature.com
  • Techninė dokumentacija: apriboti oficialiomis technologijų svetainėmis
  • Konkurencinė žvalgyba: apriboti konkurentų svetainėmis
  • Reguliavimo reikalavimų laikymasis: apriboti vyriausybiniais ar reguliavimo šaltiniais

excluded_domains naudojimas (blokavimo sąrašas)

Šį parametrą naudok, kai nori atlikti plačią paiešką, bet reikia pašalinti nepatikimus arba nereikšmingus šaltinius:

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

Modelis ieškos visame internete, išskyrus nurodytus domenus.

Blokavimo sąrašo naudojimo atvejai

  • Forumų išskyrimas: venk nepatvirtintų nuomonių
  • Agregatorių išskyrimas: venk pasikartojančio turinio
  • Konkurentų išskyrimas: neįtrauk jų turinio į rezultatus
  • Mokamų sienų (paywall) išskyrimas: venk svetainių su neprieinamu turiniu

SDK sintaksė

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

Atkreipk dėmesį į „camelCase“ konvenciją (allowedDomains) JavaScript SDK.

Ribojimai ir geriausios praktikos

5 domenų riba gali atrodyti ribojanti. Tačiau praktiškai tai verčia būti selektyviu renkantis šaltinius, o tai gerina rezultatų kokybę. Jei reikia daugiau lankstumo, gali vykdyti kelias užklausas su skirtingais domenais ir rezultatus agreguoti kliento pusėje.

Naudojant allowed_domains, įsitikink, kad pasirinkti domenai apima nagrinėjamą temą. Per daug ribojantis domenas gali neleisti modeliui rasti svarbios informacijos, todėl jis gali atsakyti remdamasis pasenusiais duomenimis.

Svarbiausi punktai

  • Galimi du parametrai: allowed_domains (leidimų sąrašas) ir excluded_domains (blokavimo sąrašas)
  • Viena kitą išskiriantys: jų negalima derinti toje pačioje užklausoje
  • Didžiausias limitas – 5 domenai vienam parametrui
  • Leidimų sąrašas idealiai tinka kontroliuojamiems ir patikimiems šaltiniams
  • Blokavimo sąrašas tinka plačioms paieškoms, kai reikia pašalinti tik kelis šaltinius