Przejdź do głównej treści
Polski— Wybierz język
Menu

Filtrowanie domen

Lekcja 5 z 16 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. Kontroluj źródła wyszukiwania
  2. Dwa wzajemnie wykluczające się parametry
  3. Użycie allowed_domains (biała lista)
  4. Użycie excluded_domains (czarna lista)
  5. Składnia SDK
  6. Limity i najlepsze praktyki
  7. Kluczowe wnioski

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) i excluded_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