Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Nach Handles und Daten auf X filtern

Lektion 6 von 14 Aktualisiert am 30. Juli 2026 Anfänger
Auf dieser Seite
  1. Präzise Ihre X-Suchen steuern
  2. Filtern nach Handles: allowed_x_handles und excluded_x_handles
  3. Filtern nach Daten: from_date und to_date
  4. Filter kombinieren
  5. Ein dynamisches Überwachungssystem erstellen
  6. Übung
  7. Kernaussagen

Präzise Ihre X-Suchen steuern

Die X-Suche liefert erst dann echten Mehrwert, wenn Sie ihre Filterparameter beherrschen. Anstatt einen rohen Feed an Beiträgen abzurufen, können Sie spezifische Konten ansprechen, präzise Zeitfenster festlegen und Quellen für Rauschen ausschließen. Diese Filter verwandeln ein allgemeines Suchwerkzeug in ein Instrument zur präzisen Überwachung.

Filtern nach Handles: allowed_x_handles und excluded_x_handles

Spezifische Konten überwachen

Der Parameter allowed_x_handles beschränkt die Suche auf Beiträge, die von den von Ihnen aufgeführten Konten veröffentlicht wurden. Sie können bis zu 10 Handles gleichzeitig ansprechen:

response = client.responses.create(
    model="grok-4.5",
    input="Zusammenfassung der letzten Ankündigungen von diesen Tech-Konten",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": [
            "elonmusk",
            "sama",
            "demishassabis",
            "ylecun"
        ]
    }]
)

Rauschende Konten ausschließen

Der Parameter excluded_x_handles funktioniert umgekehrt. Er erlaubt alle Konten außer den von Ihnen angegebenen. Dies ist nützlich, um Bots oder Konten mit irrelevanter Inhalte zu eliminieren:

response = client.responses.create(
    model="grok-4.5",
    input="Ernstzunehmende Diskussionen zur KI-Regulierung",
    tools=[{
        "type": "x_search",
        "excluded_x_handles": ["bot_spam_1", "compte_parodie"]
    }]
)

Regel der gegenseitigen Ausschließung

Wie bei Web-Domains sind allowed_x_handles und excluded_x_handles gegenseitig ausschließend. Sie können sie in einem einzigen Aufruf nicht kombinieren. Das Limit beträgt 10 Handles pro Parameter, was dem Doppelten des Limits für Web-Domains entspricht.

Filtern nach Daten: from_date und to_date

Zeitparameter ermöglichen es, ein präzises Suchfenster im ISO 8601-Format (YYYY-MM-DD) zu definieren:

response = client.responses.create(
    model="grok-4.5",
    input="Reaktionen auf die Ankündigung von Grok 4.5",
    tools=[{
        "type": "x_search",
        "from_date": "2026-03-01",
        "to_date": "2026-03-15"
    }]
)

Diese Filter sind insbesondere nützlich für:

  • Auswirkung eines Ereignisses analysieren: definieren Sie den Zeitraum um das Ereignis herum
  • Stimmung vor/nachher vergleichen: führen Sie zwei Abfragen mit unterschiedlichen Fenstern durch
  • Älteres Rauschen vermeiden: konzentrieren Sie sich auf aktuelle Diskussionen

Verwendung mit dem nativen Python-SDK

Das xAI-SDK akzeptiert Python datetime-Objekte zusätzlich zu ISO-Strings:

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

camelCase-Konvention in JavaScript

Das Vercel AI-SDK verwendet die camelCase-Konvention für Parameternamen:

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

Filter kombinieren

Sie können Handles und Daten in einem einzigen Aufruf kombinieren, um maximale Präzision zu erreichen:

response = client.responses.create(
    model="grok-4.5",
    input="Was hat Sam Altman über GPT-5 im März 2026 gesagt?",
    tools=[{
        "type": "x_search",
        "allowed_x_handles": ["sama"],
        "from_date": "2026-03-01",
        "to_date": "2026-03-31"
    }]
)

Ein dynamisches Überwachungssystem erstellen

Indem Sie diese Filter programmatisch kombinieren, können Sie ein konfigurierbares Überwachungswerkzeug erstellen:

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

# Überwachung von KI-Führern für die Woche
tool = create_x_monitor(
    handles=["sama", "demishassabis", "ylecun"],
    days_back=7
)

Übung

Konfigurieren Sie eine gezielte X-Suche für 3 bis 5 einflussreiche Konten in Ihrem Sektor. Legen Sie ein Zeitfenster von einer Woche fest und vergleichen Sie die Ergebnisse mit einer Suche ohne Handle-Filter. Messen Sie den Unterschied in der Relevanz.

Kernaussagen

  • allowed_x_handles und excluded_x_handles filtern nach Konten (maximal 10 pro Parameter)
  • Beide Handle-Parameter sind gegenseitig ausschließend
  • from_date und to_date definieren das Zeitfenster im Format YYYY-MM-DD
  • Daten können mit Handle-Filtern kombiniert werden
  • Das Python-SDK akzeptiert datetime-Objekte, das JavaScript-SDK verwendet camelCase
  • Diese Filter verwandeln die X-Suche von einem allgemeinen Werkzeug in ein gezieltes Überwachungsinstrument