Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Filtrering efter X-brugernavne

Lektion 9 af 16 Opdateret 30. juli 2026 Udvikler
På denne side
  1. Målret specifikke konti på X
  2. De to filtreringsparametre
  3. Brug af allowed_x_handles (allowlist)
  4. Brug af excluded_x_handles (blocklist)
  5. SDK-syntaks
  6. Bedste praksis
  7. Vigtige pointer

Målret specifikke konti på X

Ligesom Web Search giver dig mulighed for at filtrere efter domæner, kan X Search filtrere efter konti (brugernavne). Du kan begrænse søgninger til opslag fra et bestemt sæt konti eller udelukke visse konti fra resultaterne. Denne filtrering er afgørende for brugssager som overvågning, brand-tracking eller influencer-analyse.

De to filtreringsparametre

X Search tilbyder to parametre til filtrering af brugernavne:

  • allowed_x_handles: Begrænser søgningen til opslag fra de listede konti (allowlist)
  • excluded_x_handles: Udelukker opslag fra de listede konti (blocklist)

Ligesom ved Web Search er disse parametre gensidigt udelukkende. Du kan ikke bruge begge i samme anmodning.

Hver parameter accepterer en liste med op til 10 brugernavne (sammenlignet med 5 domæner for Web Search).

Brug af allowed_x_handles (allowlist)

Denne parameter er ideel til at overvåge kommunikation fra specifikke konti:

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

Modellen vil kun søge efter opslag udgivet af disse konti.

Brugssager for allowlist

  • Konkurrenceintelligence: Overvåg dine konkurrenters annonceringer
  • Brand-overvågning: Track dine officielle konti og dine ambassadørers konti
  • Influencer-analyse: Saml meninger fra et panel af eksperter
  • Institutionel tracking: Følg konti fra myndigheder eller officielle organisationer

Brug af excluded_x_handles (blocklist)

Denne parameter lader dig udelukke bestemte konti, såsom bots eller irrelevante konti:

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

Brugssager for blocklist

  • Udeluk bots: Fjern automatiserede konti fra resultaterne
  • Udeluk spam: Filtrér konti kendt for indhold af lav kvalitet fra
  • Udeluk dine egne konti: Analyser eksterne reaktioner uden dine egne opslag

SDK-syntaks

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

Bemærk camelCase-konventionen i JavaScript SDK: allowedXHandles i stedet for allowed_x_handles.

Bedste praksis

Valg mellem allowlist og blocklist

Brug allowlist, når du har et defineret sæt konti og kun ønsker deres opslag. Dette er den mest præcise og token-effektive metode.

Brug blocklist, når du ønsker en bred søgning, men har brug for at rense den ved at eliminere kendte støjkilder.

Optimering af antallet af brugernavne

Med en grænse på 10 brugernavne skal du være selektiv. Hvis du har brug for at overvåge mere end 10 konti, så gruppér dine anmodninger efter emne eller foretag flere sekventielle kald.

Format for brugernavne

Brugernavne indeholder ikke symbolet @ (for eksempel xaboratory). Verificér, at brugernavnene er korrekte – et forkert stavet brugernavn vil blot returnere ingen resultater for den pågældende konto.

Vigtige pointer

  • To parametre: allowed_x_handles (allowlist) og excluded_x_handles (blocklist)
  • Gensidigt udelukkende: Kun én ad gangen pr. anmodning
  • Maksimalt 10 brugernavne pr. parameter
  • Brugernavne skrives uden @: "elonmusk", ikke "@elonmusk"
  • Ideel til overvågning, brand-tracking og influencer-analyse