Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Filtrēšana pēc domēna

Nodarbība 5 no 16 Atjaunota 2026. gada 30. jūlijs Programmētājs
Šajā lapā
  1. Meklēšanas avotu kontrole
  2. Divi savstarpēji izslēdzoši parametri
  3. allowed_domains (atļauto saraksta) izmantošana
  4. excluded_domains (bloķēto saraksta) izmantošana
  5. SDK sintakse
  6. Ierobežojumi un labākā prakse
  7. Galvenās atziņas

Meklēšanas avotu kontrole

Pēc noklusējuma tīmekļa meklēšana aptver visu internetu. Tas labi strādā vispārīgiem vaicājumiem, taču bieži vien nepietiek profesionāliem lietojumiem, kur nepieciešami uzticami un kontrolēti avoti. Filtrēšana pēc domēna ļauj ierobežot vai izslēgt konkrētas vietnes.

Divi savstarpēji izslēdzoši parametri

Tīmekļa meklēšana piedāvā divus filtrēšanas parametrus:

  • allowed_domains: ierobežo meklēšanu tikai norādītajos domēnos (atļauto saraksts)
  • excluded_domains: izslēdz konkrētus domēnus no rezultātiem (bloķēto saraksts)

Šie divi parametri ir savstarpēji izslēdzoši. Tu nevari tos izmantot vienā pieprasījumā vienlaicīgi. Ja mēģināsi to darīt, API atgriezīs kļūdu.

Katrs parametrs pieņem masīvu ar līdz 5 domēniem.

allowed_domains (atļauto saraksta) izmantošana

Izmanto šo parametru, kad precīzi zini, kurus avotus vēlies konsultēt. Piemēram, akadēmiskiem pētījumiem:

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 veiks meklēšanu tikai šajos trīs domēnos. Tas nodrošina, ka rezultāti nāk no pārbaudītiem zinātniskiem avotiem.

Atļauto sarakstu lietojumi

  • Akadēmiskie pētījumi: ierobežo līdz arxiv.org, scholar.google.com, nature.com
  • Tehniskā dokumentācija: ierobežo līdz oficiālajām tehnoloģiju vietnēm
  • Konkurences izlūkošana: ierobežo līdz konkurentu vietnēm
  • Normatīvā atbilstība: ierobežo līdz valdības vai regulējošo iestāžu avotiem

excluded_domains (bloķēto saraksta) izmantošana

Izmanto šo parametru, kad vēlies veikt plašu meklēšanu, bet tev jāizslēdz neuzticami vai neatbilstoši avoti:

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 veiks meklēšanu visā internetā, izņemot izslēgtos domēnus.

Bloķēto sarakstu lietojumi

  • Forumu izslēgšana: izvairies no nepārbaudītiem viedokļiem
  • Agregatoru izslēgšana: izvairies no dublēta satura
  • Konkurentu izslēgšana: neļauj viņu saturam nonākt tavos rezultātos
  • Maksas sienu izslēgšana: izvairies no vietnēm ar nepieejamu saturu

SDK sintakse

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

Ņem vērā camelCase konvenciju (allowedDomains) JavaScript SDK.

Ierobežojumi un labākā prakse

5 domēnu limits var šķist ierobežojošs. Praksē tas liek tev būt izvēlīgam attiecībā uz avotiem, kas uzlabo rezultātu kvalitāti. Ja tev nepieciešama lielāka elastība, vari veikt vairākus pieprasījumus ar dažādiem domēniem un apkopot rezultātus klienta pusē.

Izmantojot allowed_domains, pārliecinies, ka izvēlētie domēni aptver pieprasīto tēmu. Pārāk ierobežojošs domēns var liegt modelim atrast atbilstošu informāciju, kas varētu likt tam sniegt atbildi bez aktuāliem datiem.

Galvenās atziņas

  • Pieejami divi parametri: allowed_domains (atļauto saraksts) un excluded_domains (bloķēto saraksts)
  • Savstarpēji izslēdzoši: tu nevari tos apvienot vienā pieprasījumā
  • Maksimāli 5 domēni uz vienu parametru
  • Atļauto saraksts ir ideāls kontrolētiem, uzticamiem avotiem
  • Bloķēto saraksts darbojas plašām meklēšanām ar dažiem izņēmumiem