Aurora AIOpisz swój przypadek

Oferta

UsługiProduktyRealizacje

Dla kogo

Private EquityEnterpriseMŚP
UsługiProduktyRealizacjeO nasBlogKontakt

Baza wiedzy

Start tutajWikiSłownikPrzewodniki

Praca z Claude Baza wiedzy

Nie pytaj, czy skończył — każ agentowi udowodnić, że działa

Agent AI powie „gotowe”, nawet gdy praca jest zepsuta. Pokażę ci, jak zamiast pytać o opinię, kazać mu udowodnić, że efekt naprawdę działa.

Abstrakcyjny baner: pusta, wygaszona ramka statusu po lewej przechodzi w świecącą zielono ramkę z odhaczonym, zweryfikowanym wynikiem po prawej, do której spływają drobne kafelki dowodów i linie danych — dowód działania zamiast samej deklaracji „gotowe”.
Abstrakcyjny baner: pusta, wygaszona ramka statusu po lewej przechodzi w świecącą zielono ramkę z odhaczonym, zweryfikowanym wynikiem po prawej, do której spływają drobne kafelki dowodów i linie danych — dowód działania zamiast samej deklaracji „gotowe”.
Praca z Claude#claude-code #weryfikacja #agenci-ai #jakosc

Agent kończy pracę i melduje: „gotowe”. Otwierasz efekt — i się sypie. Strona nie ładuje połowy elementów, automatyzacja przepuszcza dziwne dane, diagram ma nachodzące na siebie podpisy. Model był przy tym zupełnie pewny siebie. I to jest pierwsza rzecz, którą musisz sobie ułożyć w głowie, jeśli zaczynasz pracować z agentami AI: „gotowe” nie znaczy „działa”.

Pokażę ci, dlaczego sama deklaracja agenta jest bezwartościowa, dlaczego zapytanie „czy to wygląda dobrze?” niczego nie wyłapie, i co zrobić zamiast tego — jak ustawić jeden mały mechanizm, dzięki któremu agent sam sprawdzi swoją pracę, zanim odda ci ją z powrotem.

„Gotowe” to nie dowód

Częsty błąd, który widzę u osób zaczynających z agentami: traktują słowo „gotowe” jak odbiór pracy. Agent napisał kod, wygenerował dokument, zbudował automatyzację — powiedział, że skończył, więc zakładasz, że skończył.

Tymczasem agent ocenia własną robotę, patrząc na to, co sam stworzył. To trochę tak, jakby uczeń sprawdzał własne wypracowanie, czytając je jeszcze raz — bez patrzenia, czy odpowiedzi są poprawne. Może mu się wydawać, że wszystko gra, bo myśli dokładnie tak, jak wtedy, gdy to pisał. Przeoczenie, które tam popełnił, popełni i przy sprawdzaniu.

Dlatego moim zdaniem weryfikacja sprowadza się do jednego zdania, które warto sobie powtarzać: udowodnij mi, że to naprawdę jest skończone i naprawdę działa. Nie „powiedz mi”. Nie „oceń sam”. Udowodnij — pokaż wynik, który widać.

Dlaczego pytanie „czy to dobre?” cię oszuka

Jest jeszcze druga, mniej oczywista pułapka. Modele językowe mają skłonność, którą nazywam byciem potakiwaczem — po angielsku mówi się o tym sycophancy. To znaczy, że model dopasowuje się do tego, co chcesz usłyszeć. Pytasz „zrobiłem to tak, dobrze wyszło?” — i z dużym prawdopodobieństwem usłyszysz „tak, świetnie”, bo model wyczuwa, że właśnie tej odpowiedzi oczekujesz.

Proszenie agenta o opinię to śliska droga. Im bardziej pytanie dotyczy oceny, gustu, „czy to jest dobre”, tym więcej w odpowiedzi jest przypochlebiania, a mniej prawdy.

I tu jest sedno: przy konkretnym sprawdzeniu nie ma miejsca na potakiwanie. Jeśli pytasz nie o opinię, tylko o fakt — czy strona się otwiera, czy automatyzacja poprawnie obsłużyła dane, czy w diagramie nic na siebie nie nachodzi — odpowiedź jest czarno-biała. Działa albo nie działa. Nie ma szarej strefy, w której model mógłby ci pochlebić.

To jest cała zmiana, której cię uczę. Przestań pytać „czy myślisz, że to dobre?”. Zacznij mówić „pokaż mi, że to działa”.

Daj agentowi obudowę, w której sam sprawdzi efekt

Skoro samo „gotowe” nie wystarczy, a o opinię pytać nie warto, potrzebujesz mechanizmu, który zmusza agenta do dostarczenia dowodu. W praktyce buduje się go raz, a potem działa przy każdym zadaniu. Nazwę go obudową.

