Filtrare după handle-uri și date pe X
Pe această pagină
Țintiți cu precizie căutările dumneavoastră pe X
Căutarea pe X (X Search) oferă o valoare reală odată ce stăpâniți parametrii de filtrare. În loc să extrageți un flux brut de postări, puteți ținti conturi specifice, seta ferestre de timp precise și exclude sursele de zgomot. Aceste filtre transformă un instrument de căutare generalist într-un dispozitiv de monitorizare de precizie.
Filtrare după handle-uri: allowed_x_handles și excluded_x_handles
Monitorizarea conturilor specifice
Parametrul allowed_x_handles restricționează căutarea la postările publicate de conturile pe care le listați. Puteți ținti până la 10 handle-uri simultan:
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"
]
}]
)
Excluderea conturilor zgomotoase
Parametrul excluded_x_handles funcționează invers. Acesta permite toate conturile cu excepția celor pe care le specificați. Este util pentru eliminarea boților sau a conturilor cu conținut irelevant:
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"]
}]
)
Regula de exclusivitate reciprocă
La fel ca în cazul domeniilor web, allowed_x_handles și excluded_x_handles sunt reciproc exclusive. Nu le puteți combina într-un singur apel. Limita este de 10 handle-uri per parametru, dublu față de limita pentru domeniile web.
Filtrare după date: from_date și to_date
Parametrii de timp vă permit să definiți o fereastră de căutare precisă în format 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"
}]
)
Aceste filtre sunt deosebit de utile pentru:
- Analiza impactului unui eveniment: definiți perioada din jurul evenimentului
- Compararea sentimentului înainte/după: rulați două interogări cu ferestre diferite
- Evitarea zgomotului vechi: concentrați-vă pe discuțiile recente
Utilizarea cu SDK-ul nativ Python
SDK-ul xAI acceptă obiecte Python datetime în plus față de șirurile ISO:
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)
)]
)
Convenția camelCase în JavaScript
SDK-ul Vercel AI utilizează convenția camelCase pentru numele parametrilor:
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk"],
fromDate: "2026-03-01",
toDate: "2026-03-31"
})]
Combinarea filtrelor
Puteți combina handle-urile și datele într-un singur apel pentru o precizie maximă:
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"
}]
)
Construirea unui sistem dinamic de monitorizare
Combinând aceste filtre programatic, puteți construi un instrument de monitorizare configurabil:
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")
}
# Monitorizați liderii din AI pentru săptămâna curentă
tool = create_x_monitor(
handles=["sama", "demishassabis", "ylecun"],
days_back=7
)
Exercițiu practic
Configurați o căutare țintită pe X pentru 3 până la 5 conturi influente din sectorul dumneavoastră. Setați o fereastră de timp de o săptămână și comparați rezultatele cu o căutare fără filtre de handle-uri. Măsurați diferența de relevanță.
Puncte cheie
allowed_x_handlesșiexcluded_x_handlesfiltrează după cont (maxim 10 fiecare)- Ambii parametri de handle-uri sunt reciproc exclusivi
from_dateșito_datedefinesc fereastra de timp în formatulYYYY-MM-DD- Datele pot fi combinate cu filtrele de handle-uri
- SDK-ul Python acceptă obiecte
datetime, iar SDK-ul JavaScript folosește camelCase - Aceste filtre transformă X Search dintr-un instrument generalist într-un dispozitiv de monitorizare țintit