Филтриране по потребителски имена и дати в X
На тази страница
Прецизно насочване на Вашите търсения в X
Търсенето в X разкрива истинската си стойност, след като овладеете неговите параметри за филтриране. Вместо да извличате суров поток от публикации, можете да се насочите към конкретни акаунти, да зададете точни времеви прозорци и да изключите източници на шум. Тези филтри трансформират универсалния инструмент за търсене в прецизен инструмент за мониторинг.
Филтриране по потребителски имена: allowed_x_handles и excluded_x_handles
Мониторинг на конкретни акаунти
Параметърът allowed_x_handles ограничава търсенето само до публикации, публикувани от изброените от Вас акаунти. Можете да се насочите към до 10 потребителски имена едновременно:
response = client.responses.create(
model="grok-4.5",
input="Summary of recent announcements from these tech accounts",
tools=[{
"type": "x_search",
"allowed_x_handles": [
"elonmusk",
"sama",
"demishassabis",
"ylecun"
]
}]
)
Изключване на шумни акаунти
Параметърът excluded_x_handles работи обратно. Той позволява всички акаунти с изключение на тези, които посочите. Това е полезно за елиминиране на ботове или акаунти с нерелевантно съдържание:
response = client.responses.create(
model="grok-4.5",
input="Serious discussions on AI regulation",
tools=[{
"type": "x_search",
"excluded_x_handles": ["bot_spam_1", "compte_parodie"]
}]
)
Правило за взаимна изключителност
Подобно на уеб домейните, allowed_x_handles и excluded_x_handles са взаимно изключващи се. Не можете да ги комбинирате в едно извикване. Лимитът е 10 потребителски имена на параметър, което е двойно повече от лимита за уеб домейни.
Филтриране по дати: from_date и to_date
Временните параметри Ви позволяват да дефинирате точен прозорец за търсене във формат ISO 8601 (YYYY-MM-DD):
response = client.responses.create(
model="grok-4.5",
input="Reactions to the Grok 4.5 announcement",
tools=[{
"type": "x_search",
"from_date": "2026-03-01",
"to_date": "2026-03-15"
}]
)
Тези филтри са особено полезни за:
- Анализ на въздействието на събитие: дефинирайте периода около събитието
- Сравняване на настроенията преди/след: изпълнете две заявки с различни времеви прозорци
- Избягване на стар шум: фокусирайте се върху скорошни дискусии
Използване с родния Python SDK
xAI SDK приема Python обекти datetime в допълнение към ISO низове:
from xai_sdk.tools import x_search
from datetime import datetime
response = client.chat.create(
model="grok-4.5",
tools=[x_search(
from_date=datetime(2026, 3, 1),
to_date=datetime(2026, 3, 31)
)]
)
Конвенция camelCase в JavaScript
Vercel AI SDK използва конвенцията camelCase за имената на параметрите:
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk"],
fromDate: "2026-03-01",
toDate: "2026-03-31"
})]
Комбиниране на филтри
Можете да комбинирате потребителски имена и дати в едно извикване за максимална прецизност:
response = client.responses.create(
model="grok-4.5",
input="What did Sam Altman say about GPT-5 in March 2026?",
tools=[{
"type": "x_search",
"allowed_x_handles": ["sama"],
"from_date": "2026-03-01",
"to_date": "2026-03-31"
}]
)
Изграждане на динамична система за мониторинг
Чрез програмно комбиниране на тези филтри можете да изградите конфигурируем инструмент за мониторинг:
def create_x_monitor(handles, days_back=7):
from datetime import datetime, timedelta
today = datetime.now()
start = (today - timedelta(days=days_back)).strftime("%Y-%m-%d")
return {
"type": "x_search",
"allowed_x_handles": handles,
"from_date": start,
"to_date": today.strftime("%Y-%m-%d")
}
# Monitor AI leaders for the week
tool = create_x_monitor(
handles=["sama", "demishassabis", "ylecun"],
days_back=7
)
Упражнение
Конфигурирайте насочено търсене в X за 3 до 5 влиятелни акаунта във Вашия сектор. Задайте времеви прозорец от една седмица и сравнете резултатите с търсене без филтри за потребителски имена. Измерете разликата в релевантността.
Ключови изводи
allowed_x_handlesиexcluded_x_handlesфилтрират по акаунт (максимум 10 за всеки)- И двата параметъра за потребителски имена са взаимно изключващи се
from_dateиto_dateдефинират времевия прозорец във форматYYYY-MM-DD- Датите могат да се комбинират с филтри за потребителски имена
- Python SDK приема обекти
datetime, докато JavaScript SDK използва camelCase - Тези филтри трансформират X Search от универсален инструмент в насочен инструмент за мониторинг