Filtrování podle účtů a dat na X
Na této stránce
Přesně zacil svá vyhledávání na X
Vyhledávání na X přináší skutečnou hodnotu až ve chvíli, kdy zvládneš jeho filtrační parametry. Místo tahání surového feedu příspěvků můžeš cílit na konkrétní účty, nastavit přesná časová okna a vyloučit zdroje šumu. Tyto filtry promění obecný vyhledávací nástroj v precizní nástroj pro monitorování.
Filtrování podle účtů: allowed_x_handles a excluded_x_handles
Sledování konkrétních účtů
Parametr allowed_x_handles omezuje vyhledávání pouze na příspěvky zveřejněné účty, které uvedeš. Můžeš cílit až na 10 účtů současně:
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"
]
}]
)
Vyloučení hlučných účtů
Parametr excluded_x_handles funguje obráceně. Povolí všechny účty kromě těch, které specifikuješ. Je užitečný pro eliminaci botů nebo účtů s irelevantním obsahem:
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"]
}]
)
Pravidlo vzájemné výlučnosti
Stejně jako u webových domén jsou allowed_x_handles a excluded_x_handles vzájemně výlučné. Nemůžeš je kombinovat v jediném volání. Limit je 10 účtů na parametr, což je dvojnásobek limitu pro webové domény.
Filtrování podle dat: from_date a to_date
Časové parametry ti umožňují definovat přesné vyhledávací okno ve formátu 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"
}]
)
Tyto filtry jsou obzvláště užitečné pro:
- Analýzu dopadu události: definuj období kolem události
- Porovnání sentimentu před/po: spusť dva dotazy s různými okny
- Vyhnout se starému šumu: zaměř se na nedávné diskuse
Použití s nativním Python SDK
xAI SDK přijímá vedle řetězců ISO také objekty datetime z Pythonu:
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)
)]
)
Konvence camelCase v JavaScriptu
Vercel AI SDK používá pro názvy parametrů konvenci camelCase:
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk"],
fromDate: "2026-03-01",
toDate: "2026-03-31"
})]
Kombinování filtrů
Pro maximální přesnost můžeš v jediném volání kombinovat účty i data:
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"
}]
)
Vytvoření dynamického monitorovacího systému
Programatickým kombinováním těchto filtrů můžeš vytvořit konfigurovatelný nástroj pro monitorování:
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")
}
# Monitoruj lídry v AI za poslední týden
tool = create_x_monitor(
handles=["sama", "demishassabis", "ylecun"],
days_back=7
)
Procvičování
Nakonfiguruj cílené vyhledávání na X pro 3 až 5 vlivných účtů ve tvém oboru. Nastav časové okno na jeden týden a porovnej výsledky s vyhledáváním bez filtrů podle účtů. Změř rozdíl v relevanci.
Klíčové poznatky
allowed_x_handlesaexcluded_x_handlesfiltrují podle účtu (maximálně 10 pro každý)- Oba parametry pro účty jsou vzájemně výlučné
from_dateato_datedefinují časové okno ve formátuYYYY-MM-DD- Data lze kombinovat s filtry podle účtů
- Python SDK přijímá objekty
datetime, JavaScript SDK používá camelCase - Tyto filtry promění vyhledávání na X z obecného nástroje v cílený nástroj pro monitorování