Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Filtrēšana pēc X lietotājvārdiem

Nodarbība 9 no 16 Atjaunota 2026. gada 30. jūlijs Programmētājs
Šajā lapā
  1. Konkrētu kontu mērķēšana vietnē X
  2. Divi filtrēšanas parametri
  3. allowed_x_handles (atļauto saraksts) izmantošana
  4. excluded_x_handles (bloķēto saraksts) izmantošana
  5. SDK sintakse
  6. Labākā prakse
  7. Galvenās atziņas

Konkrētu kontu mērķēšana vietnē X

Tāpat kā tīmekļa meklēšana ļauj filtrēt pēc domēniem, X meklēšana ļauj filtrēt pēc kontiem (lietotājvārdiem). Tu vari ierobežot meklēšanu tikai ar konkrētu kontu ierakstiem vai izslēgt noteiktus kontus no rezultātiem. Šī filtrēšana ir būtiska tādiem lietojumiem kā uzraudzība, zīmola izsekošana vai ietekmētāju analīze.

Divi filtrēšanas parametri

X meklēšana piedāvā divus lietotājvārdu filtrēšanas parametrus:

  • allowed_x_handles: ierobežo meklēšanu tikai ar uzskaitīto kontu ierakstiem (atļauto saraksts)
  • excluded_x_handles: izslēdz uzskaitīto kontu ierakstus (bloķēto saraksts)

Tāpat kā tīmekļa meklēšanā, šie parametri ir savstarpēji izslēdzoši. Tu nevari izmantot abus vienā pieprasījumā.

Katrs parametrs pieņem masīvu ar līdz 10 lietotājvārdiem (salīdzinājumā ar 5 domēniem tīmekļa meklēšanā).

allowed_x_handles (atļauto saraksts) izmantošana

Šis parametrs ir ideāli piemērots konkrētu kontu komunikācijas uzraudzībai:

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 meklēs tikai tos ierakstus, ko publicējuši šie konti.

Atļauto sarakstu lietojumi

  • Konkurences izlūkošana: uzraugi savu konkurentu paziņojumus
  • Zīmola uzraudzība: izseko savus oficiālos kontus un savu vēstnešu kontus
  • Ietekmētāju analīze: apkopo ekspertu grupas viedokļus
  • Institucionālā izsekošana: seko regulatoru vai oficiālu organizāciju kontiem

excluded_x_handles (bloķēto saraksts) izmantošana

Šis parametrs ļauj izslēgt noteiktus kontus, piemēram, botus vai neatbilstošus kontus:

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

Bloķēto sarakstu lietojumi

  • Botu izslēgšana: noņem no rezultātiem automatizētos kontus
  • Spama izslēgšana: filtrē kontus, kas zināmi ar zemas kvalitātes saturu
  • Pašu kontu izslēgšana: analizē ārējās reakcijas, neiekļaujot savus ierakstus

SDK sintakse

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

Ņem vērā camelCase konvenciju JavaScript SDK: allowedXHandles vietā allowed_x_handles.

Labākā prakse

Izvēle starp atļauto un bloķēto sarakstu

Izmanto atļauto sarakstu, ja tev ir definēts kontu kopums un vēlies tikai to ierakstus. Šī ir visprecīzākā un tokenus taupošākā metode.

Izmanto bloķēto sarakstu, ja vēlies veikt plašu meklēšanu, bet tev tā ir jāattīra, novēršot zināmus trokšņu avotus.

Lietotājvārdu skaita optimizēšana

Ar 10 lietotājvārdu limitu esi izvēlīgs. Ja tev jāuzrauga vairāk nekā 10 konti, sagrupē savus pieprasījumus pēc tēmām vai veic vairākus secīgus izsaukumus.

Lietotājvārdu formāts

Lietotājvārdos nav iekļauta @ zīme (piemēram, xaboratory). Pārliecinies, ka lietotājvārdi ir pareizi rakstīti – kļūdaini uzrakstīts lietotājvārds vienkārši neatgriezīs rezultātus par šo kontu.

Galvenās atziņas

  • Divi parametri: allowed_x_handles (atļauto saraksts) un excluded_x_handles (bloķēto saraksts)
  • Savstarpēji izslēdzoši: vienā pieprasījumā drīkst izmantot tikai vienu
  • Maksimāli 10 lietotājvārdi uz parametru
  • Lietotājvārdus raksta bez @: "elonmusk", nevis "@elonmusk"
  • Ideāli piemērots uzraudzībai, zīmola izsekošanai un ietekmētāju analīzei