W najprostszym ujęciu obudowa to to, co otacza sam model — narzędzia i kontekst, które pozwalają mu nie tylko myśleć, ale realnie coś zrobić i sprawdzić. Samo narzędzie AI, którego już używasz, jest taką obudową: pod spodem siedzi model językowy, a wokół niego — możliwość uruchamiania poleceń, otwierania plików, sięgania po dane. Na tym możesz dobudować własny, mały krok sprawdzający, dopasowany do tego, co konkretnie robisz. I tylko tyle musisz z tego zrozumieć — reszta to już techniczne szczegóły, w które nie ma sensu się tu zagłębiać.

Zasada, która sprawia, że to wszystko działa, jest prosta: każ agentowi sprawdzić efekt tak, jak zrobiłby to użytkownik. Patrzenie na własny kod albo na własny opis pracy to za mało — to wciąż tylko „przeczytanie wypracowania jeszcze raz”. Daj agentowi sposób, żeby naprawdę użył tego, co zbudował, i obejrzał wynik.

Abstrakcyjne ujęcie: zielony pierścień-kursor klika w świecącą, uproszczoną do bloków makietę gotowej strony i odkłada obok jej zrzut ekranu do obejrzenia — agent sprawdza efekt tak, jak zrobiłby to użytkownik, zamiast czytać własny kod.
Abstrakcyjne ujęcie: zielony pierścień-kursor klika w świecącą, uproszczoną do bloków makietę gotowej strony i odkłada obok jej zrzut ekranu do obejrzenia — agent sprawdza efekt tak, jak zrobiłby to użytkownik, zamiast czytać własny kod.

Dwa konkretne przykłady, jak ten mechanizm wygląda w praktyce:

  • Strona internetowa. Zamiast czytać kod strony, agent dostaje narzędzie, które otwiera ją w prawdziwej przeglądarce — dokładnie tak, jak zrobiłby to odwiedzający. Klika się przez nią, robi zrzuty ekranu i na nich sprawdza, czy wszystko wygląda i działa, jak powinno. Jeśli coś jest nie tak, poprawia i sprawdza ponownie.
  • Diagram albo grafika. Agent nie ogląda samego „przepisu” na obrazek. Renderuje go do prawdziwego pliku graficznego, a potem patrzy na ten obraz — i wyłapuje to, czego z opisu nie widać: nachodzące na siebie podpisy, złe odstępy, bałagan w układzie. Poprawia, renderuje jeszcze raz i ogląda powtórnie.

W obu wypadkach kluczowe jest to samo: agent używa efektu i patrzy na wynik, a nie zapewnia, że wszystko jest w porządku.

Pierwsze podejście nie musi być idealne

Tu zaczyna się część, którą wiele osób rozumie opacznie. Nie chodzi o to, żeby agent zrobił wszystko bezbłędnie za pierwszym razem — to się prawie nigdy nie zdarza. Pierwsza wersja diagramu miała nachodzące podpisy, pierwsza wersja strony coś gubiła. To normalne.

Wczesne, niechlujne podejścia nie mają znaczenia. Liczy się tylko jedno: czy agent potrafi sam poprawić swoją pracę aż do czystego efektu — bez twojego udziału na każdym kroku i bez przepalania absurdalnej ilości pracy na drodze. To, co finalnie ci oddaje, jest tym, co się liczy.

I właśnie po to jest obudowa. Bez tego kroku sprawdzającego pierwsza wersja bywa tylko z grubsza dobra — wygląda sensownie, ale w paru miejscach się sypie. Z nim to, co dostajesz na pierwszy rzut, jest znacznie bliżej działającego, bo agent sam przeszedł kilka rund poprawek, zanim w ogóle pokazał ci wynik.

Zdefiniuj „skończone”, zanim agent zacznie

Jest jeden warunek, bez którego cała weryfikacja nie ruszy: agent musi wiedzieć z góry, jak ma ci udowodnić, że skończył. Sprawdzanie działa tylko dlatego, że jeszcze przed startem powiedziałeś mu dokładnie, co będzie dowodem ukończenia.

Dobrze widać to w całym łuku pracy z agentem: najpierw planujesz, potem oddajesz budowę agentowi, a na końcu weryfikujesz. Ten artykuł jest o tej ostatniej części — ale to, czy ona zadziała, ustalasz już na początku, w planie. Definicja „skończonego” — jak konkretnie agent pokaże ci, że praca jest gotowa i działa — należy do planu, nie do improwizacji na końcu. (Samego planowania uczę osobno; tu wystarczy wiedzieć, że weryfikacja bez wcześniejszej definicji jest ślepa.)

Zaczynasz więc od spisania, co właściwie budujesz i jak będzie wyglądał dowód, że to działa. Dopiero wtedy oddajesz robotę agentowi — bo zarówno ty, jak i on wiecie, na czym ma polegać sprawdzenie.

Pytaj „co może pójść nie tak?”

