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

Филтриране по X профили (handles)

Урок 9 от 16 Обновен 30 юли 2026 г. Програмист
На тази страница
  1. Таргетиране на конкретни профили в X
  2. Двата параметъра за филтриране
  3. Използване на allowed_x_handles (списък с разрешени)
  4. Използване на excluded_x_handles (списък с блокирани)
  5. Синтаксис на SDK
  6. Най-добри практики
  7. Ключови изводи

Таргетиране на конкретни профили в X

Точно както функцията за уеб търсене Ви позволява да филтрирате по домейни, търсенето в X Ви дава възможност да филтрирате по профили (handles). Можете да ограничите търсенията до публикации от конкретен набор от профили или да изключите определени профили от резултатите. Това филтриране е от съществено значение за случаи на употреба като мониторинг, проследяване на бранда или анализ на инфлуенсъри.

Двата параметъра за филтриране

Търсенето в X предлага два параметъра за филтриране по профили:

  • allowed_x_handles: ограничава търсенето до публикации от изброените профили (списък с разрешени)
  • excluded_x_handles: изключва публикациите от изброените профили (списък с блокирани)

Както при уеб търсенето, тези параметри са взаимно изключващи се. Не можете да използвате и двата в една и съща заявка.

Всеки параметър приема масив от до 10 профила (в сравнение с 5 домейна за уеб търсене).

Използване на allowed_x_handles (списък с разрешени)

Този параметър е идеален за мониторинг на комуникацията от конкретни профили:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest announcements from xAI?",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["xaboratory", "xaboratorydev"]
    }]
)

Моделът ще търси само публикации, публикувани от тези профили.

Случаи на употреба на списъка с разрешени

  • Конкурентно разузнаване: мониторинг на обявленията на Вашите конкуренти
  • Мониторинг на бранда: проследяване на Вашите официални профили и тези на Вашите амбасьори
  • Анализ на инфлуенсъри: агрегиране на мнения от панел от експерти
  • Институционално проследяване: следене на профили на регулатори или официални организации

Използване на excluded_x_handles (списък с блокирани)

Този параметър Ви позволява да изключите определени профили, като ботове или нерелевантни акаунти:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What do developers think about the latest version of Python?",
    tools=[{
        "type": "x_search",
        "excluded_x_handles": ["bot_python_news", "spam_account"]
    }]
)

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

  • Изключване на ботове: премахване на автоматизирани акаунти от резултатите
  • Изключване на спам: филтриране на профили, известни с нискокачествено съдържание
  • Изключване на собствените Ви профили: анализиране на външни реакции без Вашите собствени публикации

Синтаксис на SDK

xAI SDK (Python)

from xai_sdk.tools import x_search

tools=[x_search(
    allowed_x_handles=["elonmusk", "xaboratory"]
)]

OpenAI SDK (Python)

tools=[{
    "type": "x_search",
    "allowed_x_handles": ["elonmusk", "xaboratory"]
}]

Vercel AI SDK (JavaScript)

tools: [xai.tools.xSearch({
  allowedXHandles: ["elonmusk", "xaboratory"]
})]

Обърнете внимание на конвенцията camelCase в JavaScript SDK: allowedXHandles вместо allowed_x_handles.

Най-добри практики

Избор между списък с разрешени и списък с блокирани

Използвайте списъка с разрешени, когато имате дефиниран набор от профили и искате само техните публикации. Това е най-точният и ефективен метод по отношение на токени.

Използвайте списъка с блокирани, когато искате широко търсене, но трябва да го почистите, като елиминирате известни източници на шум.

Оптимизиране на броя профили

С лимит от 10 профила, бъдете селективни. Ако трябва да мониторите повече от 10 акаунта, групирайте заявките си по тема или направете множество последователни извиквания.

Формат на профила

Профилите не включват символа @ (например xaboratory). Уверете се, че профилите са правилни – правописна грешка в името на профила просто ще върне липса на резултати за този акаунт.

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

  • Два параметъра: allowed_x_handles (списък с разрешени) и excluded_x_handles (списък с блокирани)
  • Взаимно изключващи се: само един наведнъж на заявка
  • Максимум 10 профила на параметър
  • Профилите се изписват без символа @: "elonmusk", а не "@elonmusk"
  • Идеално за мониторинг, проследяване на бранда и анализ на инфлуенсъри