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

Filtrowanie domen w wyszukiwarce internetowej

Lekcja 2 z 14 Zaktualizowano 30 lipca 2026 Początkujący
Na tej stronie
  1. Kontroluj źródła, aby uzyskać wiarygodne wyniki
  2. Dwa tryby filtrowania
  3. Zasada wzajemnej wyłączności
  4. Limit pięciu domen
  5. Praktyczne przypadki użycia
  6. Dynamiczna strategia filtrowania
  7. Ćwiczenia praktyczne
  8. Kluczowe wnioski

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_domains ogranicza wyszukiwanie do białej listy stron
  • excluded_domains wyklucza 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 nie https://arxiv.org)
  • Dostosuj strategię do przypadku użycia: biała lista dla domen wrażliwych, czarna lista dla lekkiego filtrowania