Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Filtrování podle účtů na X

Lekce 9 z 16 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Cílení na konkrétní účty na X
  2. Dva parametry pro filtrování
  3. Použití allowed_x_handles (povolený seznam)
  4. Použití excluded_x_handles (blokovaný seznam)
  5. Syntaxe SDK
  6. Osvědčené postupy
  7. Klíčové poznatky

Cílení na konkrétní účty na X

Stejně jako Web Search umožňuje filtrovat podle domén, X Search ti umožňuje filtrovat podle účtů (handle). Můžeš omezit vyhledávání na příspěvky z konkrétní sady účtů, nebo určité účty z výsledků vyloučit. Toto filtrování je zásadní pro případy použití, jako je monitoring, sledování značky nebo analýza influencerů.

Dva parametry pro filtrování

X Search nabízí dva parametry pro filtrování podle handle:

  • allowed_x_handles: omezuje vyhledávání na příspěvky od uvedených účtů (povolený seznam)
  • excluded_x_handles: vylučuje příspěvky od uvedených účtů (blokovaný seznam)

Stejně jako u Web Search jsou tyto parametry vzájemně výhradné. Nemůžeš je použít oba ve stejné žádosti.

Každý parametr přijímá pole obsahující až 10 handle (v porovnání s 5 doménami u Web Search).

Použití allowed_x_handles (povolený seznam)

Tento parametr je ideální pro sledování komunikace od konkrétních účtů:

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"]
    }]
)

Model bude vyhledávat pouze příspěvky zveřejněné těmito účty.

Případy použití povoleného seznamu

  • Konkurenční zpravodajství: sleduj oznámení svých konkurentů
  • Monitoring značky: sleduj své oficiální účty a účty svých ambasadorů
  • Analýza influencerů: agreguj názory od panelu expertů
  • Institucionální sledování: sleduj účty regulátorů nebo oficiálních organizací

Použití excluded_x_handles (blokovaný seznam)

Tento parametr ti umožňuje vyloučit určité účty, jako jsou boti nebo irelevantní účty:

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"]
    }]
)

Případy použití blokovaného seznamu

  • Vyloučení botů: odstraň z výsledků automatizované účty
  • Vyloučení spamu: odfiltruj účty známé nízkou kvalitou obsahu
  • Vyloučení vlastních účtů: analyzuj externí reakce bez svých vlastních příspěvků

Syntaxe 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"]
})]

Všimni si konvence camelCase v JavaScript SDK: allowedXHandles místo allowed_x_handles.

Osvědčené postupy

Volba mezi povoleným a blokovaným seznamem

Použij povolený seznam, když máš definovanou sadu účtů a chceš pouze jejich příspěvky. Toto je nejpřesnější a z hlediska tokenů nejefektivnější metoda.

Použij blokovaný seznam, když chceš provádět široké vyhledávání, ale potřebuješ ho vyčistit odstraněním známých zdrojů šumu.

Optimalizace počtu handle

S limitem 10 handle buď vybíravý. Pokud potřebuješ sledovat více než 10 účtů, seskup své žádosti podle tématu nebo proveď více sekvenčních volání.

Formát handle

Handle neobsahují symbol @ (například xaboratory). Ověř, že jsou handle správná – překlep v handle jednoduše vrátí pro daný účet žádné výsledky.

Klíčové poznatky

  • Dva parametry: allowed_x_handles (povolený seznam) a excluded_x_handles (blokovaný seznam)
  • Vzájemně výhradné: v jedné žádosti vždy pouze jeden
  • Maximálně 10 handle na parametr
  • Handle se píší bez symbolu @: "elonmusk", nikoli "@elonmusk"
  • Ideální pro monitoring, sledování značky a analýzu influencerů