Salt la conținutul principal
Română— Alege o limbă
Meniu

Filtrare după handle-uri și date pe X

Lecția 6 din 14 Actualizată 30 iulie 2026 Începător
Pe această pagină
  1. Țintiți cu precizie căutările dumneavoastră pe X
  2. Filtrare după handle-uri: allowed_x_handles și excluded_x_handles
  3. Filtrare după date: from_date și to_date
  4. Combinarea filtrelor
  5. Construirea unui sistem dinamic de monitorizare
  6. Exercițiu practic
  7. Puncte cheie

Ț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 și excluded_x_handles filtrează după cont (maxim 10 fiecare)
  • Ambii parametri de handle-uri sunt reciproc exclusivi
  • from_date și to_date definesc fereastra de timp în formatul YYYY-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