Powrót do: AI_Testers vol. 1 – Bonusy (aktywnie rozwijane)
Jak wykorzystać AI w Postmanie?
W tej lekcji zobaczysz, jak możesz wykorzystać AI w Postmanie podczas codziennej pracy z API. Nauczysz się, jak szybciej zrozumieć działanie endpointu, przygotować pierwszy szkic dokumentacji, debugować błędy oraz dodać proste testy bez pisania wszystkiego od zera.
Najważniejsze założenie: AI nie ma zastępować Twojego myślenia ani znajomości aplikacji. Ma pomóc Ci szybciej znaleźć punkt zaczepienia, uporządkować informacje i przejść do kolejnego kroku pracy.
Co możesz zrobić z AI w Postmanie?
1. Szybciej zrozumieć endpoint
Kiedy patrzysz na request i nie masz pewności, do czego służy, możesz zapytać AI o jego cel, parametry i potencjalne zastosowanie.
Przykład endpointu:
DELETE /assignments/{id}
Przykładowy prompt:
Explain what the purpose of this endpoint is.
Dzięki temu możesz szybciej zorientować się, co robi dany request i na co warto zwrócić uwagę. Pamiętaj jednak, że odpowiedź AI warto traktować jako pomoc, a nie ostateczne źródło prawdy.
2. Przygotować pierwszy szkic dokumentacji
Gdy już rozumiesz request, możesz użyć AI do uzupełnienia jego opisu w dokumentacji. Postman może wygenerować opis requestu, uwzględniając na przykład parametry, autoryzację, możliwe status kody i przykładowe użycie.
Przykładowy prompt:
Add documentation for this request. Don’t modify the request other than its description.
To dobry sposób, żeby nie zaczynać dokumentacji od pustej strony. Wygenerowany opis możesz później poprawić, doprecyzować i zweryfikować z rzeczywistym zachowaniem API.
3. Szybciej debugować błędy
Kiedy request zwraca błąd, możesz skorzystać z funkcji Debug with AI, żeby szybciej znaleźć możliwą przyczynę problemu.
Przykład z lekcji:
POST /animals
Po otrzymaniu błędu 400 Bad Request AI może przeanalizować request i zasugerować, czy problem leży na przykład w payloadzie, headerach, autoryzacji albo walidacji danych.
Największa korzyść polega na tym, że zamiast szukać problemu całkowicie po omacku, dostajesz konkretną hipotezę do sprawdzenia.
4. Dodać proste testy API
Możesz też poprosić AI o wygenerowanie podstawowych testów w Postmanie. To szczególnie przydatne, gdy chcesz szybko przejść od ręcznego klikania requestów do bardziej powtarzalnego testowania.
Przykładowy prompt:
Add three simple Postman tests for this endpoint. Keep them minimal and readable. Do not use try/catch unless really necessary. Focus on basic checks: status code, response time and one assertion on response body.
Taki prompt pomaga uzyskać prostszy i czytelniejszy kod. Wygenerowane testy możesz później rozbudować o konkretne pola odpowiedzi, properties albo bardziej biznesowe warunki.
Najważniejsze wnioski
Z pomocą AI w Postmanie możesz:
- szybciej zrozumieć działanie endpointu,
- przygotować pierwszy szkic dokumentacji,
- szybciej znaleźć przyczynę błędu,
- dodać podstawowe testy API,
- przejść do bardziej świadomego i powtarzalnego testowania.
Najlepsze efekty osiągniesz wtedy, gdy potraktujesz AI jako wsparcie w pracy, a nie zamiennik własnej analizy. Każdą ważną odpowiedź warto porównać z dokumentacją, kodem aplikacji i realnym zachowaniem API.
Dodatkowe wskazówki
Funkcje AI w Postmanie mogą korzystać z kredytów, więc warto używać ich świadomie — szczególnie na darmowym planie.
Im bardziej konkretny prompt, tym lepsza odpowiedź. Zamiast pisać tylko Fix this request, możesz doprecyzować, co AI ma sprawdzić: body, headery, autoryzację, walidację danych albo strukturę odpowiedzi.
Przy testach dobrze zaczynać od prostych asercji, a dopiero później dodawać bardziej szczegółowe scenariusze. Dzięki temu testy pozostają czytelne, łatwiejsze w utrzymaniu i bardziej przydatne w codziennej pracy.
Linki
- Repozytorium Rolnopol – Repozytorium przykładowej aplikacji używanej w materiałach do pracy z API.
- Oficjalna dokumentacja Postman Agent Mode – Przegląd funkcji Agent Mode i sposobu używania AI w Postmanie.
- Postman Agent Mode – Strona produktowa pokazująca możliwości Agent Mode i zastosowania AI w pracy z API.
- Postman AI Recipes – Zbiór gotowych workflow i promptów do pracy z AI w Postmanie.
- Debugowanie requestów w Postmanie – Dokumentacja pomagająca diagnozować błędy w requestach i odpowiedziach API.
- Pisanie testów w Postmanie – Wprowadzenie do tworzenia testów i skryptów walidujących odpowiedzi API.
- Zarządzanie kredytami AI w Postmanie – Informacje o wykorzystaniu kredytów i limitach związanych z funkcjami AI.
- Agent Mode Prompt Gallery – Gotowe szablony i pomysły na użycie AI w pracy z API.
- Testing APIs with Postman Agent Mode: A Practical Guide – Praktyczny artykuł pokazujący, jak wykorzystać Agent Mode przy testowaniu API.
