Filtriranje po X korisničkim imenima
Na ovoj stranici
Ciljanje specifičnih računa na X-u
Baš kao što Web Search omogućuje filtriranje po domenama, X Search ti omogućuje filtriranje po računima (korisničkim imenima). Pretragu možeš ograničiti na objave određenog skupa računa ili iz rezultata isključiti određene račune. Ovo je filtriranje ključno za slučajeve uporabe poput praćenja, nadzora brenda ili analize influencera.
Dva parametra za filtriranje
X Search nudi dva parametra za filtriranje korisničkih imena:
allowed_x_handles: ograničava pretragu na objave s navedenih računa (popis dopuštenih)excluded_x_handles: isključuje objave s navedenih računa (popis blokiranih)
Kao i kod Web Searcha, ovi su parametri međusobno isključivi. Ne možeš ih koristiti oba u istom zahtjevu.
Svaki parametar prihvaća polje od najviše 10 korisničkih imena (u usporedbi s 5 domena za Web Search).
Korištenje allowed_x_handles (popis dopuštenih)
Ovaj je parametar idealan za praćenje komunikacije s određenih računa:
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 će pretraživati samo objave koje su objavili ti računi.
Slučajevi uporabe popisa dopuštenih
- Konkurentska obavještajna djelatnost: prati najave svojih konkurenata
- Nadzor brenda: prati svoje službene račune i račune svojih ambasadora
- Analiza influencera: agregiraj mišljenja panela stručnjaka
- Institucionalno praćenje: prati račune regulatornih tijela ili službenih organizacija
Korištenje excluded_x_handles (popis blokiranih)
Ovaj ti parametar omogućuje isključivanje određenih računa, poput botova ili nebitnih računa:
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"]
}]
)
Slučajevi uporabe popisa blokiranih
- Isključivanje botova: ukloni automatizirane račune iz rezultata
- Isključivanje spama: filtriraj račune poznate po sadržaju niske kvalitete
- Isključivanje vlastitih računa: analiziraj vanjske reakcije bez vlastitih objava
Sintaksa SDK-a
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"]
})]
Imaj na umu konvenciju camelCase u JavaScript SDK-u: allowedXHandles umjesto allowed_x_handles.
Najbolje prakse
Odabir između popisa dopuštenih i popisa blokiranih
Koristi popis dopuštenih kada imaš definiran skup računa i želiš samo njihove objave. Ovo je najpreciznija metoda koja najviše štedi tokene.
Koristi popis blokiranih kada želiš široku pretragu, ali je trebaš očistiti uklanjanjem poznatih izvora šuma.
Optimizacija broja korisničkih imena
S ograničenjem od 10 korisničkih imena, budi selektivan. Ako trebaš pratiti više od 10 računa, grupiraj svoje zahtjeve po temama ili izvrši više uzastopnih poziva.
Format korisničkog imena
Korisnička imena ne uključuju simbol @ (na primjer, xaboratory). Provjeri jesu li korisnička imena ispravna – pogrešno napisano korisničko ime jednostavno neće vratiti rezultate za taj račun.
Ključne točke
- Dva parametra:
allowed_x_handles(popis dopuštenih) iexcluded_x_handles(popis blokiranih) - Međusobno isključivi: samo jedan po zahtjevu
- Maksimalno 10 korisničkih imena po parametru
- Korisnička imena pišu se bez simbola
@:"elonmusk", a ne"@elonmusk" - Idealno za praćenje, nadzor brenda i analizu influencera