Aktivácia vyhľadávania X pre výskum na Twitteri
Na tejto strane
Prístup k feedu X v reálnom čase cez tvoje API
X (predtým Twitter) zostáva hlavnou platformou pre informácie v reálnom čase: oznámenia spoločností, reakcie na správy, vznikajúce trendy a verejné debaty. Nástroj x_search v API Grok ti umožňuje priamo dopytovať tento feed z tvojich aplikácií, bez potreby samostatného predplatného API X alebo správy ďalších služieb.

Zatiaľ čo staršie koncové body Chat Completions ponúkali parameter sources: ["x"] v search_parameters, API Responses poskytuje vyhradený nástroj s oveľa jemnejšími možnosťami filtrovania.
Aktivácia vyhľadávania X
Aktivácia funguje na rovnakom princípe ako web_search. Do poľa tools jednoducho pridáš nástroj x_search:
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)
Model sa automaticky rozhodne, kedy má vyhľadávať na X, na základe povahy tvojej požiadavky. Otázky týkajúce sa aktuálneho diania, verejnej mienky alebo trendov prirodzene spustia vyhľadávanie.
Štyri schopnosti vyhľadávania X
Nástroj x_search presahuje rámec jednoduchého vyhľadávania podľa kľúčových slov. Ponúka štyri režimy dopytov:
- Vyhľadávanie podľa kľúčových slov: nájde príspevky obsahujúce konkrétne výrazy
- Sémantické vyhľadávanie: nájde príspevky súvisiace s konceptom, aj keď neobsahujú presné slová
- Vyhľadávanie používateľov: identifikuje relevantné účty k danej téme
- Získanie vlákien: rekonštruuje kompletné diskusné vlákna
Model automaticky vyberie najvhodnejší režim na základe tvojej požiadavky. Nemusíš explicitne špecifikovať, ktorý režim sa má použiť.
Použitie s rôznymi SDK
xAI SDK (Python)
from xai_sdk.tools import x_search
response = client.chat.create(
model="grok-4.5",
tools=[x_search()]
)
Kompatibilné s OpenAI SDK
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()]
});
Kombinácia web_search a x_search
Oba nástroje môžeš povoliť súčasne, aby si získal kompletný pohľad na danú tému. Model vyberie najrelevantnejší nástroj, alebo v prípade potreby použije oba:
response = client.responses.create(
model="grok-4.5",
input="Complete analysis of the latest Apple keynote",
tools=[
{"type": "web_search"},
{"type": "x_search"}
]
)
V tomto prípade môže model vyhľadať tlačové články prostredníctvom web_search a reakcie v reálnom čase prostredníctvom x_search, následne obe perspektívy syntetizovať vo svojej odpovedi.
Praktické cvičenie
Vytvor skript, ktorý využíva x_search na monitorovanie diskusií okolo odbornej témy, ktorá ťa zaujíma. Otestuj ho dopytmi týkajúcimi sa aktuálneho diania a sleduj, ako model syntetizuje názory a fakty z platformy X.
Kľúčové poznatky
- Nástroj
x_searchsa aktivuje pridaním{"type": "x_search"}do poľatools - Podporuje štyri typy vyhľadávania: kľúčové slová, sémantické, používatelia a vlákna
- Cena je totožná s
web_search: 5 $ za 1 000 volaní - Obidva nástroje je možné povoliť súčasne pre úplné pokrytie
- Rozumienie videu je exkluzivitou
x_search(vweb_searchchýba)