Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Szűrés X-fiókok alapján

9. lecke 16 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. Konkrét fiókok célzása az X-en
  2. A két szűrőparaméter
  3. Az allowed_x_handles (engedélyezési lista) használata
  4. Az excluded_x_handles (tiltólista) használata
  5. SDK szintaxis
  6. Legjobb gyakorlatok
  7. Főbb megállapítások

Konkrét fiókok célzása az X-en

Ahogy a Webes keresés lehetővé teszi a szűrést domainek alapján, az X-keresés fiókok (felhasználónevek) szerint is szűr. Korlátozhatod a keresést meghatározott fiókok bejegyzéseire, vagy kizárhatsz bizonyos fiókokat az eredményekből. Ez a szűrés elengedhetetlen olyan esetekben, mint a monitorozás, a márkafigyelés vagy az influensz-elemzés.

A két szűrőparaméter

Az X-keresés két felhasználónév-szűrő paramétert kínál:

  • allowed_x_handles: a keresést a felsorolt fiókok bejegyzéseire korlátozza (engedélyezési lista)
  • excluded_x_handles: kizárja a felsorolt fiókok bejegyzéseit (tiltólista)

A Webes kereséshez hasonlóan ezek a paraméterek kölcsönösen kizárják egymást. Nem használhatod mindkettőt ugyanabban a kérésben.

Mindkét paraméter legfeljebb 10 felhasználónevet fogad el tömbként (szemben a Webes keresés 5 domainjével).

Az allowed_x_handles (engedélyezési lista) használata

Ez a paraméter ideális konkrét fiókok kommunikációjának monitorozására:

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"]
    }]
)

A modell csak ezeken a fiókokon keresztül közzétett bejegyzéseket keres.

Az engedélyezési lista alkalmazási esetei

  • Versenytárs-elemzés: figyeld a versenytársaid bejelentéseit
  • Márkafigyelés: kövesd nyomon a hivatalos fiókjaidat és nagyköveteidét
  • Influensz-elemzés: gyűjtsd össze egy szakértői panel véleményeit
  • Intézményi követés: figyeld a szabályozó szervek vagy hivatalos szervezetek fiókjait

Az excluded_x_handles (tiltólista) használata

Ezzel a paraméterrel kizárhatsz bizonyos fiókokat, például botokat vagy irreleváns felhasználókat:

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"]
    }]
)

A tiltólista alkalmazási esetei

  • Botok kizárása: távolítsd el az automatizált fiókokat az eredményekből
  • Spam szűrése: szűrd ki az alacsony minőségű tartalmairól ismert fiókokat
  • Saját fiókok kizárása: elemezd a külső reakciókat a saját bejegyzéseid nélkül

SDK szintaxis

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"]
})]

Figyeld meg a camelCase konvenciót a JavaScript SDK-ban: allowedXHandles az allowed_x_handles helyett.

Legjobb gyakorlatok

Választás az engedélyezési és a tiltólista között

Használd az engedélyezési listát, ha van egy meghatározott fiókkészleted, és csak az ő bejegyzéseiket szeretnéd. Ez a legpontosabb és token-hatékonyabb módszer.

Használd a tiltólistát, ha széles körű keresést szeretnél végezni, de meg kell tisztítanod az eredményeket az ismert zajforrások kiszűrésével.

A felhasználónevek számának optimalizálása

Mivel a limit 10 felhasználónév, légy válogatós. Ha 10-nél több fiókot kell monitoroznod, csoportosítsd a kéréseidet téma szerint, vagy végezz több szekvenciális hívást.

Felhasználónév formátuma

A felhasználónevek nem tartalmazzák a @ jelet (például: xaboratory). Ellenőrizd, hogy a felhasználónevek helyesek-e; egy elgépelés esetén az adott fiókra egyszerűen nem kapnál találatot.

Főbb megállapítások

  • Két paraméter: allowed_x_handles (engedélyezési lista) és excluded_x_handles (tiltólista)
  • Kölcsönösen kizárják egymást: kérésenként csak az egyik használható
  • Paraméterenként maximum 10 felhasználónév
  • A felhasználóneveket a @ jel nélkül kell megadni: "elonmusk", nem pedig "@elonmusk"
  • Ideális monitorozáshoz, márkafigyeléshez és influensz-elemzéshez