Scagadh Fearainn
Ar an leathanach seo
Rialú ar fhoinsí cuardaigh
De réir réamhshocraithe, déanann Cuardach Gréasáin iniúchadh ar an ngréasán ar fad. Oibríonn sé seo go maith le haghaidh ceisteanna ginearálta, ach go minic teipeann air i gcásanna úsáide gairmiúla áit a bhfuil gá le foinsí iontaofa, rialaithe. Ligeann scagadh fearainn duit suíomhanna sonracha a shrianadh nó a eisiamh.
Dhá pharaiméadar comheisiacha
Tairgeann Cuardach Gréasáin dhá pharaiméadar scagtha:
allowed_domains: srianaíonn sé an cuardach le fearainn shonraithe (liosta ceadaithe)excluded_domains: eisiaíonn sé fearainn shonracha ó na torthaí (liosta bacainne)
Tá an dá pharaiméadar seo comheisiach. Ní féidir leat an bheirt a úsáid san iarratas céanna. Má dhéanann tú iarracht, fillfidh an API earráid.
Glacann gach paraiméadar le tacar de 5 fhearann ar a mhéad.
Úsáid allowed_domains (liosta ceadaithe)
Úsáid an paraiméadar seo nuair atá a fhios agat go beacht cé na foinsí ar mhaith leat a chomhairliú. Mar shampla, le haghaidh taighde acadúil:
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"]
}]
)
Déanann an múnéal cuardach ar na trí fhearann seo amháin. Cinntíonn sé seo go dtagann na torthaí ó fhoinsí eolaíocha fíoraithe.
Cásanna úsáide don liosta ceadaithe
- Taighde acadúil: teorainn le arxiv.org, scholar.google.com, nature.com
- Doiciméadú teicniúil: teorainn le suíomhanna oifigiúla teicneolaíochta
- Faisnéis iomaíochta: teorainn le suíomhanna iomaitheoirí
- Comhlíonadh rialála: teorainn le foinsí rialtais nó rialála
Úsáid excluded_domains (liosta bacainne)
Úsáid an paraiméadar seo nuair atá cuardach leathan uait ach gur gá duit foinsí neamhiontaofa nó nach mbaineann leat a eisiamh:
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"]
}]
)
Déanann an múnéal cuardach ar an ngréasán ar fad seachas na fearainn eisiata.
Cásanna úsáide don liosta bacainne
- Eisigh fóraim: seachain tuairimí neamhfhíoraithe
- Eisigh tiomsaitheoirí: seachain ábhar dúbailte
- Eisigh iomaitheoirí: coinnigh a gcuid ábhair as do chuid torthaí
- Eisigh paywalls: seachain suíomhanna le hábhar nach bhfuil inrochtana
Comhréir SDK
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"]
})]
Tabhair faoi deara an coinbhinsiún camelCase (allowedDomains) sa SDK JavaScript.
Teorainneacha agus dea-chleachtais
D’fhéadfadh sé go mbeadh an teorainn 5 fhearann dealraitheach sriantach. I gcleachtas, cuireann sé iallach ort a bheith roghnach faoi fhoinsí, rud a fheabhsaíonn cáilíocht na dtorthaí. Má tá níos mó solúbthachta uait, is féidir leat iarratais iolracha a rith le fearainn éagsúla agus na torthaí a thiomsú ar thaobh an chliaint.
Agus tú ag úsáid allowed_domains, déan cinnte go gcumhdaíonn na fearainn roghnaithe an t-ábhar a iarradh. D’fhéadfadh fearann atá ró-shriantach cosc a chur ar an múnéal faisnéis ábhartha a aimsiú, rud a d’fhéadfadh a bheith ina chúis leis freagairt gan sonraí cothrom le dáta.
Príomhphointí
- Dhá pharaiméadar ar fáil:
allowed_domains(liosta ceadaithe) agusexcluded_domains(liosta bacainne) - Comheisiach: ní féidir leat iad a chomhcheangal san iarratas céanna
- Uasmhéid 5 fhearann in aghaidh an pharaiméadair
- Is idéalach an liosta ceadaithe le haghaidh foinsí rialaithe, iontaofa
- Oibríonn an liosta bacainne le haghaidh cuardaigh leathana le roinnt eisiaimh