Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Iffiltra skont l-Handles u d-Dati fuq X

Lezzjoni 6 / 14 Aġġornat 30 ta’ Lulju 2026 Bidbieni
F'din il-paġna
  1. Immira t-tfittxijiet tiegħek fuq X b’mod preċiż
  2. Iffiltra skont l-handles: allowed_x_handles u excluded_x_handles
  3. Iffiltra skont id-dati: from_date u to_date
  4. Tgħaqqad il-filtri
  5. Ibni sistema ta’ monitoraġġ dinamika
  6. Prattika
  7. Punti Ewlenin

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_handles u excluded_x_handles jiffiltraw skont il-kont (massimu 10 kull wieħed)
  • Iż-żewġ parametri tal-handle huma esklużivi reċiprokament
  • from_date u to_date jiddefinixxu t-tieqa ta’ żmien fil-format YYYY-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