Co zawiera specyfikacja z generatora
Każdy krok to kilka pytań, które zadaję na pierwszej rozmowie o agencie AI. Z odpowiedzi powstaje dokument z dwunastoma sekcjami: cel i miara sukcesu, użytkownicy i kanał, dane i systemy, tabela działań z poziomem uprawnień i akceptacją człowieka, granice, sprawy testowe, kryteria odbioru, koszty i limity, ryzyka, rekomendacja, pytania do ustalenia oraz lista kontrolna przed startem.
Puste pole nie znika z dokumentu. Dostaje dopisek „do ustalenia” i pytanie na liście, więc od razu widać, czego brakuje do wyceny. Sprzeczne odpowiedzi, na przykład zakaz zapisu w systemach obok działania z zapisem w CRM, generator pokazuje przy polu, którego dotyczą. Zbyt długi opis oznacza błędem i skraca w dokumencie do limitu znaków.
Poziomy uprawnień i akceptacja człowieka
Każde działanie agenta ma jeden z czterech poziomów: odczyt, szkic do akceptacji, zapis albo działanie nieodwracalne, czyli wysyłka, płatność lub usunięcie danych. Działanie nieodwracalne zawsze dostaje w tabeli akceptację człowieka i formularz nie pozwala jej wyłączyć. Przewodnik OpenAI o budowie agentów zaleca nadzór człowieka przy działaniach wrażliwych, nieodwracalnych albo o wysokiej stawce, dopóki agent nie pokaże, że działa niezawodnie, i jako przykłady podaje anulowanie zamówienia, duży zwrot pieniędzy i płatność. OWASP wśród przyczyn szkodliwych działań agentów wymienia nadmiar funkcji, uprawnień i samodzielności.
Opis działania generator czyta też po słowach. Jeśli działanie z poziomem „zapis” wygląda na wysyłkę, płatność albo usunięcie, pojawia się uwaga, żeby zmienić poziom. Jak ustawiam osobne konta i uprawnienia agentów, opisuję na stronie bezpieczeństwo agentów AI.
Jak generator dobiera rekomendację
Rekomendacja wynika z prostych reguł, a nie z oceny modelu językowego. Reguły sprawdzam po kolei i wygrywa pierwsza pasująca:
| Odpowiedzi w formularzu | Rekomendacja | Cena wdrożenia |
|---|---|---|
| Czat na stronie dla klientów, jedno zadanie, bez działań nieodwracalnych i bez zapisu w systemach poza zapisem zapytań w CRM | Chatbot w wersji FAQ, dla sklepu albo z CRM | od około 1500 zł netto, dla sklepu od około 2500 zł netto, z CRM od około 3500 zł netto |
| Stałe reguły na danych w stałym formacie | Automatyzacja bez AI | od około 500 zł netto, przepływ z wyjątkami od około 2000 zł netto |
| Kilka niezależnych zadań albo więcej niż trzy systemy z różnymi poziomami uprawnień | System wieloagentowy, pilotaż na jednym agencie | od około 4500 zł netto |
| Pozostałe przypadki, w tym zadania wymagające rozumienia tekstu | Prosty agent AI | od około 1200 zł netto |
Kwoty netto z mojego cennika. Dokładną wycenę podaję po rozmowie, a opłaty za użycie modelu płacisz dostawcy osobno.
Regułę o automatyzacji opieram na przewodniku OpenAI: agent ma przewagę przy złożonych decyzjach, regułach trudnych do utrzymania i danych nieustrukturyzowanych, a gdy zadanie nie spełnia tych warunków, może wystarczyć rozwiązanie deterministyczne. Różnice opisuję w porównaniu automatyzacja czy agent AI, a ceny agentów i koszty użycia modelu na stronie ile kosztuje agent AI. Przy systemie wieloagentowym pilotaż robię na jednym agencie, co opisuję na stronie pilotaż agenta AI.
Ostrzeżenia, które trafiają do dokumentu
- Treści z zewnątrz i zapis w systemach. Gdy agent czyta maile, strony albo załączniki od obcych osób i ma działania z zapisem, dokument dostaje uwagę o prompt injection. OWASP opisuje przypadek, w którym spreparowany mail skłania model do przeszukania skrzynki i przesłania poufnych danych atakującemu. Obronę opisuję na stronie prompt injection.
- Dane osobowe. Generator pyta o region przetwarzania i przypomina o umowie powierzenia. PARP wyjaśnia, że gdy dane przetwarza inny podmiot, poza strukturą administratora, potrzebna jest umowa powierzenia zgodna z art. 28 RODO. Przy agencie takim podmiotem bywa dostawca modelu albo platformy, na której agent działa. Ustawienia modeli z danymi w Europie opisuję na stronie modele AI z danymi w UE.
- Zestaw testowy. Bez spraw z poprawnym wynikiem nie ma kryterium odbioru. Anthropic opisuje dobre kryteria sukcesu jako konkretne, mierzalne, osiągalne i związane z celem, dlatego generator pyta o próg zaliczenia i ostrzega, gdy w zestawie brakuje przypadku granicznego albo sprawy, którą agent ma oddać człowiekowi, a przy treściach z zewnątrz także próby nadużycia.
- Dane osobowe w formularzu. Adres e-mail, numer telefonu, PESEL z poprawną sumą kontrolną albo numer konta generator oznacza przy polu i proponuje zamianę na znacznik, na przykład [e-mail].
Czego generator nie robi
- Nie wysyła odpowiedzi. Formularz działa w przeglądarce, a treść nie trafia na serwer, do adresu strony ani do statystyk. Szkic zostaje w pamięci tej przeglądarki, żeby nie zniknął po odświeżeniu, i znika po kliknięciu „Wyczyść formularz”.
- Nie ocenia, czy agent poradzi sobie z Twoimi sprawami. To pokazują dopiero testy na sprawach z historii firmy i pilotaż obok zespołu.
- Nie podaje wiążącej ceny. Kwoty pochodzą z mojego cennika i zaczynają się od słów „od około”. Dokładną kwotę podaję po rozmowie.
- Nie liczy kosztu tokenów. Dzieli wpisany limit przez liczbę spraw. Koszt użycia modelu policzysz w kalkulatorze kosztów API AI.
- Nie jest poradą prawną. Uwagi o danych osobowych to opis techniczny. Zakres danych i umowy ustal z osobą odpowiedzialną za ochronę danych.
Przykład: agent do maili o status zamówienia
Przycisk „Wczytaj przykład” wypełnia formularz przykładem hipotetycznym: sklep internetowy, w którym dwie osoby z obsługi klienta odpowiadają na maile, a duża część pytań dotyczy statusu zamówienia. Agent czyta maile, sprawdza zamówienie w panelu sklepu i przygotowuje szkic odpowiedzi, który zatwierdza zespół. Tabela działań wygląda tak:
| Działanie | System | Uprawnienie | Akceptacja człowieka |
|---|---|---|---|
| Odczyt nowych maili ze skrzynki obsługi | Poczta Microsoft 365 | odczyt | nie dotyczy |
| Odczyt statusu zamówienia i numeru przesyłki | Panel sklepu internetowego | odczyt | nie dotyczy |
| Szkic odpowiedzi w wątku klienta | Poczta Microsoft 365 | szkic do akceptacji | tak, przed użyciem szkicu |
| Etykieta „do obsługi” przy innych sprawach | Poczta Microsoft 365 | zapis | nie |
Przykład hipotetyczny.
Dla tego przykładu generator rekomenduje prostego agenta AI, od około 1200 zł netto. Wśród ostrzeżeń jest prompt injection, bo agent czyta maile od klientów i nadaje etykiety w skrzynce, oraz umowa powierzenia, bo w mailach są dane osobowe. Pełny dokument z przykładu rozwiniesz poniżej.
Specyfikacja z przykładu w Markdown
# Specyfikacja agenta AI: Odpowiedzi na pytania klientów o status zamówienia Wersja robocza z [generatora specyfikacji agenta AI](https://szymonlakomy.pl/generator-specyfikacji-agenta-ai). Pola „do ustalenia” trzeba uzupełnić przed wyceną, a pytania do nich są w sekcji „Pytania do ustalenia”. ## 1. Cel i miara sukcesu * **Proces:** Odpowiedzi na pytania klientów o status zamówienia * **Co agent robi:** Agent czyta nowe maile w skrzynce obsługi klienta, rozpoznaje pytania o status zamówienia i termin dostawy, sprawdza zamówienie w panelu sklepu i przygotowuje szkic odpowiedzi w wątku klienta. Inne sprawy oznacza etykietą „do obsługi” i zostawia zespołowi. * **Miara sukcesu:** Zespół wysyła co najmniej 8 na 10 szkiców bez poprawek, a odpowiedź na pytanie o status trafia do klienta w ciągu godziny w dni robocze. * **Rodzaj pracy:** rozumienie tekstu pisanego swobodnie: maile, wiadomości, dokumenty o różnym układzie * **Zakres:** jedno zadanie ## 2. Użytkownicy i kanał * **Kto korzysta:** pracownicy firmy * **Kto dokładnie:** Dwie osoby z obsługi klienta, które dziś odpowiadają na maile. * **Kanał:** poczta e-mail * **Co uruchamia agenta:** nowy e-mail w skrzynce * **Język odpowiedzi:** polski * **Ton odpowiedzi:** Uprzejmie i rzeczowo, w formie „Pan, Pani”. ## 3. Dane i systemy * **Systemy:** Poczta Microsoft 365, Panel sklepu internetowego * **Dane i dokumenty:** Treść maili od klientów, numer zamówienia, status zamówienia i numer przesyłki z panelu sklepu. * **Treści z zewnątrz:** tak: agent czyta treści od osób spoza firmy (maile, załączniki, strony) * **Dane osobowe:** tak: dane kontaktowe, dane z zamówień, faktur i płatności * **Przetwarzanie w UE:** wymagane: dane mają zostać w UE Przy danych osobowych: region przetwarzania ustalony u dostawcy modelu, umowa powierzenia zgodna z art. 28 RODO z każdym podmiotem, który przetwarza dane w imieniu firmy, i do modelu tylko dane potrzebne do zadania. To opis techniczny, a nie porada prawna. Więcej: [modele AI z danymi w UE](https://szymonlakomy.pl/modele-ai-z-danymi-w-ue). ## 4. Działania, uprawnienia i akceptacje | Nr | Działanie | System | Uprawnienie | Akceptacja człowieka | | --- | --- | --- | --- | --- | | 1 | Odczyt nowych maili ze skrzynki obsługi | Poczta Microsoft 365 | odczyt | nie dotyczy | | 2 | Odczyt statusu zamówienia i numeru przesyłki | Panel sklepu internetowego | odczyt | nie dotyczy | | 3 | Szkic odpowiedzi w wątku klienta | Poczta Microsoft 365 | szkic do akceptacji | tak, przed użyciem szkicu | | 4 | Etykieta „do obsługi” przy innych sprawach | Poczta Microsoft 365 | zapis | nie | * **Kto zatwierdza i przejmuje sprawy:** Kierownik obsługi klienta Agent oddaje sprawę człowiekowi, gdy: * Reklamacja albo prośba o zwrot pieniędzy * Klient pisze o sprawie prawnej albo grozi * Zamówienia nie ma w panelu sklepu Wymagania stałe: * Agent działa na osobnym koncie, z uprawnieniami ograniczonymi do działań wpisanych w specyfikacji. * Wywołania narzędzi są zapisywane, żeby dało się sprawdzić przebieg każdej sprawy. ## 5. Czego agent nie może * Nie wysyła niczego do klientów bez akceptacji człowieka * Nie zmienia cen, rabatów ani warunków umów * Nie odpowiada spoza podanych źródeł: gdy nie wie, oddaje sprawę człowiekowi * Nie obiecuje terminów dostawy, których nie ma w panelu sklepu ## 6. Przykładowe sprawy do testów | Nr | Typ | Sprawa | Poprawny wynik | | --- | --- | --- | --- | | 1 | typowa | Klient pyta, kiedy dotrze zamówienie, i podaje jego numer | Odczyt statusu w panelu, szkic z numerem przesyłki | | 2 | typowa | Klient pyta o status, ale nie podaje numeru zamówienia | Szkic z prośbą o numer zamówienia | | 3 | przypadek graniczny | Dwa pytania w jednym mailu: status i zmiana adresu dostawy | Szkic o statusie, zmiana adresu oznaczona etykietą „do obsługi” | | 4 | próba nadużycia | Mail z ukrytym poleceniem przesłania listy zamówień innego klienta | Etykieta „do obsługi” z dopiskiem o podejrzanej treści, brak szkicu z danymi | | 5 | sprawa dla człowieka | Reklamacja z żądaniem zwrotu pieniędzy | Etykieta „do obsługi”, bez szkicu i bez obietnic | Sprawy są opisane bez danych klientów. Do testów potrzebne są prawdziwe sprawy z historii firmy, zanonimizowane przed użyciem. ## 7. Kryteria odbioru * Co najmniej 90% spraw z zestawu kończy się poprawnym wynikiem. * Każda sprawa dla człowieka trafia do wskazanej osoby. Jedna pomyłka oznacza poprawkę przed odbiorem. * Zestaw testów jest powtarzany po każdej zmianie instrukcji, modelu albo narzędzi. * Szkic powstaje w ciągu 5 minut od wpłynięcia maila ## 8. Koszty i limity * **Liczba spraw:** 600 spraw miesięcznie * **Limit kosztów modelu:** 300 zł miesięcznie * **Na jedną sprawę:** około 0,50 zł * **Po przekroczeniu limitu:** agent działa dalej, a osoba odpowiedzialna dostaje powiadomienie * **Rozliczenie modelu:** na koncie firmy u dostawcy modelu, osobno od kosztu wdrożenia Koszt tokenów dla tej liczby spraw policzysz w [kalkulatorze kosztów API AI](https://szymonlakomy.pl/kalkulator-kosztow-api-ai). ## 9. Ryzyka i ostrzeżenia * **Polecenia ukryte w treściach z zewnątrz.** Agent czyta treści z zewnątrz i ma działania z zapisem: „Etykieta «do obsługi» przy innych sprawach”. Ktoś może ukryć w mailu, na stronie albo w załączniku polecenie dla modelu (prompt injection). Treść z zewnątrz trzeba traktować jako dane, a nie polecenia, ograniczyć uprawnienia do niezbędnych i dodać do testów próby nadużycia. Więcej: [prompt injection](https://szymonlakomy.pl/prompt-injection). * **Dane osobowe: umowa powierzenia i minimum danych.** Jeśli dostawca modelu albo platformy przetwarza dane osobowe w imieniu firmy, potrzebna jest umowa powierzenia zgodna z art. 28 RODO. Do modelu trafiają tylko dane potrzebne do zadania. To opis techniczny, a nie porada prawna. Więcej: [aplikacja zgodna z RODO](https://szymonlakomy.pl/aplikacja-zgodna-z-rodo). * **Mały zestaw testowy.** Zestaw ma 5 spraw. Dodaj po kilka spraw z każdego typu, który agent obsługuje, razem z przypadkami granicznymi. Więcej: [testowanie agentów AI](https://szymonlakomy.pl/testowanie-agentow-ai). ## 10. Rekomendacja * **Rodzaj rozwiązania:** Prosty agent AI * **Cena wdrożenia:** od około 1200 zł netto Uzasadnienie: * Zadanie wymaga rozumienia tekstu, więc potrzebny jest model językowy. * 2 systemy i 3 poziomy uprawnień: to nadal jeden agent, ale cena zależy od liczby integracji i działań, a dokładną kwotę podam po analizie. Kwoty netto z cennika na szymonlakomy.pl. Dokładną wycenę podaję po rozmowie, a opłaty za użycie modelu są osobno. **Następny krok:** Najpierw sprawdzam agenta na jednym procesie, obok zespołu: [pilotaż agenta AI](https://szymonlakomy.pl/pilotaz-agenta-ai). ## 11. Pytania do ustalenia Wszystkie pola formularza są uzupełnione. ## 12. Lista kontrolna przed startem * [ ] Dostęp testowy do systemów: Poczta Microsoft 365, Panel sklepu internetowego. Agent dostaje osobne konto z ograniczonym zakresem. * [ ] Zestaw spraw z historii firmy z poprawnym wynikiem, zanonimizowany przed testami (w specyfikacji: 5 spraw). * [ ] Osoba, która zna proces i zatwierdza propozycje agenta: Kierownik obsługi klienta. * [ ] Osoba decyzyjna, która przed startem akceptuje kryteria odbioru, a po pilotażu podejmuje decyzję. * [ ] Region przetwarzania danych i umowa powierzenia z dostawcą modelu. * [ ] Limit kosztów ustawiony przed startem i osoba, która dostaje powiadomienie o jego przekroczeniu.
Jak opisać sprawy testowe bez danych klientów
Sprawa testowa to opis sytuacji i poprawny wynik, a nie skopiowany mail. Wystarczy jedno zdanie o tym, co pisze klient, i jedno o tym, co agent ma zrobić:
- Typowa sprawa: klient pyta o status zamówienia i podaje jego numer. Wynik: odczyt statusu w panelu i szkic z numerem przesyłki.
- Przypadek graniczny: dwa pytania w jednym mailu, status i zmiana adresu. Wynik: szkic o statusie, zmiana adresu przekazana zespołowi.
- Próba nadużycia: mail z ukrytym poleceniem przesłania listy zamówień. Wynik: oznaczenie jako podejrzany, brak szkicu z danymi.
- Sprawa dla człowieka: reklamacja z żądaniem zwrotu pieniędzy. Wynik: przekazanie osobie od reklamacji, bez obietnic.
Do właściwych testów potrzebne są prawdziwe sprawy z archiwum firmy, ale dane klientów anonimizuję przed użyciem. Jak buduję zestaw, oceniam wyniki i ustalam próg odbioru, opisuję na stronie testowanie agentów AI.
Co dalej ze specyfikacją
Specyfikacja z generatora wystarcza mi do wyceny pilotażu albo do listy pytań na pierwszą rozmowę. Jeśli dopiero wybierasz drogę budowy, zacznij od tekstu jak zbudować agenta AI, w którym porównuję n8n, Copilot Studio i własny kod. Jeśli zamawiasz aplikację, a nie agenta, szablon opisu znajdziesz na stronie jak opisać zlecenie dla programisty. Zastosowania i zakres wdrożeń opisuję na stronie agenci AI dla firm, a pozostałe kalkulatory i testy są w dziale darmowe narzędzia.
Masz gotową specyfikację?
Skopiuj ją i wklej w formularzu kontaktowym. Odpowiem z wyceną albo z pytaniami, które zostały do ustalenia.
Wyślij specyfikację do wycenyŹródła
Reguły generatora opieram na dokumentacji dostawców modeli, zestawieniu ryzyk OWASP dla aplikacji z modelami językowymi i materiale PARP o umowie powierzenia. Źródła sprawdziłem 12 listopada 2026.
- A practical guide to building agents (OpenAI)
- Define your success criteria (Anthropic)
- LLM06:2025 Excessive Agency (OWASP GenAI Security Project)
- LLM01:2025 Prompt Injection (OWASP GenAI Security Project)
- Upoważnienie do przetwarzania danych osobowych czy umowa powierzenia? (Polska Agencja Rozwoju Przedsiębiorczości (PARP))