Twój pierwszy agent AI nie jest robotem, który zabierze Ci pracę. Jest skryptem, który w końcu przestaje czekać aż Ty go uruchomisz.

Twój pierwszy agent AI bez programowania nie jest robotem, który przetworzy Twoje CV i znajdzie nową pracę. Jest skryptem, który w końcu przestaje czekać aż Ty go uruchomisz.

To jest fundamentalna różnica między agentem a wszystkim, czego używałeś wcześniej. ChatGPT czeka. Arkusz kalkulacyjny czeka. Twój kolega z działu odpowiada w ciągu 3 dni roboczych. Agent nie czeka. Włączasz go raz i od tej chwili działa bez Twojego nadzoru.

Ten artykuł to instrukcja budowy pierwszego agenta w n8n, narzędziu, które nie wymaga pisania kodu. Cel: agent, który czyta przychodzące maile, klasyfikuje je na kategorie i odpowiada na proste pytania bez Twojego udziału. Jeśli czytałeś czym jest agent AI, to już wiesz co zbudujemy. Teraz zbudujemy to.

Czym jest n8n i dlaczego nie Zapier

n8n to narzędzie do automatyzacji i budowania agentów AI. Wymawia się go "n-eight-n" (co jest informacją bardziej przydatną do rozmów przy kawie niż do samego używania narzędzia, ale warto wiedzieć zanim ktoś zapyta).

Zapier jest starszy, bardziej znany i prostszy dla prostych automatyzacji, które robią jedną rzecz. n8n jest lepszy do agentów, bo ma wbudowane węzły AI, obsługuje pętle i podejmowanie decyzji bez hacków, i pozwala na warunki logiczne, które Zapier chowałby za paywallem. Zapier ma też darmowy plan, który jest tak ograniczony, że właściwie płacisz za sam widok logo.

n8n ma darmowy plan w chmurze (n8n.cloud), bez karty kredytowej, bez serwera, bez terminala. Darmowy plan wystarcza dokładnie do momentu, kiedy zaczniesz używać agenta poważnie, ale na pierwszy projekt spokojnie wystarczy. Konto zakładasz na n8n.io.

Jeśli wcześniej słyszałeś o Make.com albo Zapierie i zastanawiasz się który wybrać do agentów, pisałem o tym szerzej w porównaniu Make vs n8n vs Zapier. Krótka odpowiedź: do agentów n8n wypada najlepiej.

Zanim klikniesz "nowy workflow": co agent będzie robił

RDNE Stock project / Pexels

Najpierw zapisz w jednym zdaniu co agent ma robić. Dosłownie jedno zdanie, zanim dotkniesz narzędzia. Bez tego etapu schemat w n8n wygląda jak mapa metra w Tokio, tyle że bez kolorów i bez napisów po angielsku.

Nasze zadanie dla agenta: "Czytaj przychodzące maile na skrzynce, klasyfikuj je na: pytanie o ofertę, reklamacja, prośba o fakturę, inne. Odpowiadaj na każdą kategorię innym szablonem. Przy kategorii 'inne' nie odpowiadaj, tylko zapisz do arkusza."

To jest konkretne i testowalne. Wiesz, kiedy działa: mail przyszedł, dostał kategorię, poszła odpowiedź lub wpis w arkuszu. Wiesz, kiedy nie działa: mail przyszedł i nic się nie wydarzyło. Żadna z tych dwóch sytuacji nie pozostawia miejsca na interpretację, co jest rzadkością w świecie narzędzi AI.

Jeśli Twoje jedno zdanie zaczyna się od "Agent powinien mniej więcej..." — zacznij od nowa. Agenci robią dokładnie to, co im napisałeś. Nie to, co miałeś na myśli. Nie to, czego chciałeś. To, co napisałeś.

Jak zbudować agenta AI krok po kroku w n8n

Krok 1: Trigger (wyzwalacz)

Trigger to punkt startowy agenta. Bez triggera agent nie wie, kiedy zacząć działać. Myślałem przez jakiś czas, że "trigger" to słowo z filmów o CIA. Okazało się, że to słowo z panelu n8n, które znajdziesz jako pierwsze po otwarciu pustego schematu.

