Narzędzia inspekcji strony w AI Helperze — query_page i list_structure
Asystent AI jest tylko tak dobry, jak to, co potrafi zobaczyć. AI Helper nie pracuje na podstawie mglistego opisu strony — ma narzędzia, by spojrzeć na prawdziwy DOM i na Twoją istniejącą bibliotekę JustZix. Ten wpis omawia dwa narzędzia inspekcji: query_page i list_structure.
Kontekst początkowy
Każda wysyłana przez Ciebie wiadomość niesie już adres URL strony, tytuł i fragment HTML. To wystarcza do prostych żądań. Ale fragment to fragment — do precyzyjnego selektora model często musi przyjrzeć się bliżej konkretnej części strony. Do tego właśnie służą narzędzia inspekcji.
query_page — spojrzenie na żywy DOM
Model przekazuje selektor CSS; narzędzie uruchamia go względem bieżącej strony i zwraca liczbę dopasowań plus kod HTML dopasowań.
@@JZ_TOOL@@ {"tool": "query_page", "args": {"selector": "header .nav"}} @@END@@
wynik:
matches: 1
html: "<nav class=\"nav\"> ... </nav>"To zamienia zgadywanie na sprawdzanie. Zamiast pisać CSS dla struktury, którą sobie wyobraża, model może potwierdzić, co naprawdę tam jest: czy .nav istnieje, czy jest jeden czy pięć, jakie klasy noszą dzieci, czy przycisk jest wewnątrz opakowania. Dzięki temu selektor, który pisze, celuje w prawdziwą stronę.
Jak model tego używa
- Potwierdza, że element istnieje — odpytuje selektor, sprawdza, czy liczba nie jest zerem.
- Zawęża selektor — zaczyna szeroko, czyta zwrócony HTML, potem odpytuje coś bardziej konkretnego.
- Sprawdza unikalność — liczba 1 oznacza, że selektor jest konkretny; liczba 30 oznacza, że jest zbyt szeroki do celowanej poprawki.
- Odczytuje strukturę — widzi relacje rodzic/dziecko przed napisaniem selektora
:has()lub potomka.
W ramach tury agentowej model może wywołać query_page kilka razy, dopracowując w miarę uczenia się — wszystko w budżecie 8 kroków.
list_structure — odczyt Twoich istniejących reguł
Drugie narzędzie patrzy nie na stronę, ale na Twoją bibliotekę JustZix. list_structure zwraca Twoje foldery, grupy i reguły wraz z ich identyfikatorami.
@@JZ_TOOL@@ {"tool": "list_structure", "args": {}} @@END@@
wynik:
folders:
- id: f_12 "Strony z wiadomosciami"
groups:
- id: g_3 "Poprawki ukladu"
rules:
- id: r_88 "Ukryj reklamy na pasku bocznym"
- id: r_90 "Szersza kolumna artykulu"Dlaczego model tego potrzebuje:
- Unikanie duplikatów — jeśli podobna reguła już istnieje, model może wskazać Ci ją zamiast tworzyć kolejną.
- Rozsądne umieszczanie nowych rzeczy — nowa reguła dla strony z wiadomościami może trafić do Twojego istniejącego folderu „Strony z wiadomościami”, zamiast rozsiewać luźne reguły.
- Używanie prawdziwych identyfikatorów —
create_groupicreate_rulepotrzebują identyfikatora rodzica;list_structureto miejsce, skąd te identyfikatory pochodzą.
Jest tylko do odczytu. Zobaczenie Twojej struktury to nie to samo co jej zmiana — utworzenie folderu, grupy lub reguły nadal wymaga narzędzi tworzących i Twojego wyraźnego potwierdzenia.
Dlaczego inspekcja na żądanie bije zrzucanie całej strony
Oczywistą alternatywą byłoby wysłanie modelowi całego HTML strony z góry. AI Helper celowo tego nie robi. Inspekcja na żądanie wygrywa z realnych powodów:
| Zrzucenie całej strony | Inspekcja na żądanie |
|---|---|
| Ogromny koszt tokenów przy każdej wiadomości | Płacisz tylko za to, co odpytane |
| Model tonie w nieistotnym znaczniku | Model widzi część, która ma znaczenie |
| Nowoczesne strony mogą przekroczyć okno kontekstu | Celowane fragmenty zawsze się mieszczą |
| Nieaktualne po zmianie strony | Każde zapytanie odczytuje bieżący DOM |
Nowoczesna aplikacja webowa może mieć setki kilobajtów HTML. Wpychanie całości do kontekstu jest wolne, drogie i często przeciwskuteczne — sygnał ginie w szumie. Skoncentrowane query_page dla .cookie-banner daje modelowi dokładnie te kilka linijek, których potrzebuje.
Aktualność też ma znaczenie
Strony nie są statyczne. Menu się otwierają, pojawiają się okna modalne, treść ładuje się z opóźnieniem. Ponieważ query_page uruchamia się w momencie wywołania, model odczytuje DOM taki, jaki jest teraz — wraz z elementami, które nie istniały, gdy po raz pierwszy otworzyłeś czat. Jednorazowy zrzut strony tego nie potrafi.
Inspekcja napędza przepływ
Te narzędzia to pierwszy krok większego przepływu agentowego: zbadaj za pomocą query_page i list_structure, przetestuj w panelu TEMP, poproś Cię o weryfikację, potem zapisz. Dobra inspekcja sprawia, że późniejsze kroki są dokładne — selektor jest prawidłowy, bo model naprawdę popatrzył.
Zobacz też
- Pełny agentowy przepływ wywoływania narzędzi
- Poznaj AI Helper — przegląd
- Zbuduj regułę z AI Helperem, krok po kroku
Inspekcja na żądanie sprawia, że AI Helper jest precyzyjny i tani. Pobierz JustZix, dodaj klucz i poproś go o spojrzenie na trudny element.
Oceń ten wpis
Brak ocen — oceń jako pierwszy.