Filtrovanie domén vo webovom vyhľadávaní
Na tejto strane
Kontrola zdrojov pre spoľahlivé výsledky
Keď integruješ webové vyhľadávanie do firemnej aplikácie, nechceš, aby model čerpal informácie odkiaľkoľvek. Právny chatbot sa musí obracať na oficiálne zdroje, zdravotnícky asistent sa musí držať vedeckých publikácií a nástroj na monitorovanie technológií by sa mal zameriavať na referenčné stránky.
API Grok ponúka dva filtre na kontrolu zdrojov: allowed_domains a excluded_domains. Tieto parametre ti poskytujú granularitu pri riadení rozsahu vyhľadávania.
Dva režimy filtrovania
Zoznam povolených: allowed_domains
Tento parameter obmedzuje vyhľadávanie výlučne na domény, ktoré určíš. Model nebude konzultovať žiadne iné stránky:
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"]
}]
)
Zoznam vylúčených: excluded_domains
Tento parameter povoľuje všetky zdroje okrem tých, ktoré uvedieš. Je užitočný na vylúčenie nespoľahlivých stránok alebo konkurencie:
response = client.responses.create(
model="grok-4.5",
input="SaaS market analysis in France",
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com", "quora.com"]
}]
)
Pravidlo vzájomnej výlučnosti
Parametre allowed_domains a excluded_domains sú vzájomne výlučné. Nemôžeš ich použiť súčasne v rámci jedného volania. Ak sa ich pokúsiš kombinovať, API vráti chybu.
Svoju stratégiu vyber podľa použitia:
- Zoznam povolených (
allowed_domains): keď presne vieš, ktoré zdroje sú spoľahlivé a všetko ostatné je podozrivé - Zoznam vylúčených (
excluded_domains): keď je väčšina zdrojov prijateľná, ale niekoľko z nich spôsobuje problémy
Obmedzenie na päť domén
Každý parameter prijíma maximálne 5 domén. Toto obmedzenie ťa núti uprednostniť svoje zdroje. Ak potrebuješ pokryť viac stránok, zváž vykonanie viacerých volaní s rôznymi zoznamami alebo použi zoznam vylúčených na zablokovanie niekoľkých problematických domén.
Syntax domény
Domény uvádzaj bez protokolu alebo koncového lomítka:
# Správne
"allowed_domains": ["arxiv.org", "nature.com"]
# Nesprávne
"allowed_domains": ["https://arxiv.org/", "www.nature.com"]
Praktické prípady použitia
Asistent pre vedecký výskum
tools=[{
"type": "web_search",
"allowed_domains": [
"arxiv.org",
"pubmed.ncbi.nlm.nih.gov",
"scholar.google.com",
"nature.com",
"science.org"
]
}]
Monitorovanie európskej regulácie
tools=[{
"type": "web_search",
"allowed_domains": [
"eur-lex.europa.eu",
"legifrance.gouv.fr",
"cnil.fr",
"ec.europa.eu"
]
}]
Firemný chatbot bez sociálnych médií
tools=[{
"type": "web_search",
"excluded_domains": [
"twitter.com",
"facebook.com",
"reddit.com",
"tiktok.com"
]
}]
Dynamická stratégia filtrovania
V reálnej aplikácii môžeš prispôsobiť filtrovanie podľa kontextu požiadavky používateľa:
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}]
Praktické cvičenie
Vytvor asistenta špecializovaného na oblasť podľa tvojho výberu (právna, vedecká, technologická). Nakonfiguruj vhodné filtrovanie domén a otestuj ho pomocou niekoľkých otázok. Porovnaj získané výsledky s filtrovaním a bez neho, aby si zmeral vplyv na relevantnosť odpovedí.
Kľúčové poznatky
allowed_domainsobmedzuje vyhľadávanie na zoznam povolených stránokexcluded_domainsvylučuje konkrétne stránky z vyhľadávania- Oba parametre sú vzájomne výlučné: v jednom volaní použiješ len jeden
- Maximálne 5 domén na parameter
- Domény uvádzaj bez protokolu (
arxiv.org, niehttps://arxiv.org) - Prispôsob stratégiu použitiu: zoznam povolených pre citlivé domény, zoznam vylúčených pre ľahké filtrovanie