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

Филтриране по потребителски имена и дати в X

Урок 6 от 14 Обновен 30 юли 2026 г. Начинаещ
На тази страница
  1. Прецизно насочване на Вашите търсения в X
  2. Филтриране по потребителски имена: allowed_x_handles и excluded_x_handles
  3. Филтриране по дати: from_date и to_date
  4. Комбиниране на филтри
  5. Изграждане на динамична система за мониторинг
  6. Упражнение
  7. Ключови изводи

Прецизно насочване на Вашите търсения в 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 от универсален инструмент в насочен инструмент за мониторинг