Filtrēšana pēc domēna
Šajā lapā
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) unexcluded_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