Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Filtriranje po uporabniških imenih in datumih na X

Lekcija 6 od 14 Posodobljeno 30. julij 2026 Začetnik
Na tej strani
  1. Natančno ciljanje iskanj na X
  2. Filtriranje po uporabniških imenih: allowed_x_handles in excluded_x_handles
  3. Filtriranje po datumih: from_date in to_date
  4. Združevanje filtrov
  5. Izgradnja dinamičnega sistema za spremljanje
  6. Vaja
  7. Ključne ugotovitve

Natančno ciljanje iskanj na X

Iskanje po X prinaša resnično vrednost šele, ko obvladaš njegove parametre za filtriranje. Namesto da bi pridobil surov vir objav, lahko ciljaš na določene račune, nastaviš natančna časovna okna in izključiš vire šuma. Ti filtri spremenijo splošno orodje za iskanje v natančen instrument za spremljanje.

Filtriranje po uporabniških imenih: allowed_x_handles in excluded_x_handles

Spremljanje določenih računov

Parameter allowed_x_handles omeji iskanje na objave, ki so jih objavili računi, ki jih navedeš. Hkrati lahko ciljaš na največ 10 uporabniških imen:

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

Izključevanje hrupnih računov

Parameter excluded_x_handles deluje obratno. Dovoljuje vse račune razen tistih, ki jih določiš. Uporabno je za odpravo botov ali računov z nepomembno vsebino:

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

Pravilo medsebojne izključnosti

Tako kot pri spletnih domenah sta allowed_x_handles in excluded_x_handles medsebojno izključujoča. Ne moreš ju združiti v enem samem klicu. Omejitev je 10 uporabniških imen na parameter, kar je dvakrat več kot omejitev za spletne domene.

Filtriranje po datumih: from_date in to_date

Časovni parametri ti omogočajo definiranje natančnega iskalnega okna v formatu ISO 8601 (LLLL-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"
    }]
)

Ti filtri so še posebej uporabni za:

  • Analizo vpliva dogodka: določi obdobje okoli dogodka
  • Primerjavo sentimenta pred/po: izvedi dva poizvedba z različnimi okni
  • Izogibanje staremu šumu: osredotoči se na nedavne razprave

Uporaba z izvornim Python SDK

xAI SDK poleg nizov ISO sprejema tudi Pythonove objekte datetime:

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

Konvencija camelCase v JavaScriptu

Vercel AI SDK za imena parametrov uporablja konvencijo camelCase:

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

Združevanje filtrov

Za največjo natančnost lahko v enem klicu združiš uporabniška imena in datume:

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

Izgradnja dinamičnega sistema za spremljanje

S programskim združevanjem teh filtrov lahko zgradiš konfigurabilno orodje za spremljanje:

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

# Monitor AI leaders for the week
tool = create_x_monitor(
    handles=["sama", "demishassabis", "ylecun"],
    days_back=7
)

Vaja

Konfiguriraj ciljno iskanje po X za 3 do 5 vplivnih računov v tvojem sektorju. Nastavi tedensko časovno okno in primerjaj rezultate z iskanjem brez filtrov uporabniških imen. Izmeri razliko v ustreznosti.

Ključne ugotovitve

  • allowed_x_handles in excluded_x_handles filtrirata po računu (največ 10 na parameter)
  • Oba parametra za uporabniška imena sta medsebojno izključujoča
  • from_date in to_date določata časovno okno v formatu LLLL-MM-DD
  • Datume je mogoče kombinirati s filtri uporabniških imen
  • Python SDK sprejema objekte datetime, JavaScript SDK pa uporablja camelCase
  • Ti filtri spremenijo iskanje po X iz splošnega orodja v ciljni instrument za spremljanje