Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Filtravimas pagal X paskyras

Paskaita 9 iš 16 Atnaujinta 2026 m. liepos 30 d. Kūrėjas
Šiame puslapyje
  1. Tikslinės paskyros X platformoje
  2. Du filtravimo parametrai
  3. allowed_x_handles naudojimas (leidimų sąrašas)
  4. excluded_x_handles naudojimas (blokavimo sąrašas)
  5. SDK sintaksė
  6. Geriausios praktikos
  7. Svarbiausi punktai

Tikslinės paskyros X platformoje

Tiek, kiek „Web Search“ leidžia filtruoti pagal domenų vardus, „X Search“ leidžia filtruoti pagal paskyras (naudotojo vardus). Gali apriboti paiešką tik tam tikrų paskyrų įrašais arba pašalinti konkrečias paskyras iš rezultatų. Šis filtravimas yra būtinas tokiems atvejams kaip stebėsena, prekės ženklo sekimas ar įtakos darytojų analizė.

Du filtravimo parametrai

„X Search“ siūlo du naudotojo vardų filtravimo parametrus:

  • allowed_x_handles: apriboja paiešką tik nurodytų paskyrų įrašais (leidimų sąrašas)
  • excluded_x_handles: pašalina nurodytų paskyrų įrašus (blokavimo sąrašas)

Kaip ir „Web Search“ atveju, šie parametrai yra nesuderinami. Toje pačioje užklausoje negali naudoti abiejų vienu metu.

Kiekvienas parametras priima masyvą iš iki 10 naudotojo vardų (palyginti su 5 domenais „Web Search“ funkcijoje).

allowed_x_handles naudojimas (leidimų sąrašas)

Šis parametras idealiai tinka stebėti konkrečių paskyrų komunikaciją:

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

Modelis ieškos tik tų įrašų, kuriuos paskelbė šios paskyros.

Leidimų sąrašo naudojimo atvejai

  • Konkurentų žvalgyba: stebėk konkurentų pranešimus
  • Prekės ženklo stebėsena: sek savo oficialias paskyras ir ambasadorių paskyras
  • Įtakos darytojų analizė: apibendrink ekspertų grupės nuomones
  • Institucinis stebėjimas: sek reguliavimo institucijų ar oficialių organizacijų paskyras

excluded_x_handles naudojimas (blokavimo sąrašas)

Šis parametras leidžia pašalinti tam tikras paskyras, pavyzdžiui, botus ar nereikšmingas paskyras:

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

Blokavimo sąrašo naudojimo atvejai

  • Botų šalinimas: pašalink automatizuotas paskyras iš rezultatų
  • Šlamšto filtravimas: atmest paskyras, žinomas dėl žemos kokybės turinio
  • Savo paskyrų šalinimas: analizuok išorines reakcijas neįtraukdamas savo įrašų

SDK sintaksė

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

Atkreipk dėmesį į „camelCase“ konvenciją JavaScript SDK: naudojama allowedXHandles, o ne allowed_x_handles.

Geriausios praktikos

Pasirinkimas tarp leidimų ir blokavimo sąrašų

Naudok leidimų sąrašą, kai turi apibrėžtą paskyrų rinkinį ir nori matyti tik jų įrašus. Tai tiksliausias ir žetonų atžvilgiu efektyviausias būdas.

Naudok blokavimo sąrašą, kai nori atlikti plačią paiešką, bet reikia ją išgryninti pašalinant žinomus triukšmo šaltinius.

Naudotojo vardų skaičiaus optimizavimas

Esant 10 vardų limitui, būk atrankus. Jei reikia stebėti daugiau nei 10 paskyrų, sugrupuok užklausas pagal temą arba atlik kelias nuoseklias užklausas.

Naudotojo vardo formatas

Naudotojo varduose nėra simbolio @ (pavyzdžiui, xaboratory). Patikrink, ar naudotojo vardai yra teisingi – neteisingai parašytas vardas tiesiog negrąžins jokių tos paskyros rezultatų.

Svarbiausi punktai

  • Du parametrai: allowed_x_handles (leidimų sąrašas) ir excluded_x_handles (blokavimo sąrašas)
  • Nesuderinami: vienu metu galima naudoti tik vieną parametras užklausai
  • Maksimaliai 10 naudotojo vardų vienam parametrui
  • Naudotojo vardai rašomi be simbolio @: "elonmusk", o ne "@elonmusk"
  • Idealu stebėsenai, prekės ženklo sekimui ir įtakos darytojų analizei