Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Filtrování podle účtů a dat na X

Lekce 6 z 14 Aktualizováno 30. července 2026 Začátečník
Na této stránce
  1. Přesně zacil svá vyhledávání na X
  2. Filtrování podle účtů: allowed_x_handles a excluded_x_handles
  3. Filtrování podle dat: from_date a to_date
  4. Kombinování filtrů
  5. Vytvoření dynamického monitorovacího systému
  6. Procvičování
  7. Klíčové poznatky

Přesně zacil svá vyhledávání na X

Vyhledávání na X přináší skutečnou hodnotu až ve chvíli, kdy zvládneš jeho filtrační parametry. Místo tahání surového feedu příspěvků můžeš cílit na konkrétní účty, nastavit přesná časová okna a vyloučit zdroje šumu. Tyto filtry promění obecný vyhledávací nástroj v precizní nástroj pro monitorování.

Filtrování podle účtů: allowed_x_handles a excluded_x_handles

Sledování konkrétních účtů

Parametr allowed_x_handles omezuje vyhledávání pouze na příspěvky zveřejněné účty, které uvedeš. Můžeš cílit až na 10 účtů současně:

response = client.responses.create(
    model="grok-4.5",
    input="Summary of recent announcements from these tech accounts",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": [
            "elonmusk",
            "sama",
            "demishassabis",
            "ylecun"
        ]
    }]
)

Vyloučení hlučných účtů

Parametr excluded_x_handles funguje obráceně. Povolí všechny účty kromě těch, které specifikuješ. Je užitečný pro eliminaci botů nebo účtů s irelevantním obsahem:

response = client.responses.create(
    model="grok-4.5",
    input="Serious discussions on AI regulation",
    tools=[{
        "type": "x_search",
        "excluded_x_handles": ["bot_spam_1", "compte_parodie"]
    }]
)

Pravidlo vzájemné výlučnosti

Stejně jako u webových domén jsou allowed_x_handles a excluded_x_handles vzájemně výlučné. Nemůžeš je kombinovat v jediném volání. Limit je 10 účtů na parametr, což je dvojnásobek limitu pro webové domény.

Filtrování podle dat: from_date a to_date

Časové parametry ti umožňují definovat přesné vyhledávací okno ve formátu ISO 8601 (YYYY-MM-DD):

response = client.responses.create(
    model="grok-4.5",
    input="Reactions to the Grok 4.5 announcement",
    tools=[{
        "type": "x_search",
        "from_date": "2026-03-01",
        "to_date": "2026-03-15"
    }]
)

Tyto filtry jsou obzvláště užitečné pro:

  • Analýzu dopadu události: definuj období kolem události
  • Porovnání sentimentu před/po: spusť dva dotazy s různými okny
  • Vyhnout se starému šumu: zaměř se na nedávné diskuse

Použití s nativním Python SDK

xAI SDK přijímá vedle řetězců ISO také objekty datetime z Pythonu:

from xai_sdk.tools import x_search
from datetime import datetime

response = client.chat.create(
    model="grok-4.5",
    tools=[x_search(
        from_date=datetime(2026, 3, 1),
        to_date=datetime(2026, 3, 31)
    )]
)

Konvence camelCase v JavaScriptu

Vercel AI SDK používá pro názvy parametrů konvenci camelCase:

tools: [xai.tools.xSearch({
  allowedXHandles: ["elonmusk"],
  fromDate: "2026-03-01",
  toDate: "2026-03-31"
})]

Kombinování filtrů

Pro maximální přesnost můžeš v jediném volání kombinovat účty i data:

response = client.responses.create(
    model="grok-4.5",
    input="What did Sam Altman say about GPT-5 in March 2026?",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["sama"],
        "from_date": "2026-03-01",
        "to_date": "2026-03-31"
    }]
)

Vytvoření dynamického monitorovacího systému

Programatickým kombinováním těchto filtrů můžeš vytvořit konfigurovatelný nástroj pro monitorování:

def create_x_monitor(handles, days_back=7):
    from datetime import datetime, timedelta
    today = datetime.now()
    start = (today - timedelta(days=days_back)).strftime("%Y-%m-%d")

    return {
        "type": "x_search",
        "allowed_x_handles": handles,
        "from_date": start,
        "to_date": today.strftime("%Y-%m-%d")
    }

# Monitoruj lídry v AI za poslední týden
tool = create_x_monitor(
    handles=["sama", "demishassabis", "ylecun"],
    days_back=7
)

Procvičování

Nakonfiguruj cílené vyhledávání na X pro 3 až 5 vlivných účtů ve tvém oboru. Nastav časové okno na jeden týden a porovnej výsledky s vyhledáváním bez filtrů podle účtů. Změř rozdíl v relevanci.

Klíčové poznatky

  • allowed_x_handles a excluded_x_handles filtrují podle účtu (maximálně 10 pro každý)
  • Oba parametry pro účty jsou vzájemně výlučné
  • from_date a to_date definují časové okno ve formátu YYYY-MM-DD
  • Data lze kombinovat s filtry podle účtů
  • Python SDK přijímá objekty datetime, JavaScript SDK používá camelCase
  • Tyto filtry promění vyhledávání na X z obecného nástroje v cílený nástroj pro monitorování