Филтриране на домейни за уеб търсене
На тази страница
Контрол на източниците за надеждни резултати
Когато интегрирате уеб търсене в бизнес приложение, не искате моделът да извлича информация откъдето и да е. Правен чатбот трябва да се консултира с официални източници, медицински асистент трябва да се придържа към научни публикации, а инструмент за мониторинг на технологиите трябва да се насочи към референтни сайтове.
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) - Адаптирайте стратегията към случая на употреба: списък с позволени за чувствителни домейни, списък с изключени за леко филтриране