Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Filtrovanie podľa účtov na X

Lekcia 9 z 16 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Cielenie na konkrétne účty na X
  2. Dva parametre filtrovania
  3. Používanie allowed_x_handles (povolený zoznam)
  4. Používanie excluded_x_handles (blokovaný zoznam)
  5. Syntax SDK
  6. Osvedčené postupy
  7. Kľúčové poznatky

Cielenie na konkrétne účty na X

Rovnako ako webové vyhľadávanie umožňuje filtrovať podľa domén, vyhľadávanie na X ti umožňuje filtrovať podľa účtov (handle). Môžeš obmedziť vyhľadávania na príspevky od konkrétnej množiny účtov alebo určité účty z výsledkov vylúčiť. Toto filtrovanie je nevyhnutné pre prípady použitia, ako je monitorovanie, sledovanie značky alebo analýza influencerov.

Dva parametre filtrovania

Vyhľadávanie na X ponúka dva parametre na filtrovanie podľa účtov:

  • allowed_x_handles: obmedzuje vyhľadávanie na príspevky od uvedených účtov (povolený zoznam)
  • excluded_x_handles: vylučuje príspevky od uvedených účtov (blokovaný zoznam)

Rovnako ako pri webovom vyhľadávaní sú tieto parametre vzájomne sa vylučujúce. Nemôžeš použiť obe v tej istej požiadavke.

Každý parameter prijíma pole maximálne 10 účtov (v porovnaní s 5 doménami pri webovom vyhľadávaní).

Používanie allowed_x_handles (povolený zoznam)

Tento parameter je ideálny na monitorovanie komunikácie od konkrétnych účtov:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest announcements from xAI?",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["xaboratory", "xaboratorydev"]
    }]
)

Model bude vyhľadávať iba príspevky zverejnené týmito účtami.

Prípady použitia povoleného zoznamu

  • Konkurenčná inteligencia: monitoruj oznámenia svojich konkurentov
  • Monitorovanie značky: sleduj svoje oficiálne účty a účty svojich ambasádorov
  • Analýza influencerov: agreguj názory od panelu expertov
  • Inštitucionálne sledovanie: sleduj účty regulátorov alebo oficiálnych organizácií

Používanie excluded_x_handles (blokovaný zoznam)

Tento parameter ti umožňuje vylúčiť určité účty, ako sú boty alebo irelevantné účty:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What do developers think about the latest version of Python?",
    tools=[{
        "type": "x_search",
        "excluded_x_handles": ["bot_python_news", "spam_account"]
    }]
)

Prípady použitia blokovaného zoznamu

  • Vylúčenie botov: odstráň automatizované účty z výsledkov
  • Vylúčenie spamu: odfiltruj účty známe nízkokvalitným obsahom
  • Vylúčenie vlastných účtov: analyzuj externé reakcie bez vlastných príspevkov

Syntax SDK

xAI SDK (Python)

from xai_sdk.tools import x_search

tools=[x_search(
    allowed_x_handles=["elonmusk", "xaboratory"]
)]

OpenAI SDK (Python)

tools=[{
    "type": "x_search",
    "allowed_x_handles": ["elonmusk", "xaboratory"]
}]

Vercel AI SDK (JavaScript)

tools: [xai.tools.xSearch({
  allowedXHandles: ["elonmusk", "xaboratory"]
})]

Všimni si konvenciu camelCase v JavaScript SDK: allowedXHandles namiesto allowed_x_handles.

Osvedčené postupy

Výber medzi povoleným a blokovaným zoznamom

Použi povolený zoznam, keď máš definovanú množinu účtov a chceš iba ich príspevky. Toto je najpresnejšia a z hľadiska tokenov najefektívnejšia metóda.

Použi blokovaný zoznam, keď chceš široké vyhľadávanie, ale potrebuješ ho vyčistiť odstránením známych zdrojov šumu.

Optimalizácia počtu účtov

Pri limite 10 účtov buď selektívny. Ak potrebuješ monitorovať viac ako 10 účtov, zgrupuj svoje požiadavky podľa témy alebo vykonaj viacero sekvenčných volaní.

Formát účtu

Účty neobsahujú symbol @ (napríklad xaboratory). Over si, či sú účty správne – preklep v účte jednoducho vráti žiadne výsledky pre daný účet.

Kľúčové poznatky

  • Dva parametre: allowed_x_handles (povolený zoznam) a excluded_x_handles (blokovaný zoznam)
  • Vzájomne sa vylučujúce: naraz len jeden na požiadavku
  • Maximálne 10 účtov na parameter
  • Účty sa píšu bez symbolu @: "elonmusk", nie "@elonmusk"
  • Ideálne na monitorovanie, sledovanie značky a analýzu influencerov