Filtrēšana pēc lietotājvārdiem un datumiem platformā X
Šajā lapā
Precīzi mērķē savas meklēšanas platformā X
Meklēšana platformā X sniedz reālu vērtību tikai tad, kad esi apguvis tās filtrēšanas parametrus. Tā vietā, lai iegūtu neapstrādātu ierakstu plūsmu, tu vari mērķēt uz konkrētiem kontiem, iestatīt precīzus laika logus un izslēgt trokšņa avotus. Šie filtri pārvērš vispārēja pielietojuma meklēšanas rīku precīzā uzraudzības instrumentā.
Filtrēšana pēc lietotājvārdiem: allowed_x_handles un excluded_x_handles
Konkrētu kontu uzraudzība
Parametrs allowed_x_handles ierobežo meklēšanu tikai ar tiem ierakstiem, ko publicējuši tavā sarakstā norādītie konti. Tu vari vienlaikus mērķēt uz līdz 10 lietotājvārdiem:
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"
]
}]
)
Trokšņainu kontu izslēgšana
Parametrs excluded_x_handles darbojas pretēji. Tas ļauj iekļaut visus kontus izņemot tos, kurus tu norādi. Tas ir noderīgi, lai novērstu botus vai kontus ar neatbilstošu saturu:
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"]
}]
)
Savstarpējās izslēgšanas noteikums
Tāpat kā tīmekļa domēnu gadījumā, allowed_x_handles un excluded_x_handles ir savstarpēji izslēdzoši. Tu nevari tos kombinēt vienā izsaukumā. Limits ir 10 lietotājvārdi uz vienu parametru, kas ir divreiz vairāk nekā tīmekļa domēniem.
Filtrēšana pēc datumiem: from_date un to_date
Laika parametri ļauj definēt precīzu meklēšanas logu ISO 8601 formātā (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"
}]
)
Šie filtri ir īpaši noderīgi, lai:
- Analizētu notikuma ietekmi: definē periodu ap notikumu
- Salīdzinātu noskaņojumu pirms/pēc: veic divus vaicājumus ar dažādiem laika logiem
- Izvairītos no veca trokšņa: fokusējies uz jaunākajām diskusijām
Izmantošana ar natīvo Python SDK
xAI SDK pieņem Python datetime objektus papildus ISO virknēm:
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 konvencija JavaScript valodā
Vercel AI SDK parametru nosaukumiem izmanto camelCase konvenciju:
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk"],
fromDate: "2026-03-01",
toDate: "2026-03-31"
})]
Filtru kombinēšana
Tu vari kombinēt lietotājvārdus un datumus vienā izsaukumā, lai panāktu maksimālu precizitāti:
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"
}]
)
Dinamiskas uzraudzības sistēmas izveide
Programmiski kombinējot šos filtrus, tu vari izveidot konfigurējamu uzraudzības rīku:
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")
}
# Uzraugi AI līderus nedēļas garumā
tool = create_x_monitor(
handles=["sama", "demishassabis", "ylecun"],
days_back=7
)
Praktiskais uzdevums
Konfigurē mērķtiecīgu meklēšanu platformā X, atlasot 3 līdz 5 ietekmīgus kontus savā nozarē. Iestati vienas nedēļas laika logu un salīdzini rezultātus ar meklēšanu bez lietotājvārdu filtriem. Novērtē atbilstības atšķirību.
Galvenās atziņas
allowed_x_handlesunexcluded_x_handlesfiltrē pēc konta (maksimāli 10 katram)- Abi lietotājvārdu parametri ir savstarpēji izslēdzoši
from_dateunto_datedefinē laika logu formātāYYYY-MM-DD- Datumus var kombinēt ar lietotājvārdu filtriem
- Python SDK pieņem
datetimeobjektus, bet JavaScript SDK izmanto camelCase - Šie filtri pārvērš X Search no vispārēja pielietojuma rīka par mērķtiecīgu uzraudzības instrumentu