Salt la conținutul principal
Română— Alege o limbă
Meniu

Activarea căutării X pentru cercetare pe Twitter

Lecția 5 din 14 Actualizată 30 iulie 2026 Începător
Pe această pagină
  1. Accesarea fluxului în timp real X prin API-ul dumneavoastră
  2. Activarea căutării X
  3. Cele patru capacități ale căutării X
  4. Utilizarea cu diferite SDK-uri
  5. Combinarea lui web_search și x_search
  6. Exercițiu practic
  7. Puncte cheie

Accesarea fluxului în timp real X prin API-ul dumneavoastră

X (fostul Twitter) rămâne platforma de referință pentru informațiile în timp real: anunțuri ale companiilor, reacții la știri, tendințe emergente și dezbateri publice. Instrumentul x_search din API-ul Grok vă permite să interogați acest flux direct din aplicațiile dumneavoastră, fără a fi nevoie de un abonament separat la API-ul X sau de gestionarea unor abonamente suplimentare.

Căutare X cu Grok

În timp ce vechiul endpoint Chat Completions oferea un parametru sources: ["x"] în search_parameters, API-ul Responses pune la dispoziție un instrument dedicat, cu capacități de filtrare mult mai fine.

10
handle-uri filtrabile
4
tipuri de căutare
$5
la 1.000 de apeluri
Video
analiză exclusivă

Activarea căutării X

Activarea funcționalității urmează același principiu ca și web_search. Adăugați instrumentul x_search în tabloul tools:

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)

Modelul decide automat când să interogheze X, în funcție de natura solicitării dumneavoastră. Întrebările despre evenimente curente, opinia publică sau tendințe vor declanșa natural o căutare.

Cele patru capacități ale căutării X

Instrumentul x_search merge dincolo de simpla căutare după cuvinte-cheie. Oferă patru moduri de interogare:

  • Căutare după cuvinte-cheie: găsirea postărilor care conțin termeni specifici
  • Căutare semantică: găsirea postărilor legate de un concept, chiar și fără cuvintele exacte
  • Căutare de utilizatori: identificarea conturilor relevante pe o temă dată
  • Recuperarea firului de discuție: reconstrucția firelor de discuție complete

Modelul alege automat modul cel mai adecvat în funcție de cererea dumneavoastră. Nu este necesar să specificați explicit modul de utilizat.

Utilizarea cu diferite SDK-uri

xAI SDK (Python)

from xai_sdk.tools import x_search

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

Compatibil cu 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()]
});

Puteți activa ambele instrumente simultan pentru a obține o imagine completă asupra unui subiect. Modelul va alege instrumentul cel mai relevant sau le va utiliza pe ambele, dacă este necesar:

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

În acest caz, modelul poate căuta articole de presă prin web_search și reacții în timp real prin x_search, sintetizând apoi ambele perspective în răspunsul său.

Exercițiu practic

Creați un script care utilizează x_search pentru a monitoriza discuțiile din jurul unui subiect profesional care vă interesează. Testați cu interogări legate de evenimente curente și observați modul în care modelul sintetizează opiniile și faptele de pe X.

Puncte cheie

  • Instrumentul x_search se activează cu {"type": "x_search"} în tabloul tools
  • Suportă patru tipuri de căutare: cuvinte-cheie, semantică, utilizatori și fire de discuție
  • Costul este identic cu cel al web_search: 5 USD la 1.000 de apeluri
  • Ambele instrumente pot fi activate simultan pentru o acoperire completă
  • Înțelegerea video este o exclusivitate x_search (absentă din web_search)