Baza wiedzy

Jak zbudować agenta AI krok po kroku

Agent AI to pętla: model wybiera narzędzie, system je wykonuje, wynik wraca do modelu. Wszystko inne — prompt, pamięć, limity — obsługuje tę pętlę. Kolejność budowy ma znaczenie: najpierw jedno narzędzie i jeden mierzalny przypadek, potem rozbudowa.

Opublikowano 2026-08-08 · Jakub Butryn, Founder · Lead engineer

Pętla narzędzi — serce agenta

Minimalna pętla ma cztery elementy: lista narzędzi z opisem parametrów, wywołanie modelu, wykonanie wybranego narzędzia i dopisanie wyniku do historii. Pętla kończy się, gdy model odpowie tekstem bez wywołania narzędzia albo gdy przekroczy limit iteracji — ten limit musi istnieć od pierwszego dnia.

Najczęstszy błąd: brak twardego limitu kroków i brak zapisu wyników narzędzi do tej samej historii. Bez tego agent gubi kontekst po turze i powtarza pracę.

Prompt systemowy: rola, doktryna, świadomość aktualności

Prompt systemowy nie jest miejscem na życzenia. Działają trzy rzeczy: opis roli i granic („co wolno, czego nie”), doktryna działania (kolejność kroków, kiedy pytać człowieka) oraz jawna informacja o dacie i odcięciu wiedzy modelu, żeby agent sam sięgał po wyszukiwanie przy pytaniach o aktualność.

Prompt trzymaj w jednym miejscu i wersjonuj. Zmiana promptu to zmiana zachowania produktu — powinna przechodzić te same testy co zmiana kodu.

Okno kontekstu i kompresja

Okno kontekstu to sufit na wejście plus wyjście. Praktyka: licz zapełnienie po każdej turze i kompresuj historię, zanim uderzysz w limit — inaczej model zacznie gubić początek rozmowy w najmniej wygodnym momencie.

Kompresja to nie obcięcie. Streszczaj starsze tury, ale zachowuj wyniki narzędzi, które wpływają na dalsze decyzje. W ZAZA-CODE liczenie zapełnienia jest osobnym krokiem po każdej turze, a checkpoint pamięci powstaje co kilka tur, żeby przeżyć nagłe zamknięcie procesu.

Kolejność budowy, która się sprawdza

Jedno narzędzie, jeden przypadek, jeden mierzalny wynik. Potem: dziennik działań (co agent zrobił i dlaczego), limit kosztu, obsługa błędów narzędzi, dopiero na końcu rozbudowa zestawu narzędzi.

Odwrotna kolejność — najpierw dwadzieścia integracji — kończy się agentem, którego nikt nie umie zdiagnozować, bo każda awaria ma pięć możliwych źródeł.

Najczęstsze pytania

Ile czasu zajmuje zbudowanie prostego agenta AI?

Pętla z jednym narzędziem i limitem kroków to kwestia godzin. Agent produkcyjny z dziennikiem działań, limitami kosztu i obsługą błędów narzędzi to zwykle kilka tygodni, bo większość pracy leży poza modelem.

Czy do zbudowania agenta AI potrzebny jest framework?

Nie. Pętla narzędziowa to kilkadziesiąt linii kodu: wywołanie modelu, wykonanie narzędzia, dopisanie wyniku do historii. Framework ukrywa dokładnie te miejsca, które trzeba rozumieć przy diagnozowaniu awarii.

Omów swój przypadek — konsultacja bezpłatna Telegram @sotius