Филтриране на домейни
На тази страница
Контрол на източниците за търсене
По подразбиране функцията за уеб търсене обхожда целия интернет. Това работи добре за общи заявки, но често се оказва недостатъчно за професионални случаи на употреба, при които се нуждаете от надеждни и контролирани източници. Филтрирането на домейни Ви позволява да ограничите или изключите конкретни сайтове.
Два взаимно изключващи се параметъра
Уеб търсенето предлага два параметъра за филтриране:
allowed_domains: ограничава търсенето до посочените домейни (списък с разрешени)excluded_domains: изключва конкретни домейни от резултатите (списък с блокирани)
Тези два параметъра са взаимно изключващи се. Не можете да ги използвате и двата в една и съща заявка. Ако опитате, API ще върне грешка.
Всеки параметър приема масив от до 5 домейна.
Използване на allowed_domains (списък с разрешени)
Използвайте този параметър, когато знаете точно кои източници искате да консултирате. Например, за академични изследвания:
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"]
}]
)
Моделът търси само в тези три домейна. Това гарантира, че резултатите идват от проверени научни източници.
Случаи на употреба на списъка с разрешени
- Академични изследвания: ограничаване до arxiv.org, scholar.google.com, nature.com
- Техническа документация: ограничаване до официалните сайтове на технологиите
- Конкурентно разузнаване: ограничаване до сайтовете на конкурентите
- Регулаторно съответствие: ограничаване до правителствени или регулаторни източници
Използване на excluded_domains (списък с блокирани)
Използвайте този параметър, когато искате широко търсене, но трябва да изключите ненадеждни или нерелевантни източници:
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"]
}]
)
Моделът търси в целия уеб, с изключение на блокираните домейни.
Случаи на употреба на списъка с блокирани
- Изключване на форуми: избягване на непроверени мнения
- Изключване на агрегатори: избягване на дублирано съдържание
- Изключване на конкуренти: премахване на тяхното съдържание от Вашите резултати
- Изключване на платени стени (paywalls): избягване на сайтове с недостъпно съдържание
Синтаксис на 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"]
})]
Обърнете внимание на конвенцията camelCase (allowedDomains) в JavaScript SDK.
Ограничения и най-добри практики
Ограничението от 5 домейна може да изглежда ограничаващо. На практика то Ви принуждава да бъдете селективни към източниците, което подобрява качеството на резултатите. Ако се нуждаете от по-голяма гъвкавост, можете да изпълните множество заявки с различни домейни и да агрегирате резултатите на клиентска страна.
Когато използвате allowed_domains, уверете се, че избраните домейни покриват исканата тема. Твърде ограничителен домейн може да попречи на модела да намери релевантна информация, което би могло да го накара да отговори без актуални данни.
Ключови изводи
- Налични са два параметъра:
allowed_domains(списък с разрешени) иexcluded_domains(списък с блокирани) - Взаимно изключващи се: не можете да ги комбинирате в една и съща заявка
- Максимум 5 домейна на параметър
- Списъкът с разрешени е идеален за контролирани и надеждни източници
- Списъкът с блокирани работи добре за широки търсения с няколко изключения