Iffiltra skont l-Handles u d-Dati fuq X
F'din il-paġna
Immira t-tfittxijiet tiegħek fuq X b’mod preċiż
It-Tfittxija fuq X toffri valur reali ladarba tkun irnexxielek tħaddem il-parametri tal-iffiltrar tagħha. Minflok tiġbed feed grezz ta’ posts, tista’ timmira kontijiet speċifiċi, tistabbilixxi twieqi ta’ żmien preċiżi, u teskludi sorsi ta’ storbju. Dawn il-filtri jibdlu għodda ta’ tfittxija għal skopijiet ġenerali f’istrument ta’ monitoraġġ ta’ preċiżjoni.
Iffiltra skont l-handles: allowed_x_handles u excluded_x_handles
Immonitorja kontijiet speċifiċi
Il-parametru allowed_x_handles jirrestrinġi t-tfittxija għal posts ippubblikati mill-kontijiet li inti telenka. Tista’ timmira sa 10 handles fl-istess ħin:
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"
]
}]
)
Eskludi kontijiet storbjużi
Il-parametru excluded_x_handles jaħdem bil-maqlub. Jippermetti lill-kontijiet kollha ħlief dawk li tispeċifika. Utli biex telimina bots jew kontijiet b’kontenut mhux rilevanti:
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"]
}]
)
Regola ta’ esklużività reċiproka
Bħad-dominji tal-web, allowed_x_handles u excluded_x_handles huma esklussivi reċiprokament. Ma tistax tgħaqqadhom f’sejħa waħda. Il-limitu huwa 10 handles għal kull parametru, id-doppju tal-limitu għad-dominji tal-web.
Iffiltra skont id-dati: from_date u to_date
Il-parametri tal-ħin jħalluk tiddefinixxi tieqa ta’ tfittxija preċiża fil-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"
}]
)
Dawn il-filtri huma partikolarment utli għal:
- Analiżi tal-impatt ta’ avveniment: iddefinixxi l-perjodu madwar l-avveniment
- Qabbel is-sentiment qabel/wara: ġeddel żewġ mistoqsijiet b’twieqi differenti
- Evita storbju antik: iffoka fuq diskussjonijiet riċenti
Użu mas-SDK nativ tal-Python
L-SDK ta’ xAI jaċċetta oġġetti datetime tal-Python minbarra l-istringi 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)
)]
)
Konvenzjoni camelCase f’JavaScript
L-SDK ta’ Vercel AI juża l-konvenzjoni camelCase għall-ismijiet tal-parametri:
tools: [xai.tools.xSearch({
allowedXHandles: ["elonmusk"],
fromDate: "2026-03-01",
toDate: "2026-03-31"
})]
Tgħaqqad il-filtri
Tista’ tgħaqqad l-handles u d-dati f’sejħa waħda għall-akbar preċiżjoni:
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"
}]
)
Ibni sistema ta’ monitoraġġ dinamika
Billi tgħaqqad dawn il-filtri b’mod programmatiku, tista’ tibni għodda ta’ monitoraġġ konfigurabbli:
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")
}
# Monitorja l-mexxejja tal-AI għall-ġimgħa
tool = create_x_monitor(
handles=["sama", "demishassabis", "ylecun"],
days_back=7
)
Prattika
Ikkonfigura tfittxija mmirata fuq X għal 3 sa 5 kontijiet influwenti fis-settur tiegħek. Stabbilixxi tieqa ta’ żmen ta’ ġimgħa u qabbel ir-riżultati ma’ tfittxija mingħajr filtri tal-handle. Kejjel id-differenza fir-rilevanza.
Punti Ewlenin
allowed_x_handlesuexcluded_x_handlesjiffiltraw skont il-kont (massimu 10 kull wieħed)- Iż-żewġ parametri tal-handle huma esklużivi reċiprokament
from_dateuto_datejiddefinixxu t-tieqa ta’ żmien fil-formatYYYY-MM-DD- Id-dati jistgħu jiġu kkombinati ma’ filtri tal-handle
- L-SDK tal-Python jaċċetta oġġetti
datetime, l-SDK ta’ JavaScript juża camelCase - Dawn il-filtri jibdlu t-Tfittxija fuq X minn għodda għal skopijiet ġenerali għal strument ta’ monitoraġġ immirat