Filtrowanie domen w wyszukiwarce internetowej
Na tej stronie
Kontroluj źródła, aby uzyskać wiarygodne wyniki
Gdy integrujesz wyszukiwanie internetowe z aplikacją biznesową, nie chcesz, aby model pobierał informacje z byle jakich miejsc. Chatbot prawny musi konsultować oficjalne źródła, asystent medyczny powinien ograniczać się do publikacji naukowych, a narzędzie do monitorowania technologii musi celować w strony referencyjne.
API Grok oferuje dwa parametry filtrowania pozwalające kontrolować źródła: allowed_domains i excluded_domains. Parametry te dają Ci szczegółową kontrolę nad zakresem wyszukiwania.
Dwa tryby filtrowania
Biała lista: allowed_domains
Ten parametr ogranicza wyszukiwanie wyłącznie do domen, które określisz. Model nie sprawdzi żadnych innych stron:
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"]
}]
)
Czarna lista: excluded_domains
Ten parametr pozwala na korzystanie ze wszystkich źródeł z wyjątkiem tych, które wymienisz. Przydatne do wykluczania niewiarygodnych stron lub konkurencji:
response = client.responses.create(
model="grok-4.5",
input="SaaS market analysis in France",
tools=[{
"type": "web_search",
"excluded_domains": ["reddit.com", "quora.com"]
}]
)
Zasada wzajemnej wyłączności
Parametry allowed_domains i excluded_domains są wzajemnie wyłączne. Nie możesz użyć obu jednocześnie w ramach jednego wywołania. Jeśli spróbujesz je połączyć, API zwróci błąd.
Wybierz strategię w zależności od przypadku użycia:
- Biała lista (
allowed_domains): gdy dokładnie wiesz, które źródła są wiarygodne, a wszystko inne budzi wątpliwości - Czarna lista (
excluded_domains): gdy większość źródeł jest akceptowalna, ale kilka stwarza problemy
Limit pięciu domen
Każdy parametr przyjmuje maksymalnie 5 domen. To ograniczenie zmusza Cię do priorytetyzacji źródeł. Jeśli musisz objąć więcej stron, rozważ wykonanie wielu wywołań z różnymi listami lub użyj czarnej listy, aby zablokować kilka problematycznych domen.
Składnia domeny
Określaj domeny bez protokołu i ukośnika końcowego:
# Poprawnie
"allowed_domains": ["arxiv.org", "nature.com"]
# Niepoprawnie
"allowed_domains": ["https://arxiv.org/", "www.nature.com"]
Praktyczne przypadki użycia
Asystent badań naukowych
tools=[{
"type": "web_search",
"allowed_domains": [
"arxiv.org",
"pubmed.ncbi.nlm.nih.gov",
"scholar.google.com",
"nature.com",
"science.org"
]
}]
Monitorowanie przepisów europejskich
tools=[{
"type": "web_search",
"allowed_domains": [
"eur-lex.europa.eu",
"legifrance.gouv.fr",
"cnil.fr",
"ec.europa.eu"
]
}]
Chatbot korporacyjny bez mediów społecznościowych
tools=[{
"type": "web_search",
"excluded_domains": [
"twitter.com",
"facebook.com",
"reddit.com",
"tiktok.com"
]
}]
Dynamiczna strategia filtrowania
W rzeczywistej aplikacji możesz dostosowywać filtrowanie w zależności od kontekstu żądania użytkownika:
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}]
Ćwiczenia praktyczne
Stwórz asystenta wyspecjalizowanego w wybranej przez Ciebie dziedzinie (prawo, nauka, technologia). Skonfiguruj odpowiednie filtrowanie domen i przetestuj je, zadając kilka pytań. Porównaj wyniki uzyskane z filtrowaniem i bez niego, aby zmierzyć wpływ na trafność odpowiedzi.
Kluczowe wnioski
allowed_domainsogranicza wyszukiwanie do białej listy stronexcluded_domainswyklucza konkretne strony z wyszukiwania- Oba parametry są wzajemnie wyłączne: tylko jeden na wywołanie
- Maksymalnie 5 domen na parametr
- Określaj domeny bez protokołu (
arxiv.org, a niehttps://arxiv.org) - Dostosuj strategię do przypadku użycia: biała lista dla domen wrażliwych, czarna lista dla lekkiego filtrowania