Filtruoti internetinės paieškos domenus
Šiame puslapyje
Valdyk šaltinius patikimiems rezultatams gauti
Integruodamas internetinę paiešką į verslo programą, nenori, kad modelis semtųsi informacijos iš bet kur. Teisiniam pokalbių robotui reikia oficialių šaltinių, medicinos asistentas turi remtis tik moksliniais leidiniais, o technologijų stebėsenos įrankis – tik nuorodomis į patikimas svetaines.
Grok API siūlo du filtravimo parametrus šaltiniams valdyti: allowed_domains ir excluded_domains. Šie parametrai suteikia tau tikslią paieškos aprėpties kontrolę.
Du filtravimo režimai
Leidimų sąrašas: allowed_domains
Šis parametras apriboja paiešką tik tavęs nurodytais domenais. Modelis nekonsultuos jokių kitų svetainių:
response = client.responses.create(
model="grok-4.5",
input="What are the latest advancements in AI?",
tools=[{
"type": "web_search",
"allowed_domains": ["arxiv.org", "nature.com", "science.org"]
}]
)
Draudimų sąrašas: excluded_domains
Šis parametras leidžia naudoti visus šaltinius, išskyrus tuos, kuriuos išvardiji. Naudinga norint atmesti nepatikimas svetaines ar konkurentus:
response = client.responses.create(
model="grok-4.5",
input="SaaS market analysis in France",
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com", "quora.com"]
}]
)
Abipusio išskirtinumo taisyklė
Parametrai allowed_domains ir excluded_domains yra abipusiai išskirtiniai. Vienu kvietimu negali naudoti abiejų vienu metu. Jei bandysi juos derinti, API grąžins klaidą.
Pasirink strategiją pagal naudojimo atvejį:
- Leidimų sąrašas (
allowed_domains): kai tiksliai žinai, kurie šaltiniai yra patikimi, o visi kiti kelia abejonių. - Draudimų sąrašas (
excluded_domains): kai dauguma šaltinių yra priimtini, tačiau keli kelia problemų.
Penkių domenų limitas
Kiekvienas parametras priima daugiausia 5 domenus. Šis apribojimas verčia teikti pirmenybę savo šaltiniams. Jei reikia aprėpti daugiau svetainių, apsvarstyk galimybę atlikti kelis kvietimus su skirtingais sąrašais arba naudok draudimų sąrašą, kad užblokuotum kelias problemines domenas.
Domenų sintaksė
Nurodyk domenus be protokolo ir be pasvirųjų brūkšnių gale:
# Teisingai
"allowed_domains": ["arxiv.org", "nature.com"]
# Neteisingai
"allowed_domains": ["https://arxiv.org/", "www.nature.com"]
Praktiniai naudojimo atvejai
Mokslinių tyrimų asistentas
tools=[{
"type": "web_search",
"allowed_domains": [
"arxiv.org",
"pubmed.ncbi.nlm.nih.gov",
"scholar.google.com",
"nature.com",
"science.org"
]
}]
Europos reglamentų stebėsena
tools=[{
"type": "web_search",
"allowed_domains": [
"eur-lex.europa.eu",
"legifrance.gouv.fr",
"cnil.fr",
"ec.europa.eu"
]
}]
Įmonės pokalbių robotas be socialinių tinklų
tools=[{
"type": "web_search",
"excluded_domains": [
"twitter.com",
"facebook.com",
"reddit.com",
"tiktok.com"
]
}]
Dinaminė filtravimo strategija
Realioje programoje filtravimą gali pritaikyti pagal vartotojo užklausos kontekstą:
def get_search_config(category):
configs = {
"legal": {
"allowed_domains": ["legifrance.gouv.fr", "eur-lex.europa.eu"]
},
"tech": {
"excluded_domains": ["pinterest.com", "quora.com"]
},
"general": {}
}
return configs.get(category, {})
search_params = get_search_config(user_category)
tools = [{"type": "web_search", **search_params}]
Praktinė užduotis
Sukurk asistentą, specializuotą tavo pasirinktoje srityje (teisė, mokslas, technologijos). Sukonfigūruok tinkamą domenų filtravimą ir išbandyk jį su keliais klausimais. Palygink rezultatus, gautus su filtravimu ir be jo, kad įvertintum jo poveikį atsakymų aktualumui.
Svarbiausi punktai
allowed_domainsapriboja paiešką leidimų sąrašu esančiomis svetainėmisexcluded_domainspašalina konkrečias svetaines iš paieškos- Abu parametrai yra abipusiai išskirtiniai: viename kvietime galima naudoti tik vieną
- Maksimalus domenų skaičius vienam parametrui – 5
- Domenus nurodyk be protokolo (
arxiv.org, o nehttps://arxiv.org) - Pritaikyk strategiją naudojimo atvejui: leidimų sąrašas jautrioms sritims, draudimų sąrašas lengvam filtravimui