Премини към основното съдържание
Български— Изберете език
Меню

Филтриране на домейни за уеб търсене

Урок 2 от 14 Обновен 30 юли 2026 г. Начинаещ
На тази страница
  1. Контрол на източниците за надеждни резултати
  2. Двата режима на филтриране
  3. Правилото за взаимна изключителност
  4. Ограничение от пет домейна
  5. Практически случаи на употреба
  6. Динамична стратегия за филтриране
  7. Практическо упражнение
  8. Ключови изводи

Контрол на източниците за надеждни резултати

Когато интегрирате уеб търсене в бизнес приложение, не искате моделът да извлича информация откъдето и да е. Правен чатбот трябва да се консултира с официални източници, медицински асистент трябва да се придържа към научни публикации, а инструмент за мониторинг на технологиите трябва да се насочи към референтни сайтове.

API на Grok предлага два параметъра за филтриране, които контролират източниците: allowed_domains и excluded_domains. Тези параметри Ви осигуряват детайлен контрол върху обхвата на търсенето.

Двата режима на филтриране

Списък с позволени: allowed_domains

Този параметър ограничава търсенето само до домейните, които посочите. Моделът няма да консултира никакви други сайтове:

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"]
    }]
)

Списък с изключени: excluded_domains

Този параметър позволява всички източници с изключение на изброените от Вас. Полезно е за изключване на ненадеждни сайтове или конкуренти:

response = client.responses.create(
    model="grok-4.5",
    input="SaaS market analysis in France",
    tools=[{
        "type": "web_search",
        "excluded_domains": ["reddit.com", "quora.com"]
    }]
)

Правилото за взаимна изключителност

Параметрите allowed_domains и excluded_domains са взаимно изключващи се. Не можете да ги използвате едновременно в едно единствено извикване. Ако се опитате да ги комбинирате, API ще върне грешка.

Изберете стратегията си въз основа на случая на употреба:

  • Списък с позволени (allowed_domains): когато знаете точно кои източници са надеждни и всичко останало е подозрително
  • Списък с изключени (excluded_domains): когато повечето източници са приемливи, но няколко създават проблеми

Ограничение от пет домейна

Всеки параметър приема максимум 5 домейна. Това ограничение Ви принуждава да приоритизирате източниците си. Ако трябва да обхванете повече сайтове, помислете за извършване на множество извиквания с различни списъци или използвайте списъка с изключени, за да блокирате малкото проблемни домейни.

Синтаксис на домейна

Посочвайте домейните без протокол или наклонена черта в края:

# Правилно
"allowed_domains": ["arxiv.org", "nature.com"]

# Неправилно
"allowed_domains": ["https://arxiv.org/", "www.nature.com"]

Практически случаи на употреба

Асистент за научни изследвания

tools=[{
    "type": "web_search",
    "allowed_domains": [
        "arxiv.org",
        "pubmed.ncbi.nlm.nih.gov",
        "scholar.google.com",
        "nature.com",
        "science.org"
    ]
}]

Мониторинг на европейското регулиране

tools=[{
    "type": "web_search",
    "allowed_domains": [
        "eur-lex.europa.eu",
        "legifrance.gouv.fr",
        "cnil.fr",
        "ec.europa.eu"
    ]
}]

Корпоративен чатбот без социални медии

tools=[{
    "type": "web_search",
    "excluded_domains": [
        "twitter.com",
        "facebook.com",
        "reddit.com",
        "tiktok.com"
    ]
}]

Динамична стратегия за филтриране

В реално приложение можете да адаптирате филтрирането въз основа на контекста на заявката на потребителя:

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}]

Практическо упражнение

Създайте асистент, специализиран в област по Ваш избор (правна, научна, технологична). Конфигурирайте подходящото филтриране на домейни и го тествайте с няколко въпроса. Сравнете получените резултати с и без филтриране, за да измерите въздействието върху релевантността на отговора.

Ключови изводи

  • allowed_domains ограничава търсенето до списък с позволени сайтове
  • excluded_domains изключва конкретни сайтове от търсенето
  • И двата параметъра са взаимно изключващи се: само един на извикване
  • Максимум 5 домейна на параметър
  • Посочвайте домейните без протокол (arxiv.org, а не https://arxiv.org)
  • Адаптирайте стратегията към случая на употреба: списък с позволени за чувствителни домейни, списък с изключени за леко филтриране