Przejdź do głównej treści
Polski— Wybierz język
Menu

Włącz wyszukiwanie X do badań na Twitterze

Lekcja 5 z 14 Zaktualizowano 30 lipca 2026 Początkujący
Na tej stronie
  1. Dostęp do strumienia czasu rzeczywistego X przez Twoje API
  2. Włączanie wyszukiwania X
  3. Cztery możliwości wyszukiwania X
  4. Użycie z różnymi SDK
  5. Łączenie web_search i x_search
  6. Ćwiczenia praktyczne
  7. Kluczowe wnioski

Dostęp do strumienia czasu rzeczywistego X przez Twoje API

X (dawniej Twitter) pozostaje główną platformą dla informacji w czasie rzeczywistym: ogłoszeń firmowych, reakcji na wiadomości, rodzących się trendów i debat publicznych. Narzędzie x_search w API Grok pozwala odpytywać ten strumień bezpośrednio z Twoich aplikacji, bez konieczności posiadania osobnej subskrypcji API X czy zarządzania dodatkowymi usługami.

Wyszukiwanie X z Grok

Podczas gdy przestarzały punkt końcowy Chat Completions oferował parametr sources: ["x"] w search_parameters, API Responses udostępnia dedykowane narzędzie o znacznie precyzyjniejszych możliwościach filtrowania.

10
filterable handles
4
search types
$5
per 1,000 calls
Video
exclusive analysis

Włączanie wyszukiwania X

Włączanie działa na tej samej zasadzie co web_search. Dodajesz narzędzie x_search do tablicy 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)

Model automatycznie decyduje, kiedy odpytać X, w zależności od charakteru Twojego promptu. Pytania dotyczące bieżących wydarzeń, opinii publicznej lub trendów naturalnie uruchomią wyszukiwanie.

Cztery możliwości wyszukiwania X

Narzędzie x_search wykracza poza proste wyszukiwanie słów kluczowych. Oferuje cztery tryby zapytań:

  • Wyszukiwanie słów kluczowych: znajdź wpisy zawierające konkretne terminy
  • Wyszukiwanie semantyczne: znajdź wpisy związane z koncepcją, nawet bez dokładnych słów
  • Wyszukiwanie użytkowników: zidentyfikuj odpowiednie konta dotyczące danego tematu
  • Pobieranie wątków: odtwórz kompletne wątki dyskusyjne

Model automatycznie wybiera najbardziej odpowiedni tryb na podstawie Twojego żądania. Nie musisz jawnie określać, którego trybu użyć.

Użycie z różnymi SDK

xAI SDK (Python)

from xai_sdk.tools import x_search

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

Kompatybilne z 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()]
});

Możesz włączyć oba narzędzia jednocześnie, aby uzyskać pełny obraz tematu. Model wybierze najbardziej odpowiednie narzędzie lub użyje obu, jeśli będzie to konieczne:

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

W takim przypadku model może wyszukać artykuły prasowe przez web_search, a reakcje w czasie rzeczywistym przez x_search, a następnie syntezować obie perspektywy w swojej odpowiedzi.

Ćwiczenia praktyczne

Stwórz skrypt wykorzystujący x_search do monitorowania dyskusji wokół interesującego Cię tematu zawodowego. Przetestuj zapytania dotyczące bieżących wydarzeń i obserwuj, jak model syntezuje opinie i fakty z X.

Kluczowe wnioski

  • Narzędzie x_search aktywuje się poprzez {"type": "x_search"} w tablicy tools
  • Obsługuje cztery typy wyszukiwania: słowa kluczowe, semantyczne, użytkowników i wątki
  • Koszt jest identyczny jak w przypadku web_search: 5 USD za 1000 wywołań
  • Oba narzędzia można włączyć jednocześnie, aby uzyskać pełne pokrycie
  • Rozumienie wideo jest wyłącznością x_search (nie występuje w web_search)