Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Filtrare per handle e date su X

Lezione 6 di 14 Aggiornata il 30 luglio 2026 Principiante
In questa pagina
  1. Mira con precisione le tue ricerche su X
  2. Filtrare per handle: allowed_x_handles e excluded_x_handles
  3. Filtrare per date: from_date e to_date
  4. Combinare i filtri
  5. Costruire un sistema di monitoraggio dinamico
  6. Esercitazione
  7. Punti chiave

Mira con precisione le tue ricerche su X

La Ricerca X offre un vero valore una volta che padroneggi i suoi parametri di filtraggio. Invece di estrarre un feed grezzo di post, puoi mirare a account specifici, impostare finestre temporali precise ed escludere fonti di rumore. Questi filtri trasformano uno strumento di ricerca generico in uno strumento di monitoraggio di precisione.

Filtrare per handle: allowed_x_handles e excluded_x_handles

Monitorare account specifici

Il parametro allowed_x_handles limita la ricerca ai post pubblicati dagli account che elenchi. Puoi mirare fino a 10 handle contemporaneamente:

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"
        ]
    }]
)

Escludere account rumorosi

Il parametro excluded_x_handles funziona al contrario. Consente tutti gli account tranne quelli che specifichi. Utile per eliminare bot o account con contenuti irrilevanti:

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 di esclusività reciproca

Come per i domini web, allowed_x_handles e excluded_x_handles sono mutuamente esclusivi. Non puoi combinarli in una singola chiamata. Il limite è di 10 handle per parametro, il doppio del limite per i domini web.

Filtrare per date: from_date e to_date

I parametri temporali ti permettono di definire una finestra di ricerca precisa nel formato 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"
    }]
)

Questi filtri sono particolarmente utili per:

  • Analizzare l’impatto di un evento: definire il periodo intorno all’evento
  • Confrontare il sentiment prima/dopo: eseguire due query con finestre diverse
  • Evitare il rumore datato: concentrarsi sulle discussioni recenti

Utilizzo con l’SDK Python nativo

L’SDK xAI accetta oggetti Python datetime oltre alle stringhe 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)
    )]
)

Convenzione camelCase in JavaScript

L’SDK Vercel AI utilizza la convenzione camelCase per i nomi dei parametri:

tools: [xai.tools.xSearch({
  allowedXHandles: ["elonmusk"],
  fromDate: "2026-03-01",
  toDate: "2026-03-31"
})]

Combinare i filtri

Puoi combinare handle e date in una singola chiamata per la massima precisione:

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"
    }]
)

Costruire un sistema di monitoraggio dinamico

Combinando questi filtri a livello di codice, puoi costruire uno strumento di monitoraggio configurabile:

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")
    }

# Monitora i leader dell'IA per la settimana
tool = create_x_monitor(
    handles=["sama", "demishassabis", "ylecun"],
    days_back=7
)

Esercitazione

Configura una ricerca X mirata per 3-5 account influenti nel tuo settore. Imposta una finestra temporale di una settimana e confronta i risultati con una ricerca senza filtri per handle. Misura la differenza in termini di rilevanza.

Punti chiave

  • allowed_x_handles e excluded_x_handles filtrano per account (max 10 ciascuno)
  • Entrambi i parametri handle sono mutuamente esclusivi
  • from_date e to_date definiscono la finestra temporale nel formato YYYY-MM-DD
  • Le date sono combinabili con i filtri per handle
  • L’SDK Python accetta oggetti datetime, l’SDK JavaScript usa il camelCase
  • Questi filtri trasformano la Ricerca X da uno strumento generico in uno strumento di monitoraggio mirato