Na koniec pokażę ci pytanie, które jest zaskakująco rzadko zadawane, a moim zdaniem należy do najbardziej wartościowych w całej tej pracy: co może się tu zepsuć?

Część osób boi się je zadać — jakby szukanie dziur we własnej robocie było przyznaniem się do błędu. A jest dokładnie odwrotnie. To pytanie warto wbudować na stałe w krok sprawdzający. Gdy agent skończy, każesz mu zapytać samego siebie: co może tu pójść nie tak? Gdzie ten efekt się posypie?

Szczególnie warto polować na przypadki brzegowe — czyli rzadkie, nietypowe sytuacje, na których rzeczy się sypią. Wyobraź sobie automatyzację, która przyjmuje jakieś dane. Pytasz: a co, jeśli ktoś poda dane w dziwnym, niepoprawnym formacie? Wtedy projektujesz mały test, który celowo próbuje to zepsuć — podajesz właśnie takie pokraczne wejście i patrzysz, co się stanie.

Abstrakcyjne ujęcie: w uporządkowany, zielony strumień danych wstrzyknięto jeden zniekształcony, bordowy element, który na bramce weryfikacji wywołuje kontrolowane pęknięcie z bursztynowym sygnałem ostrzegawczym — celowy test brzegowy, który próbuje zepsuć efekt i wyłapuje usterkę.
Abstrakcyjne ujęcie: w uporządkowany, zielony strumień danych wstrzyknięto jeden zniekształcony, bordowy element, który na bramce weryfikacji wywołuje kontrolowane pęknięcie z bursztynowym sygnałem ostrzegawczym — celowy test brzegowy, który próbuje zepsuć efekt i wyłapuje usterkę.

A jeśli się zepsuło — i to jest punkt, o którym łatwo zapomnieć — poprawiasz i sprawdzasz jeszcze raz tym samym testem. Bo twoja poprawka wcale nie musiała naprawić problemu. Znalazłeś usterkę, naprawiłeś, ponownie przetestowałeś. Dopiero wtedy wiesz, że naprawdę jest dobrze.

To zamyka pętlę. Definiujesz z góry, co znaczy „skończone”. Dajesz agentowi sposób, żeby użył efektu tak jak użytkownik. Każesz mu zapytać, co może się zepsuć, i spróbować to zepsuć. A gdy coś pęka — poprawia i testuje od nowa, aż przejdzie.

Tyle wystarczy, żeby to, co agent oddaje na pierwszy rzut, przestało być „wygląda sensownie, ale się sypie”, a stało się „naprawdę działa”. Nie pytaj, czy skończył — każ udowodnić, że działa. A następnym razem, zanim oddasz agentowi jakiekolwiek zadanie, zacznij od jednego zdania: jak konkretnie pokażesz mi, że to działa?

Jak agent dowodzi, że praca działaCztery kroki, którymi agent dowodzi, że praca działa: ustalasz „skończone”, dajesz obudowę, każesz szukać przypadków brzegowych i testujesz po poprawce.Jak agent dowodzi, że praca działaZdefiniuj „skończone”Ustalasz w planie, jak agent ma udowodnić, że praca działaDaj agentowi obudowęNiech użyje efektu tak jak użytkownik: otworzy stronę, wyrenderuje obrazekZapytaj, co się zepsujePrzypadki brzegowe: test, który celowo podaje pokraczne danePopraw i przetestuj znówTym samym testem, bo poprawka nie musiała naprawić problemu
Jak agent dowodzi, że praca działaCztery kroki, którymi agent dowodzi, że praca działa: ustalasz „skończone”, dajesz obudowę, każesz szukać przypadków brzegowych i testujesz po poprawce.Jak agent dowodzi, że praca działaZdefiniuj „skończone”Ustalasz w planie, jak agent ma udowodnić, żepraca działaDaj agentowi obudowęNiech użyje efektu tak jak użytkownik:otworzy stronę, wyrenderuje obrazekZapytaj, co się zepsujePrzypadki brzegowe: test, który celowo podajepokraczne danePopraw i przetestuj znówTym samym testem, bo poprawka nie musiałanaprawić problemu
Cztery kroki, którymi agent dowodzi, że praca działa: ustalasz „skończone”, dajesz obudowę, każesz szukać przypadków brzegowych i testujesz po poprawce.

Sprawdź się

Cztery pytania, żeby sprawdzić, ile zostało z lektury.

  1. Dlaczego «gotowe» od agenta to jeszcze nie dowód, że praca jest skończona?

  2. Dlaczego pytanie «czy to dobrze wyszło?» zwykle cię nie ostrzeże przed usterką?

  3. Na czym polega zasada, dzięki której obudowa (krok sprawdzający) naprawdę działa?

  4. Kiedy — według tekstu — trzeba ustalić, co znaczy «skończone»?