Do naszego agenta emailowego dodajesz węzeł "Gmail Trigger" albo "Email Trigger IMAP", zależnie z czego korzystasz. Konfigurujesz, żeby sprawdzał skrzynkę co 5 minut. Agent nie siedzi i nie czeka. Budzi się co 5 minut, zerka czy jest coś nowego i albo coś robi, albo idzie spać z powrotem.

Krok 2: Węzeł AI Agent

To serce całości. W n8n szukasz węzła "AI Agent". Tutaj wpisujesz instrukcję, co agent ma z tym mailem zrobić. Instrukcja wygląda mniej więcej tak: "Przeczytaj poniższy mail. Zaklasyfikuj go do jednej z kategorii: pytanie_o_ofertę, reklamacja, faktura, inne. Odpowiedz tylko nazwą kategorii, nic więcej." Koniec instrukcji.

Masz jeszcze pole "Model", gdzie wybierasz GPT-4o albo inny model. Do klasyfikacji maili GPT-4o Mini spokojnie wystarczy i kosztuje ułamek ceny pełnego GPT-4o. Nie ma powodu używać Ferrari do jazdy po parking.

Krok 3: Warunek (Switch)

Po węźle AI Agent dodajesz węzeł "Switch". To jest rozgałęzienie. Agent wrócił z kategorią. Switch sprawdza, co to za kategoria i kieruje mail do właściwej ścieżki. 4 kategorie, 4 ścieżki. Każda ścieżka kończy się innym działaniem.

Pierwsze uruchomienie skończy się błędem. Drugie uruchomienie też. Trzecie się uda, i od tej chwili nie wiesz dlaczego pierwsze dwa nie działały, ale przestałeś się tym przejmować.

Krok 4: Działania na końcu każdej ścieżki

Ścieżka "pytanie_o_ofertę": węzeł Gmail "Send Email" ze szablonem odpowiedzi. Ścieżka "reklamacja": analogicznie, inny szablon. Ścieżka "faktura": inny szablon albo przekierowanie do odpowiedniej osoby. Ścieżka "inne": węzeł Google Sheets "Append Row", który wpisuje temat maila, nadawcę i datę do arkusza.

To jest 8 węzłów łącznie. Schemat na ekranie wygląda jak coś, co wymaga dyplomu. W rzeczywistości to 4 kroki i rozgałęzienie, które każdy narysowałby na kartce w 2 minuty. Jeśli chcesz zrozumieć szerzej, jak AI pozwala budować narzędzia bez programowania, ten artykuł dobrze uzupełnia to, co właśnie budujesz.

Automatyzacja maili AI: jak napisać instrukcję, żeby agent nie fiksował

Pavel Danilyuk / Pexels

Instrukcja dla agenta to jedyne miejsce, gdzie jakość tekstu ma naprawdę znaczenie. Reszta to klikanie. Instrukcja decyduje o tym, czy agent klasyfikuje maile poprawnie, czy trafia na "inne" przy każdym piątym.

Kilka zasad, które działają:

Podaj przykłady kategorii. Zamiast "pytanie o ofertę" napisz: "pytanie_o_ofertę: mail zawiera pytania o cenę, zakres usług, czas realizacji, dostępność." Agent rozumie definicję lepiej przez przykład niż przez nazwę. Tak samo jak człowiek, tyle że człowiek po przykładach pyta jeszcze raz, a agent nie.

Powiedz agentowi co zrobić przy wątpliwościach. "Jeśli nie jesteś pewien kategorii, wybierz 'inne'." Bez tego agent klasyfikuje według własnego uznania. Co brzmi dobrze do momentu, gdy reklamacja od klienta dolatuje jako "pytanie o ofertę" z odpowiedzią o aktualnych cenach.

Ogranicz format odpowiedzi. "Odpowiedz tylko słowem kluczowym kategorii, bez żadnych innych słów." Bez tego ograniczenia agent lubi pisać "Na podstawie analizy treści wiadomości ustalono, że kategoria to: reklamacja." Do węzła Switch trafia cały ten tekst i Switch nie wie co z tym zrobić.

