Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Suodata käyttäjätunnuksilla ja päivämäärillä X:ssä

Oppitunti 6 / 14 Päivitetty 30. heinäkuuta 2026 Aloittelija
Tällä sivulla
  1. Kohdenna X-hakusi tarkasti
  2. Suodatus käyttäjätunnuksilla: allowed_x_handles ja excluded_x_handles
  3. Suodatus päivämäärillä: from_date ja to_date
  4. Suodattimien yhdistäminen
  5. Rakenna dynaaminen seurantajärjestelmä
  6. Harjoitus
  7. Keskeiset asiat

Kohdenna X-hakusi tarkasti

X Search tuottaa todellista arvoa, kun hallitset sen suodatusparametrit. Raakasyötteen sijaan voit kohdistaa hakusi tietyille tileille, asettaa tarkkoja aikavälejä ja sulkea pois häiriötekijöitä. Nämä suodattimet muuttavat yleiskäyttöisen hakutyökalun tarkaksi seurantajärjestelmäksi.

Suodatus käyttäjätunnuksilla: allowed_x_handles ja excluded_x_handles

Tarkkaile tiettyjä tilejä

Parametri allowed_x_handles rajoittaa haun vain niiden tilien julkaisemiin viesteihin, jotka luetlet. Voit kohdistaa hakuun enintään 10 käyttäjätunnusta samanaikaisesti:

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

Sulje pois häiritsevät tilit

Parametri excluded_x_handles toimii päinvastoin. Se sallii kaikki tilit paitsi ne, jotka määrität. Tämä on hyödyllistä bottien tai epäolennaisen sisällön tuottajien karsimiseen:

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

Keskinäisen poissulkevuuden sääntö

Kuten verkkotunnusten kohdalla, myös allowed_x_handles ja excluded_x_handles ovat keskinäisesti poissulkevia. Et voi yhdistää niitä samaan pyyntöön. Raja on 10 käyttäjätunnusta parametria kohden, mikä on kaksinkertainen määrä verkkotunnuksiin verrattuna.

Suodatus päivämäärillä: from_date ja to_date

Aikaparametrien avulla voit määrittää tarkan hakuvälin ISO 8601 -muodossa (VVVV-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"
    }]
)

Nämä suodattimet ovat erityisen hyödyllisiä seuraaviin tarkoituksiin:

  • Tapahtuman vaikutusten analysointi: määritä jakso tapahtuman ympärille
  • Tunneanalyysin vertailu ennen/jälkeen: suorita kaksi kyselyä eri aikaväleillä
  • Vanhan hälyn välttäminen: keskity viimeaikaisiin keskusteluihin

Käyttö natiivin Python SDK:n kanssa

xAI SDK hyväksyy Pythonin datetime-olioita ISO-merkkijonojen lisäksi:

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-käytäntö JavaScriptissä

Vercel AI SDK käyttää parametrien nimissä camelCase-käytäntöä:

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

Suodattimien yhdistäminen

Voit yhdistää käyttäjätunnukset ja päivämäärät samaan pyyntöön saavuttaaksesi maksimaalisen tarkkuuden:

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

Rakenna dynaaminen seurantajärjestelmä

Yhdistämällä nämä suodattimet ohjelmallisesti voit rakentaa muokattavan seurantasyökalun:

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

# Seuraa tekoälyjohtajia viikon ajan
tool = create_x_monitor(
    handles=["sama", "demishassabis", "ylecun"],
    days_back=7
)

Harjoitus

Määritä kohdennettu X-haku 3–5 alasi vaikuttajatilille. Aseta yhden viikon aikaväli ja vertaa tuloksia hakuun, jossa ei ole käyttäjätunnussuodattimia. Mittaa osuvuudessa tapahtunutta muutosta.

Keskeiset asiat

  • allowed_x_handles ja excluded_x_handles suodattavat tileittäin (maksimi 10 kumpaakin)
  • Molemmat käyttäjätunnusparametrit ovat keskinäisesti poissulkevia
  • from_date ja to_date määrittävät aikavälin muodossa VVVV-KK-PP
  • Päivämäärät voidaan yhdistää käyttäjätunnussuodattimiin
  • Python SDK hyväksyy datetime-olioita, kun taas JavaScript SDK käyttää camelCase-muotoa
  • Nämä suodattimet muuttavat X Searchin yleiskäyttöisestä työkalusta kohdennetuksi seurantajärjestelmäksi