← Wszystkie wpisy

Przewodniki

Agentowy przepływ wywoływania narzędzi w AI Helperze wyjaśniony

17 maja 2026 · autor JustZix Team

Czat, który tylko odpowiada tekstem, jest użyteczny. Czat, który potrafi zbadać stronę, wpisać kod do działającego na żywo okna TEMP i zapisać dla Ciebie gotową regułę, to coś innego. AI Helper robi to drugie poprzez agentowy przepływ wywoływania narzędzi. Oto jak to działa.

Co znaczy tutaj „agentowy”

Gdy wysyłasz wiadomość, model nie musi odpowiedzieć za jednym razem. Może zdecydować, że potrzebuje informacji — wywołać narzędzie, by ją zdobyć — odczytać wynik i kontynuować. Ten cykl myśl → działaj → obserwuj → myśl to pętla agentowa. W AI Helperze pętla wykonuje do 8 kroków na turę, po czym model musi udzielić Ci ostatecznej odpowiedzi. Limit utrzymuje turę ograniczoną i przewidywalną.

Protokół narzędzi

Każdy dostawca ma własny natywny format wywoływania funkcji i nie pasują one do siebie. Aby uniknąć trzech osobnych ścieżek kodu, AI Helper używa jednego niezależnego od dostawcy protokołu tekstowego. Model emituje wywołanie narzędzia jako otagowany blok:

@@JZ_TOOL@@ {"tool": "query_page", "args": {"selector": ".cookie-banner"}} @@END@@

Rozszerzenie parsuje ten blok, uruchamia narzędzie i podaje wynik z powrotem do rozmowy, aby model mógł kontynuować. Ponieważ to po prostu tekst, dokładnie ta sama logika promptu i parsowania działa identycznie dla OpenAI, Anthropic i Gemini — przełącz dostawców w trakcie czatu, a przepływ się nie zmienia.

Narzędzia

AI Helper udostępnia mały, skoncentrowany zestaw narzędzi. Dzielą się one na trzy grupy.

Inspekcja

• query_page — podaj mu selektor CSS, otrzymaj liczbę dopasowań i kod HTML dopasowań. Tak model na żądanie patrzy na żywy DOM.
• list_structure — zwraca Twoje istniejące foldery, grupy i reguły wraz z ich identyfikatorami, więc model wie, co już istnieje i gdzie mogłyby trafić nowe rzeczy.

Testowanie na żywo

• open_temp_pane — otwiera w stronie okno TEMP CSS lub JS.
• set_temp_pane_code — wpisuje kod do tego panelu TEMP. Strona aktualizuje się natychmiast, więc widzisz proponowaną przez model zmianę na prawdziwej stronie, zanim cokolwiek zostanie zapisane.

Zapisywanie (za Twoim potwierdzeniem)

• create_folder — tworzy folder.
• create_group — tworzy grupę wewnątrz folderu.
• create_rule — tworzy regułę z CSS i/lub JS oraz wzorcem URL.

Każde z tych trzech wymaga osobnego, wyraźnego potwierdzenia użytkownika. Model nie może po cichu zapisać czegoś do Twojej biblioteki — każdy folder, każda grupa, każda reguła to świadome „tak” z Twojej strony. Tworzenie akcji ani pasków akcji nie jest częścią tego etapu; narzędzia obejmują foldery, grupy i reguły z CSS oraz JS.

Przepływ, który napędza prompt systemowy

Narzędzia to tylko połowa historii — prompt systemowy mówi modelowi, jak ich używać w kolejności:

1. Poproś o szczegóły — wyjaśnij, czego naprawdę chcesz, zanim cokolwiek tkniesz.
2. Zbadaj stronę — użyj query_page, aby potwierdzić prawdziwą strukturę zamiast zgadywać.
3. Przetestuj w oknie TEMP — otwórz panel, ustaw kod, pozwól Ci zobaczyć go na żywo.
4. Poproś Cię o weryfikację — „czy strona wygląda teraz dobrze?”
5. Zapisz dopiero po Twojej zgodzie — i dopiero wtedy wywołaj narzędzie tworzące, z jego własnym potwierdzeniem.

To ta sama ścieżka, którą obiera ostrożny człowiek: najpierw popatrz, potem przetestuj, na końcu zapisz.

Tura, krok po kroku

Tura: "zrób sekcję komentarzy zwijalną"

krok 1  query_page    .comments        -> 1 dopasowanie, zwrocony HTML
krok 2  open_temp_pane  css            -> otwiera sie okno TEMP CSS
krok 3  set_temp_pane_code  ...        -> CSS zwijania wstrzykniety na zywo
krok 4  (tekst) "Dodalem przelacznik zwijania - sprawdz strone."
        --- model zatrzymuje sie, czeka na Ciebie ---
Ty: "dobrze, zapisz"
krok 5  list_structure                 -> odczytuje Twoje foldery/id
krok 6  create_rule  (potwierdzic?)    -> klikasz potwierdz -> zapisane

Wykorzystano sześć kroków, dwa pozostają w budżecie. Jeśli tura kiedykolwiek osiągnie limit 8 kroków, model podsumowuje to, co ma, i mówi Ci, jak wygląda sytuacja.

Chipy wywołań narzędzi

Nigdy nie zgadujesz, co model zrobił. Każde wywołanie narzędzia i jego wynik renderują się jako chip w oknie czatu — kompaktowa karta pokazująca nazwę narzędzia, jego argumenty i podsumowanie tego, co wróciło. Przewiń rozmowę, a możesz zaudytować całą turę: który selektor odpytano, jaki kod trafił do którego panelu, która reguła została utworzona.

Dlaczego protokół tekstowy ma znaczenie dla Ciebie

Niezależne od dostawcy narzędzia to nie tylko szczegół implementacyjny. Oznacza to, że możesz wybrać dostawcę ze względu na koszt lub jakość, a zdolność agentowa jest identyczna. Żadnych zastrzeżeń typu „wywoływanie narzędzi działa tylko u dostawcy X”. Przełącz się w oknie czatu w trakcie zadania i działaj dalej.

Zobacz też

• Narzędzia inspekcji strony dogłębnie
• Zbuduj regułę z AI Helperem, krok po kroku
• Testowanie w oknach TEMP przed zapisaniem

Przepływ agentowy jest wbudowany w AI Helpera już dziś. Pobierz JustZix, dodaj klucz API i poproś go o zbudowanie czegoś — a potem obserwuj chipy.