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

Ota X-haku käyttöön Twitter-tutkimusta varten

Oppitunti 5 / 14 Päivitetty 30. heinäkuuta 2026 Aloittelija
Tällä sivulla
  1. Käytä X:n reaaliaikaista syötettä API:n kautta
  2. Ota X-haku käyttöön
  3. X-haun neljä ominaisuutta
  4. Käyttö eri SDK:iden kanssa
  5. Yhdistä web_search ja x_search
  6. Käytännön harjoitus
  7. Keskeiset asiat

Käytä X:n reaaliaikaista syötettä API:n kautta

X (entinen Twitter) on edelleen ensisijainen alusta reaaliaikaiselle tiedolle: yritystiedotteet, reaktiot uutisiin, nousevat trendit ja julkinen keskustelu. Grok API:n x_search-työkalun avulla voit hakea tästä syötteestä suoraan omista sovelluksistasi ilman erillistä X API -tilausta tai lisätilausten hallintaa.

X-haku Grokilla

Missä vanha Chat Completions -päätepiste tarjosi parametrin sources: ["x"] kohdassa search_parameters, Responses API tarjoaa erillisen työkalun, jossa on huomattavasti tarkemmat suodatusmahdollisuudet.

10
suodatettavaa käyttäjätunnusta
4
hakutyyppiä
$5
per 1 000 pyyntöä
Video
yksinoikeusanalyysi

Ota X-haku käyttöön

Käyttöönotto noudattaa samaa periaatetta kuin web_search. Lisäät x_search-työkalun tools-taulukkoon:

response = client.responses.create(
    model="grok-4.5",
    input="What are people saying about the AI Act on X today?",
    tools=[{"type": "x_search"}]
)

print(response.output_text)

Malli päättää automaattisesti, milloin X:ää kysytään kehotteesi luonteen perusteella. Kysymykset ajankohtaisista tapahtumista, yleisestä mielipiteestä tai trendeistä laukaisevat haun luonnostaan.

X-haun neljä ominaisuutta

x_search-työkalu menee pelkkää avainsanahakua pidemmälle. Se tarjoaa neljä kyselytilaa:

  • Avainsanahaku: löytää viestejä, jotka sisältävät tiettyjä termejä
  • Semanttinen haku: löytää viestejä, jotka liittyvät käsitteeseen, vaikka tarkkoja sanoja ei käytettäisi
  • Käyttäjähaku: tunnistaa aiheeseen liittyviä tilejä
  • Keskusteluketjun nouto: rakentaa uudelleen完整的 keskusteluketjut

Malli valitsee automaattisesti sopivimman tilan pyyntösi perusteella. Sinun ei tarvitse määrittää käytettävää tilaa erikseen.

Käyttö eri SDK:iden kanssa

xAI SDK (Python)

from xai_sdk.tools import x_search

response = client.chat.create(
    model="grok-4.5",
    tools=[x_search()]
)

OpenAI SDK -yhteensopiva

response = client.responses.create(
    model="grok-4.5",
    input="Tech trends on X this week",
    tools=[{"type": "x_search"}]
)

Vercel AI SDK (JavaScript)

import { xai } from '@ai-sdk/xai';

const response = await generateText({
  model: xai.responses('grok-4.5'),
  prompt: 'Tech trends on X this week',
  tools: [xai.tools.xSearch()]
});

Voit ottaa molemmat työkalut käyttöön samanaikaisesti saadaksesi kokonaiskuvan aiheesta. Malli valitsee merkityksellisimmän työkalun tai käyttää molempia tarvittaessa:

response = client.responses.create(
    model="grok-4.5",
    input="Complete analysis of the latest Apple keynote",
    tools=[
        {"type": "web_search"},
        {"type": "x_search"}
    ]
)

Tällöin malli voi hakea lehdistöartikkeleita web_search-työkalulla ja reaaliaikaisia reaktioita x_search-työkalulla sekä syntetisoida molemmat näkökulmat vastaukseensa.

Käytännön harjoitus

Luo skripti, joka käyttää x_search-työkalua seuraamaan sinua kiinnostavan ammatillisen aiheen ympärillä käytävää keskustelua. Testaa ajankohtaisilla kyselyillä ja tarkkaile, miten malli syntetisoi X:n mielipiteitä ja faktoja.

Keskeiset asiat

  • x_search-työkalu aktivoituu lisäämällä {"type": "x_search"} tools-taulukkoon
  • Se tukee neljää hakutyyppiä: avainsanat, semanttinen haku, käyttäjät ja keskusteluketjut
  • Hinta on sama kuin web_search: 5 dollaria per 1 000 pyyntöä
  • Molemmat työkalut voidaan ottaa käyttöön samanaikaisesti kattavan kuvan saamiseksi
  • Videoiden ymmärtäminen on x_search-työkalun yksinoikeus (ei saatavilla web_search-työkalussa)