kontakt@tujestbug.pl

Spis treści

Jak generować przypadki testowe z user story w n8n?

Cześć! Pewnie nie raz spotkałeś się z sytuacją, że prosisz ChatGPT o przypadki testowe z user story. Efekt? Zwykle daleki od tego, czego potrzebujesz. Przy takim podejściu wracają dwa problemy:

  • Brak kontroli nad strategią testowania. Liczba i jakość przypadków zmienia się z każdym zapytaniem. Jedyny sposób, żeby to opanować, to powtarzać w każdym prompcie te same reguły — co po kilku razach zaczyna męczyć.
  • Brak miejsca na wynik. Test case’y zostają w oknie czatu. Dlatego, żeby je wykonać, musisz je gdzieś przenieść i ręcznie pilnować statusów. Wygodne to nie jest, a przy kilkunastu historyjkach po prostu się nie skaluje.

Mam dla Ciebie dobrą wiadomość — da się to zautomatyzować. W tym artykule pokażę Ci rozwiązanie w n8n: wrzucasz user stories do folderu na Google Drive i klikasz jeden przycisk. W efekcie n8n generuje przypadki testowe z user story i dla każdej historyjki zapisuje je w arkuszu Google Sheets, gotowe do manualnego wykonania. Natomiast o tym, jakie to mają być testy, decydujesz w jednym dokumencie ze strategią testowania.

W skrócie

  1. Na Google Drive tworzysz folder na cały generator.
  2. Do n8n importujesz 4 gotowe workflowy z repozytorium na GitHubie.
  3. Łączysz n8n z Google Drive, Docs i Sheets (OAuth) i dodajesz darmowy klucz API do Google Gemini.
  4. Workflow „Initial Setup” tworzy strukturę: folder User Stories, folder Test Cases i dokument TJB Testing Strategy.
  5. Wrzucasz user stories (Google Docs) → Execute Workflow → w Test Cases dostajesz jeden arkusz na każdą historyjkę.

Workflowów po konfiguracji już nie ruszasz:

  • nowa funkcjonalność do przetestowania → dodajesz kolejną user story do folderu,
  • inna liczba, rodzaj lub szczegółowość test case’ów → zmieniasz treść strategii testowania.

Jak to działa w praktyce?

Całe rozwiązanie opiera się na jednym folderze na Google Drive, w którym są trzy rzeczy:

  • User Stories — historyjki użytkownika w formacie Google Docs, dla których chcesz wygenerować testy,
  • Test Cases — tu lądują wygenerowane arkusze (na starcie pusty),
  • TJB Testing Strategy — dokument z instrukcją dla modelu AI: ile przypadków, jakie techniki, na co zwracać uwagę.
Folder generatora test case'ów na Google Drive: Test Cases, User Stories i TJB_Testing_Strategy

Na start strategia może być bardzo prosta, np.:

Wygeneruj 2–3 przypadki testowe, w tym co najmniej
jeden pozytywny i jeden negatywny scenariusz.
Utrzymuj przypadki testowe proste i praktyczne.

Na przykład dla historyjki „konto zostaje zablokowane po 5 nieudanych próbach logowania” taka strategia dała mi 3 przypadki:

  • udane logowanie przed przekroczeniem limitu,
  • blokada konta po 5 nieudanych próbach,
  • ponowne logowanie, gdy blokada minie.

Każdy arkusz ma kolumny z krokami testu i oczekiwanym rezultatem dla każdego kroku. Po prawej stronie zaznaczasz, czy krok przeszedł, a jeśli nie — wpisujesz, co poszło nie tak (np. „pole było nieedytowalne”). Czyli arkusz od razu służy do manualnego wykonania testów.

Przypadki testowe z user story w arkuszu Google Sheets: kroki, oczekiwany wynik i status TRUE / FALSE

Demo generatora test case’ów na wideo

Jak zmienić strategię testowania?

Wystarczy podmienić treść dokumentu TJB Testing Strategy. W filmie wkleiłem strategię opartą na technikach ISTQB: analizie wartości brzegowych, tablicach decyzyjnych i testowaniu przejść między stanami. Ponadto wymaga ona pokrycia wszystkich reguł biznesowych, decyzji i wartości brzegowych. Jeśli chcesz odświeżyć sobie ISTQB, zobacz też, czy ChatGPT zda egzamin ISTQB. Tę strategię możesz przejrzeć i skopiować.

Efekt po zmianie strategii:

  • Blokada konta — zamiast 3 przypadków dostałem 5. Doszło m.in. logowanie w trakcie blokady i test ze zmienionym progiem (np. 3 próby zamiast 5).
  • Odtwarzanie muzyki (play, pauza, wznowienie, pomijanie) — 10 przypadków. Ta historyjka aż prosi się o testowanie przejść między stanami. Dlatego są tu zarówno poprawne przejścia (np. pauza w trakcie odtwarzania), jak i niedozwolone (pauza, gdy muzyka jest zatrzymana). Ta historyjka też jest do wglądu.

