← Alle Beiträge

API & Helfer

AI-Helper-Seiteninspektions-Werkzeuge — query_page und list_structure

17 Mai 2026 · von JustZix Team

Ein KI-Assistent ist nur so gut wie das, was er sehen kann. AI Helper arbeitet nicht aus einer vagen Beschreibung der Seite — er hat Werkzeuge, um das echte DOM und Ihre bestehende JustZix-Bibliothek zu betrachten. Dieser Beitrag behandelt die beiden Inspektionswerkzeuge: query_page und list_structure.

Der Ausgangskontext

Jede Nachricht, die Sie senden, trägt bereits die Seiten-URL, den Titel und ein HTML-Fragment. Das reicht für einfache Anfragen. Aber ein Fragment ist ein Fragment — für einen präzisen Selektor muss das Modell oft einen bestimmten Teil der Seite genauer betrachten. Dafür sind die Inspektionswerkzeuge da.

query_page — das Live-DOM betrachten

Das Modell übergibt einen CSS-Selektor; das Werkzeug führt ihn gegen die aktuelle Seite aus und gibt die Trefferzahl plus das HTML der Treffer zurück.

@@JZ_TOOL@@ {"tool": "query_page", "args": {"selector": "header .nav"}} @@END@@

result:
  matches: 1
  html: "<nav class=\"nav\"> ... </nav>"

Das verwandelt Raten in Prüfen. Statt CSS für eine Struktur zu schreiben, die es sich vorstellt, kann das Modell bestätigen, was tatsächlich da ist: existiert .nav, gibt es eines oder fünf davon, welche Klassen tragen die Kinder, befindet sich der Button in einem Wrapper. Damit zielt der Selektor, den es schreibt, auf die echte Seite.

Wie das Modell es verwendet

• Bestätigen, dass ein Element existiert — den Selektor abfragen, prüfen, dass die Zahl nicht null ist.
• Einen Selektor eingrenzen — breit anfangen, das zurückgegebene HTML lesen, dann etwas Spezifischeres abfragen.
• Eindeutigkeit prüfen — eine Zahl von 1 bedeutet, der Selektor ist spezifisch; eine Zahl von 30 bedeutet, er ist zu breit für eine gezielte Korrektur.
• Die Struktur lesen — Eltern-Kind-Beziehungen sehen, bevor ein :has()- oder Nachfahren-Selektor geschrieben wird.

Über einen agentischen Zug hinweg kann das Modell query_page mehrmals aufrufen und verfeinern, während es dazulernt — alles innerhalb des 8-Schritte-Budgets.

list_structure — Ihre bestehenden Regeln lesen

Das zweite Werkzeug betrachtet nicht die Seite, sondern Ihre JustZix-Bibliothek. list_structure gibt Ihre Ordner, Gruppen und Regeln zusammen mit ihren IDs zurück.

@@JZ_TOOL@@ {"tool": "list_structure", "args": {}} @@END@@

result:
  folders:
    - id: f_12  "News sites"
      groups:
        - id: g_3  "Layout fixes"
          rules:
            - id: r_88  "Hide sidebar ads"
            - id: r_90  "Wider article column"

Warum das Modell das braucht:

• Duplikate vermeiden — wenn eine ähnliche Regel bereits existiert, kann das Modell Sie darauf hinweisen, statt eine weitere zu erstellen.
• Neue Dinge sinnvoll platzieren — eine neue Regel für eine Nachrichten-Website kann in Ihren bestehenden Ordner "News sites" gehen, statt lose Regeln zu verstreuen.
• Echte IDs verwenden — create_group und create_rule brauchen eine Eltern-ID; list_structure ist, woher diese IDs kommen.

Es ist schreibgeschützt. Ihre Struktur zu sehen ist nicht dasselbe wie sie zu ändern — einen Ordner, eine Gruppe oder eine Regel zu erstellen, braucht immer noch die Erstellungswerkzeuge und Ihre ausdrückliche Bestätigung.

Warum bedarfsgesteuerte Inspektion besser ist als die ganze Seite zu übertragen

Eine offensichtliche Alternative wäre, dem Modell von vornherein das gesamte Seiten-HTML zu senden. AI Helper tut das bewusst nicht. Bedarfsgesteuerte Inspektion gewinnt aus echten Gründen:

Eine moderne Web-App kann hunderte Kilobyte HTML umfassen. All das in den Kontext zu stopfen ist langsam, teuer und oft kontraproduktiv — das Signal geht im Rauschen unter. Ein fokussiertes query_page für .cookie-banner gibt dem Modell genau die wenigen Zeilen, die es braucht.

Aktualität ist auch wichtig

Seiten sind nicht statisch. Menüs öffnen sich, Modale erscheinen, Inhalte werden spät geladen. Weil query_page in dem Moment läuft, in dem es aufgerufen wird, liest das Modell das DOM so, wie es jetzt gerade ist — einschließlich Elementen, die noch nicht existierten, als Sie den Chat zum ersten Mal öffneten. Eine einmalige Seitenübertragung kann das nicht.

Inspektion speist den Arbeitsablauf

Diese Werkzeuge sind Schritt eins des größeren agentischen Arbeitsablaufs: mit query_page und list_structure inspizieren, in einem TEMP-Pane testen, Sie um Überprüfung bitten, dann speichern. Gute Inspektion ist, was die späteren Schritte präzise macht — der Selektor stimmt, weil das Modell tatsächlich hingeschaut hat.

Siehe auch

• Der vollständige agentische Werkzeugaufruf-Arbeitsablauf
• AI Helper kennenlernen — die Übersicht
• Eine Regel mit AI Helper erstellen, Schritt für Schritt

Bedarfsgesteuerte Inspektion ist, was AI Helper präzise und günstig hält. Laden Sie JustZix herunter, fügen Sie einen Schlüssel hinzu und bitten Sie ihn, sich ein kniffliges Element anzusehen.