Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Filtreeri X-is kasutajatunnuste ja kuupäevade järgi

Õppetund 6 / 14 Värskendatud 30. juuli 2026 Algajatele
Sellel lehel
  1. Suuna oma X-i otsinguid täpselt
  2. Filtreerimine kasutajatunnuste järgi: allowed_x_handles ja excluded_x_handles
  3. Filtreerimine kuupäevade järgi: from_date ja to_date
  4. Filtrite kombineerimine
  5. Loo dünaamiline seiresüsteem
  6. Harjutus
  7. Peamised punktid

Suuna oma X-i otsinguid täpselt

X-i otsing pakub reaalset väärtust alles siis, kui oled selle filtreerimisparameetrid selgeks õppinud. Toore postituste voogu tõmbamise asemel saad suunata otsingu konkreetsetele kontodele, määrata täpseid ajavahemikke ja välistada müraallikaid. Need filtrid muudavad üldotstarbelise otsingutööriista täpseks seireinstrumendiks.

Filtreerimine kasutajatunnuste järgi: allowed_x_handles ja excluded_x_handles

Jälgi konkreetseid kontosid

Parameeter allowed_x_handles piirab otsingu ainult nende kontode postitustega, mida loetled. Saad sihtida korraga kuni 10 kasutajatunnust:

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

Välista müra tekitavad kontod

Parameeter excluded_x_handles toimib vastupidiselt. See lubab kõik kontod välja arvatud need, mida määrad. Kasulik bottide või ebaolulise sisuga kontode elimineerimiseks:

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

Vastastikuse välistavuse reegel

Nagu veebidomeenide puhul, on ka allowed_x_handles ja excluded_x_handles vastastikku välistavad. Sa ei saa neid ühes päringus kombineerida. Piirang on 10 kasutajatunnust parameetri kohta, mis on kaks korda suurem kui veebidomeenide puhul.

Filtreerimine kuupäevade järgi: from_date ja to_date

Ajaparameetrid võimaldavad määrata täpse otsinguakna ISO 8601 formaadis (AAAA-KK-PP):

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

Need filtrid on eriti kasulikud:

  • Sündmuse mõju analüüsimiseks: määra periood ümber sündmuse
  • Enne/järgse meeleolu võrdlemiseks: käivita kaks päringut erinevate akendega
  • Vana müra vältimiseks: keskendu hiljutistele aruteludele

Kasutamine koos Pythoni SDK-ga

xAI SDK aktsepteerib lisaks ISO-stringidele ka Pythoni datetime objekte:

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

camelCase konventsioon JavaScriptis

Vercel AI SDK kasutab parameetrite nimede jaoks camelCase konventsiooni:

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

Filtrite kombineerimine

Saad kombineerida kasutajatunnuseid ja kuupäevi ühes päringus maksimaalse täpsuse saavutamiseks:

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

Loo dünaamiline seiresüsteem

Kombineerides neid filtreid programmeeritavalt, saad luua konfigureeritava seiretööriista:

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

# Jälgi AI liidreid nädala jooksul
tool = create_x_monitor(
    handles=["sama", "demishassabis", "ylecun"],
    days_back=7
)

Harjutus

Seadista sihitatud X-i otsing 3–5 mõjukale kontole oma valdkonnas. Määra ühenädalane ajavahemik ja võrdle tulemusi otsinguga, kus kasutajatunnuste filtreid ei kasutata. Mõõda asjakohasuse erinevust.

Peamised punktid

  • allowed_x_handles ja excluded_x_handles filtreerivad konto järgi (maksimaalselt 10 mõlemat)
  • Mõlemad kasutajatunnuste parameetrid on vastastikku välistavad
  • from_date ja to_date määratlevad ajavahemiku formaadis AAAA-KK-PP
  • Kuupäevi saab kombineerida kasutajatunnuste filtritega
  • Pythoni SDK aktsepteerib datetime objekte, JavaScripti SDK kasutab camelCase’i
  • Need filtrid muudavad X-i otsingu üldotstarbelisest tööriistast sihitatud seireinstrumendiks