Liczba historyjek w folderze nie jest ograniczona. Przy większej paczce workflow po prostu dłużej pracuje w tle, a Ty w tym czasie robisz swoje.

Samej strategii nie musisz pisać od zera: dopracuj ją z dowolnym LLM-em i przenieś gotowy tekst do dokumentu.

Jak przygotować folder na Google Drive?

Na początku wystarczy jeden pusty folder — resztę struktury założy za Ciebie workflow. Na Google Drive kliknij prawym przyciskiem myszy → Nowy folder i nazwij go dowolnie (u mnie „N8N test cases”).

Będzie Ci potrzebny jego identyfikator — to ciąg znaków w adresie URL po folders/:

https://drive.google.com/drive/folders/<ID_FOLDERU>

Przede wszystkim kopiuj go bez ukośnika. Podobnie później wyciągniesz ID plików i pozostałych folderów.

Setup folderu na Google Drive na wideo

Jak zaimportować workflowy do n8n?

Całe rozwiązanie to 4 workflowy, które są gotowe do importu — nic nie budujesz od zera. Znajdziesz je na branchu tjb-29-google-sheets-docs w katalogu N8N Workflows → Tutorial YouTube → AI Test Cases Generator:

  1. Initial Setup — zakłada strukturę folderów i przykładowe pliki na Drive,
  2. Write Test Cases to Google Sheets — zapisuje gotowe test case’y do arkusza,
  3. Generate Test Cases for Given User Story — generuje test case’y przez AI,
  4. Main — spina wszystko razem.

Przy tym nie ma znaczenia, czy masz n8n w chmurze, czy na localhoście. Rekomenduję założyć w n8n osobny katalog (np. „AI Test Cases Generator”), żeby te 4 workflowy były w jednym miejscu.

Import każdego wygląda tak samo. Najpierw na GitHubie otwierasz plik → Download raw file. Następnie w n8n: Create Workflow → menu „⋯” → Import from File → Save. Z kolei ostrzeżenia, które się pojawią po imporcie, to brakujące credentiale — zajmiemy się nimi za chwilę.

W workflow Initial Setup otwórz pierwszy węzeł (Set Testing Strategy Prompt File Name) i wklej ID folderu z Google Drive. Nazwę strategii testowania zostaw bez zmian — jeśli ją zmienisz, będziesz musiał poprawiać ją też w pozostałych workflowach.

Import workflow do n8n na wideo

Jak połączyć n8n z Google Drive, Docs i Sheets?

Przez credential Google OAuth2 (Select Credential → Create New Credential w węźle z ostrzeżeniem). Na n8n w chmurze klikasz tylko Sign in with Google — OAuth jest już skonfigurowany po stronie n8n.

Natomiast na n8n self-hosted trzeba najpierw założyć aplikację OAuth w Google Cloud. (Masz n8n w Dockerze? Sprawdź też, jak zaktualizować n8n w Dockerze.) Przejdź w tym celu przez sekcję o custom OAuth2 w dokumentacji n8n. Włącz Google Docs, Drive i Sheets API. Jako URI przekierowania wklej OAuth Redirect URL z okna credentiala w n8n.

Client ID i Client Secret zapisz w notatniku. Dzięki temu w kolejnych workflowach tylko je wkleisz, bez ruszania Google Cloud.

Integracja n8n z Google Suite na wideo

Co zrobić, gdy Google pokazuje „Access blocked”?

Dodaj swój adres e-mail do użytkowników testowych aplikacji — Google blokuje dostęp, bo aplikacja nie jest zweryfikowana. W Google Cloud: Odbiorcy → Użytkownicy testowi → Add users, potem w n8n ponownie Sign in with Google.

Co tworzy workflow Initial Setup?

Gdy wszystkie credentiale są podpięte, klikasz Execute Workflow, a w Twoim folderze na Drive pojawia się:

  • folder Test Cases — na razie pusty,
  • folder User Stories — z dwiema przykładowymi historyjkami: blokada konta po nieudanych logowaniach oraz zerowanie licznika po udanym logowaniu,
  • dokument TJB Testing Strategy — miejsce na Twoją strategię, np. tablice decyzyjne, wartości brzegowe albo same happy pathy.

Gotowa struktura na Drive na wideo

Jak n8n zapisuje test case’y do Google Sheets?

Z kolei za zapis odpowiada osobny workflow Write Test Cases to Google Sheets — generowanie i zapis są rozdzielone. Po imporcie ustaw w nim trzy węzły:

  • Search files and folders — credential powinien podpiąć się automatycznie,
  • Copy Template to Local Drive — w polu Parent Folder wybierz folder Test Cases,
  • Append Row in Sheet — utwórz nowy credential (ten sam Client ID i Secret z notatnika).

Workflow ma w sobie przykładowe dane, więc możesz go od razu sprawdzić. Po kliknięciu Execute Workflow w Test Cases powinien pojawić się arkusz z jednym test case’em. Następnie usuń ten plik.

Zapis test case’ów do Google Sheets na wideo

Jak AI generuje przypadki testowe z user story?

