Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Filtriranje po uporabniških imenih na X

Lekcija 9 od 16 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Ciljanje na določene račune na X
  2. Dva parametra za filtriranje
  3. Uporaba allowed_x_handles (dovoljeni seznam)
  4. Uporaba excluded_x_handles (seznam blokiranih)
  5. Sintaksa SDK
  6. Najboljše prakse
  7. Ključne ugotovitve

Ciljanje na določene račune na X

Prav tako kot Iskanje po spletu omogoča filtriranje po domenah, Iskanje po X omogoča filtriranje po računih (uporabniških imenih). Iskanje lahko omejiš na objave določenega niza računov ali pa določene račune iz rezultatov izključiš. To filtriranje je ključno za primere uporabe, kot so spremljanje dogodkov, sledenje blagovni znamki ali analiza vplivnežev.

Dva parametra za filtriranje

Iskanje po X ponuja dva parametra za filtriranje uporabniških imen:

  • allowed_x_handles: omeji iskanje na objave naštetih računov (dovoljeni seznam)
  • excluded_x_handles: izključi objave naštetih računov (seznam blokiranih)

Tako kot pri Iskanju po spletu sta ta parametra medsebojno izključujoča. V istem zahtevku ne moreš uporabiti obeh hkrati.

Vsak parameter sprejme polje največ 10 uporabniških imen (v primerjavi s 5 domenami pri Iskanju po spletu).

Uporaba allowed_x_handles (dovoljeni seznam)

Ta parameter je idealen za spremljanje komunikacije določenih računov:

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 bo iskal le objave, ki so jih objavili ti računi.

Primeri uporabe dovoljenega seznama

  • Konkurenčna obveščenost: spremljaj napovedi svojih konkurentov
  • Spremljanje blagovne znamke: sledi svojim uradnim računom in računom svojih ambasadorjev
  • Analiza vplivnežev: združi mnenja panela strokovnjakov
  • Institucionalno sledenje: spremljaj račune regulatorjev ali uradnih organizacij

Uporaba excluded_x_handles (seznam blokiranih)

Ta parameter ti omogoča izključitev določenih računov, kot so boti ali nepomembni računi:

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

Primeri uporabe seznama blokiranih

  • Izključitev botov: odstrani avtomatizirane račune iz rezultatov
  • Izključitev spama: filtriraj račune, znane po vsebinah nizke kakovosti
  • Izključitev lastnih računov: analiziraj zunanje odzive brez svojih objav

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

Upoštevaj konvencijo camelCase v JavaScript SDK: allowedXHandles namesto allowed_x_handles.

Najboljše prakse

Izbira med dovoljenim seznamom in seznamom blokiranih

Uporabi dovoljeni seznam, ko imaš določen niz računov in želiš le njihove objave. To je najbolj natančna metoda, ki varčuje z žetoni.

Uporabi seznam blokiranih, ko želiš široko iskanje, vendar ga moraš očistiti z odstranitvijo znanih virov šuma.

Optimizacija števila uporabniških imen

Z omejitvijo 10 uporabniških imen bodi selektiven. Če moraš spremljati več kot 10 računov, svoje zahtevke združi po temah ali izvedi več zaporednih klicev.

Oblika uporabniškega imena

Uporabniška imena ne vključujejo simbola @ (na primer xaboratory). Preveri, ali so uporabniška imena pravilna – napačno črkovano ime bo preprosto vrnilo brez rezultatov za ta račun.

Ključne ugotovitve

  • Dva parametra: allowed_x_handles (dovoljeni seznam) in excluded_x_handles (seznam blokiranih)
  • Medsebojno izključujoča: na zahtevek lahko uporabiš le enega
  • Največ 10 uporabniških imen na parameter
  • Uporabniška imena se pišejo brez simbola @: "elonmusk", ne "@elonmusk"
  • Idealno za spremljanje, sledenje blagovni znamki in analizo vplivnežev