Filtrování podle účtů na X
Na této stránce
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) aexcluded_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ů