W workflow Generate Test Cases for Given User Story pracują po kolei dwa agenty AI. Najpierw pierwszy pisze przypadki testowe z user story, czyli nazwy i kroki. Potem drugi dopisuje oczekiwane rezultaty.

  • Test Cases Generation dostaje treść user story i strategię testowania. System prompt pilnuje, żeby odpowiedź miała ustaloną strukturę JSON: ID test case’u, nazwa, kroki.
  • Drugi agent na podstawie opisu historyjki i nazwy test case’u dopasowuje do każdego kroku oczekiwany wynik.
  • Węzeł Code na koniec składa z tego listę wszystkich test case’ów dla danej historyjki.
Workflow n8n generujący test case'y przez AI: Test Cases Generation, Setup expected results i węzeł JS — 3 wygenerowane przypadki

Ten workflow możesz też sprawdzić osobno. W tym celu otwórz węzeł When Executed by Another Workflow i kliknij ołówek. Następnie wpisz ID dokumentu TJB Testing Strategy i ID jednej z user stories. ID pliku to ciąg znaków w URL pomiędzy ukośnikami. W węźle Get Test Strategy Prompt credential powinien podpiąć się sam.

Generowanie test case’ów przez AI na wideo

Skąd wziąć darmowy klucz API do Google Gemini?

Z Google AI Studio. Wejdź na aistudio.google.com, przejdź do Get API Key → Create API Key → Create Key i skopiuj klucz. Potem w n8n w węźle Google Gemini Model utwórz nowy credential i wklej klucz w pole API Key. Zielony komunikat po zapisaniu oznacza, że połączenie działa.

Jeśli masz n8n w wersji 2.x i widzisz przycisk Publish — kliknij go. Bez tego workflow Main nie będzie mógł wywołać tego workflow.

Klucz API do Google Gemini na wideo

Jak spiąć wszystkie workflowy w jedno rozwiązanie?

Ostatni workflow, Main, czyta wszystkie historyjki z folderu User Stories i dla każdej wywołuje generowanie oraz zapis. Po imporcie zrób w nim trzy rzeczy:

  1. W węźle Mandatory Dir ID Setup wklej ID folderu User Stories i ID folderu Test Cases. Sprawdź też, czy nazwa strategii to nadal TJB Testing Strategy — jeśli zmieniałeś ją wcześniej, popraw tutaj.
  2. W węźle Search for Testing Strategy Prompt upewnij się, że credential się podpiął.
  3. Przepnij wywołania workflowów. Węzły Execute Workflow po imporcie wskazują na ID workflowów z mojego n8n. Jednak u Ciebie te workflowy mają inne ID. Dlatego w węźle Call Generate Test Cases wybierz z listy „Generate Test Cases for Given User Story”. W drugim węźle wybierz „Write Test Cases”. Jeśli na liście widzisz duplikat, wybierz właściwy i otwórz węzeł ponownie, żeby sprawdzić, czy został tylko jeden.

Na koniec zapisz, upewnij się, że folder Test Cases jest pusty, i kliknij Execute Workflow. Wynik: jeden arkusz na każdą historyjkę z folderu User Stories.

Folder Test Cases na Google Drive z dwoma arkuszami wygenerowanymi przez n8n — po jednym na user story

Finalny workflow na wideo

Dlaczego moje test case’y wyglądają inaczej niż w filmie?

Bo wyniki LLM-a są niedeterministyczne — ten sam setup może dać Ci zupełnie inne przypadki niż mnie. Workflow budowałem głównie na GPT-4o, a na potrzeby filmu dostosowałem go do Gemini 2.5 Flash. Dlatego z mocniejszym modelem, np. Gemini 2.5 Pro albo GPT-4o i lepszymi, najpewniej dostaniesz lepsze test case’y.

Co zrobić, gdy pojawia się błąd parsowania test case’ów?

Wtedy uruchom workflow ponownie albo przełącz go na mądrzejszy model. Błąd oznacza, że model nie trzymał się wymaganej struktury JSON — przy słabszych modelach zdarza się to co jakiś czas.

Podsumowanie

No i to by było na tyle! Raz konfigurujesz 4 workflowy i połączenie z Google. Od tego momentu przypadki testowe z user story generujesz jednym kliknięciem: wrzucasz historyjki do folderu, klikasz Execute Workflow i dostajesz arkusze gotowe do testów. O tym, czy dostaniesz jeden przypadek, czy dziesięć, decyduje wyłącznie Twoja strategia testowania.

Jeśli chcesz zobaczyć cały proces w praktyce — od pustego folderu na Drive po gotowe arkusze z test case’ami — sprawdź moje wideo na YouTube.

Ten generator to jeden z odcinków serii o n8n w pracy testera — znajdziesz w niej wszystko od pierwszego workflow po agentów AI.

Pozdrawiam!
Piotr

P.S. Daj znać w komentarzu, jak sprawdził się u Ciebie ten generator — i czy taka automatyzacja przyda Ci się w codziennej pracy?

				
					console.log( 'Code is Poetry' );