Dokumentacja n8n mówi, że konfiguracja agenta jest intuicyjna. Dokumentacja ma rację, o ile wcześniej skonfigurowałeś już 3 inne agenty. Dla pierwszego polecam przeznaczyć godzinę i nie panikować po dziesiątym błędzie.

Pierwsze uruchomienie: dlaczego coś pójdzie nie tak i co z tym zrobić

W n8n klikasz "Test workflow" i patrzysz co się stanie. Przy pierwszym uruchomieniu coś pójdzie nie tak. To jest normalny stan rzeczy, nie powód do zamknięcia karty i udania, że się nic nie zaczęło.

Typowe błędy i co z nimi zrobić:

"Authentication error" przy Gmailu. Musisz połączyć konto Google w sekcji Credentials w n8n. Klikasz "Add New Credential", wybierasz Gmail OAuth2, logujesz się przez Google. Zajmuje 3 minuty. Dokumentacja zajmuje 20.

Agent zwraca nie tę kategorię. Wróć do instrukcji i dodaj przykład dla kategorii, która się myli. Agenci poprawiają się przez lepsze instrukcje, nie przez modlitwy.

Switch nie rozpoznaje wartości. Sprawdź czy wartość z węzła AI Agent jest dokładnie taka sama jak to, co wpisałeś w Switch. "Reklamacja" z dużej litery to nie to samo co "reklamacja" z małej. Agent i Switch nie rozmawiają ze sobą. Przekazują sobie tekst i ten tekst musi być identyczny.

Wysłałeś testowego maila do siebie i nic się nie wydarzyło. Trigger sprawdza co 5 minut. Poczekaj 5 minut. Albo kliknij "Execute manually" na węźle Trigger. Albo zrób sobie kawę i wróć po 5 minutach. Kawa i tak już stygnie od początku tej sekcji.

Wszystko działa na teście, nie działa na produkcji. Upewnij się, że workflow jest aktywowany. W n8n są dwa stany: "inactive" (działa tylko po ręcznym uruchomieniu) i "active" (działa automatycznie według triggera). Większość pierwszych "dlaczego to nie działa" ma tę samą odpowiedź.

Co agent AI robi bez Ciebie i gdzie się zatrzymuje

Twój agent działa. Co konkretnie się teraz dzieje, kiedy Ty robisz coś innego?

Co 5 minut agent zerka na skrzynkę. Jeśli jest nowy mail, czyta go, klasyfikuje i, zależnie od kategorii, albo wysyła odpowiedź, albo zapisuje do arkusza. Nie pyta Cię o zdanie. Nie czeka na potwierdzenie. Nie informuje Cię, że zaraz wyśle maila. Po prostu go wysyła.

To jest dokładnie ta zaleta, o której mówiliśmy na początku. I dokładnie to ryzyko, na które trzeba się przygotować. Agent nie ma złych intencji. Ma złe instrukcje i bardzo dobrą egzekucję.

Agent robi dokładnie to, co mu kazałeś, łącznie z błędami w instrukcji. Jeśli szablon odpowiedzi na "pytanie o ofertę" zawiera stare ceny z poprzedniego kwartału, agent wyśle stare ceny do każdego zainteresowanego. Grzecznie i bez opóźnień.

Gdzie agent powinien się zatrzymać i czekać na Ciebie: przy każdej akcji z realnymi konsekwencjami, której nie możesz cofnąć. Wysłanie maila do 200 klientów: warto zostawić krok weryfikacji przed wysyłką. Usunięcie rekordów z bazy: zdecydowanie nie dla agenta działającego bez nadzoru. Zapisanie do arkusza: śmiało.

Dobra zasada na start: niech agent czyta i klasyfikuje sam, ale pyta Cię przed wysyłaniem odpowiedzi. Kiedy zobaczysz, że klasyfikacja działa poprawnie przez tydzień, możesz mu dać zielone światło do wysyłania. To nie jest brak zaufania do agenta. To jest rozsądny etap wdrożenia, który każdy pomija i który wszyscy żałują.

AI nie zastępuje programistów. AI zmienia to, kto może zbudować działające narzędzie. Budując agenta bez kodu, jesteś jednocześnie osobą, która opisuje problem, projektuje rozwiązanie i je wdraża. To nie było możliwe 3 lata temu. Teraz jest, o ile wiesz czego chcesz.