Filtrowanie domen
Na tej stronie
Kontroluj źródła wyszukiwania
Domyślnie narzędzie Web Search przeszukuje całą sieć. Sprawdza się to w przypadku ogólnych zapytań, ale często okazuje się niewystarczające w zastosowaniach profesjonalnych, gdzie potrzebujesz wiarygodnych i kontrolowanych źródeł. Filtrowanie domen pozwala ograniczyć wyniki do wybranych witryn lub wykluczyć z nich konkretne strony.
Dwa wzajemnie wykluczające się parametry
Web Search udostępnia dwa parametry filtrujące:
allowed_domains: ogranicza wyszukiwanie do określonych domen (biała lista)excluded_domains: wyklucza konkretne domeny z wyników (czarna lista)
Te dwa parametry są wzajemnie wykluczające. Nie możesz użyć ich jednocześnie w tym samym żądaniu. Próba zrobienia tego spowoduje zwrócenie błędu przez API.
Każdy parametr przyjmuje tablicę zawierającą maksymalnie 5 domen.
Użycie allowed_domains (biała lista)
Użyj tego parametru, gdy dokładnie wiesz, z jakich źródeł chcesz korzystać. Przykładowo, w badaniach naukowych:
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"]
}]
)
Model przeszuka wyłącznie te trzy domeny. Gwarantuje to, że wyniki pochodzą ze zweryfikowanych źródeł naukowych.
Zastosowania białej listy
- Badania naukowe: ogranicz do arxiv.org, scholar.google.com, nature.com
- Dokumentacja techniczna: ogranicz do oficjalnych stron technologicznych
- Wywiad konkurencyjny: ogranicz do stron konkurencji
- Zgodność z przepisami: ogranicz do źródeł rządowych lub regulacyjnych
Użycie excluded_domains (czarna lista)
Użyj tego parametru, gdy chcesz przeprowadzić szerokie wyszukiwanie, ale musisz wykluczyć niewiarygodne lub nieistotne źródła:
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"]
}]
)
Model przeszuka całą sieć z wyjątkiem wykluczonych domen.
Zastosowania czarnej listy
- Wyklucz fora: unikaj niezweryfikowanych opinii
- Wyklucz agregatory: unikaj zduplikowanych treści
- Wyklucz konkurencję: usuń ich treści z wyników
- Wyklucz paywalle: unikaj stron z niedostępną treścią
Składnia 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"]
})]
Zwróć uwagę na konwencję camelCase (allowedDomains) w SDK dla JavaScript.
Limity i najlepsze praktyki
Limit 5 domen może wydawać się restrykcyjny. W praktyce wymusza on selektywne podejście do źródeł, co poprawia jakość wyników. Jeśli potrzebujesz większej elastyczności, możesz wykonać wiele żądań z różnymi domenami, a następnie zagregować wyniki po stronie klienta.
Korzystając z allowed_domains, upewnij się, że wybrane domeny obejmują temat zapytania. Zbyt restrykcyjna domena może uniemożliwić modelowi znalezienie istotnych informacji, co może doprowadzić do udzielenia odpowiedzi bez aktualnych danych.
Kluczowe wnioski
- Dostępne są dwa parametry:
allowed_domains(biała lista) iexcluded_domains(czarna lista) - Wzajemnie wykluczające: nie można ich łączyć w tym samym żądaniu
- Maksymalnie 5 domen na parametr
- Biała lista idealnie nadaje się do kontrolowanych, wiarygodnych źródeł
- Czarna lista sprawdza się przy szerokich wyszukiwaniach z kilkoma wykluczeniami