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

Jak napisać brief, który agent AI wykona bez ciebie

Autonomiczny agent kończy zadanie bez ciebie tylko wtedy, gdy dostanie dobry brief: misję, bariery, fazy, rezultaty i sprawdzalną definicję „gotowe”.

Pojedyncza kartka-instrukcja rozwija się w uporządkowaną, samodzielnie płynącą sieć świetlnych węzłów; grafitowe tło, chłodny błękit przechodzący w zieleń.
Pojedyncza kartka-instrukcja rozwija się w uporządkowaną, samodzielnie płynącą sieć świetlnych węzłów; grafitowe tło, chłodny błękit przechodzący w zieleń.
Praca z Claude#agenci-ai #autonomia #brief #definicja-gotowe #orkiestracja

Możesz dać agentowi jeden duży, rozmyty cel, wyjść z pokoju i wrócić do skończonego pakietu. Brzmi jak obietnica ze slajdu sprzedażowego, a mimo to potrafi się udać. Tyle że nie dzięki modelowi i nie dzięki jednemu sprytnie napisanemu zdaniu. Decyduje brief, który wręczasz agentowi, zanim odejdziesz.

To, o czym mówię, to agent autonomiczny: program oparty na modelu językowym, który nie tylko odpowiada na pytania, ale sam planuje kroki, wykonuje je i sprawdza własną pracę. Brief to spisana dla niego instrukcja: co ma powstać, w jakich granicach i po czym pozna, że skończył. Częsty błąd, który widzę, jest prosty. Ludzie piszą życzenie („zbuduj mi X”), a potem dziwią się, że i tak muszą stać nad ekranem. Pokażę ci, czym życzenie różni się od uruchomienia, po którym da się naprawdę odejść.

Żeby było konkretnie: dobrze poprowadzony agent potrafi przejść od problemu, który ludzie opisują na forach i w otwartym internecie, aż po gotowy pakiet startowy. Nazwę i identyfikację wizualną, stronę, działający prototyp produktu, plan biznesowy i krótkie materiały wprowadzające. Bez twojej obecności w międzyczasie. To nie znaczy, że wynik jest od razu doskonały. Znaczy, że praca dojechała do końca sama, a ty oceniasz gotowy rezultat, zamiast prowadzić agenta za rękę na każdym kroku.

Anatomia briefu autonomicznego

Tu jest sedno całej rzeczy, więc rozłożę brief na części. Każdej z nich brakuje w typowym poleceniu, a brak każdej z osobna potrafi zatrzymać agenta w pół drogi.

Misja. Zacznij od celu opisanego jako wynik, nie jako lista czynności. Zamiast „przeszukaj internet i zrób research rynku” napisz: „znajdź prawdziwy, bolesny problem, na który ludzie narzekają teraz, i zaprojektuj wokół niego biznes, który mógłbym wprowadzić na rynek w tym miesiącu”. Jedno, dwa zdania. Do tego dodaj szczerą swobodę twórczą: chcę twojej najlepszej pracy, nie najbezpieczniejszej. To brzmi miękko, a robi konkretną rzecz. Zdejmuje z agenta odruch dowożenia absolutnego minimum i pozwala mu zaproponować coś, na co sam byś nie wpadł. Różnica jest praktyczna. Lista czynności przywiązuje agenta do twojego wyobrażenia o tym, jak dojść do celu, choć to on ma więcej cierpliwości, żeby sprawdzić każdą ścieżkę. Opis wyniku zostawia jemu wybór drogi, a tobie to, na czym naprawdę ci zależy.

Bariery. Bariery to twarde granice, dzięki którym odejście od ekranu jest bezpieczne. Trzy ustawiam zawsze: nie wydawaj pieniędzy; niczego nie publikuj, buduj wyłącznie lokalnie; niczego nie zmyślaj, sprawdzaj każdy fakt i każdą liczbę u źródła. Z barierami wiąże się zasada najmniejszego dostępu: dajesz agentowi tylko te klucze i uprawnienia, których naprawdę potrzebuje do zadania, i ani jednego więcej. Im węższy dostęp, tym spokojniej można zostawić go samego, bo lista rzeczy, które mógłby zepsuć, jest krótka i znana z góry.

Fazy. Rozpisz pracę na uporządkowany ciąg etapów: znajdź problem, wybierz najlepszy, zaprojektuj rozwiązanie, zbuduj je, spróbuj je obalić, spakuj wynik. Na końcu tej listy dopisz jedno zdanie, które zmienia wszystko: to podłoga, nie sufit. Agent może zrobić więcej, jeśli uzna to za potrzebne, ale nigdy mniej. Bez tego zastrzeżenia model albo trzyma się listy zbyt kurczowo i pomija oczywiste dodatkowe kroki, albo bierze ją za pełen zakres i odpuszcza wszystko poza nią. Zwróć uwagę na przedostatni etap, czyli próbę obalenia własnej pracy. Łatwo go pominąć, bo każdy woli budować niż podważać to, co zbudował. A to właśnie on wyłapuje słabe założenia, zanim zdążą kosztować.

Rezultaty. Wymień konkretne artefakty, których oczekujesz z powrotem: stronę, działający produkt, plan, krótkie materiały wprowadzające, jedno podsumowanie spinające całość. Jeśli ich nie nazwiesz, agent zgadnie, co miałeś na myśli. A zgadywanie to dokładnie to miejsce, w którym jego wynik rozjeżdża się z obrazem, który masz w głowie. Poproś zwłaszcza o jedno spinające podsumowanie. Od niego zaczniesz przegląd całości, bo to pierwsza rzecz, którą sam otworzysz, i to na nim opiera się definicja „gotowe”.

Definicja „gotowe”. To najważniejsza część całego briefu, a zarazem ta pomijana najczęściej. Definicja „gotowe” to obiektywny, sprawdzalny próg odbioru — taki, który potwierdzi ktoś z zewnątrz, bez pytania cię o zdanie. Dobra brzmi mniej więcej tak: obcy człowiek otwiera jedno podsumowanie, rozumie, o co chodzi w projekcie, uruchamia to, co powstało, i widzi działające demo. Zwróć uwagę, że nic tu nie zależy od twojego nastroju ani od tego, czy akurat się podoba. Bez takiego progu agent nigdy nie wie, kiedy przestać. A to znaczy, że albo skończy za wcześnie, albo będzie cyzelował bez końca. Porównaj dwie wersje. Zdanie „ma być profesjonalnie” nie mówi nic, bo to znów twoja opinia przebrana za kryterium. Zdanie „ktoś, kto nie zna projektu, uruchamia go w kilka minut i widzi, że działa” mówi wszystko, bo da się je sprawdzić bez ciebie. Cała sztuka polega na zejściu z poziomu życzenia na poziom testu.

Zasada „nie pytaj”. Na koniec jedno zdanie, które zamienia rozmowę w samodzielne uruchomienie: podejmuj każdą decyzję sam, zapisz, dlaczego ją podjąłeś, i nie wracaj do mnie, dopóki nie spełnisz definicji „gotowe”. Uważaj z tym, bo to zdanie bywa nadużywane. Prawo do niepytania nie jest darmowe. Agent zasługuje na nie dopiero wtedy, gdy dałeś mu bariery i sprawdzalny próg odbioru. Bez nich po prostu prosisz go, żeby zgadywał, tyle że w milczeniu. Prośba o zapisywanie decyzji też nie jest ozdobnikiem. Kiedy wrócisz do gotowej pracy, chcesz móc prześledzić, dlaczego agent poszedł tą, a nie inną drogą, bo inaczej dostajesz wynik bez uzasadnienia i nie wiesz, na czym się oprzeć.

Abstrakcyjny przekrój dokumentu rozłożonego na warstwy: cel u góry, ramy po bokach, uporządkowany ciąg etapów w środku, wyraźna linia odbioru u dołu; grafit, błękit i zieleń.
Abstrakcyjny przekrój dokumentu rozłożonego na warstwy: cel u góry, ramy po bokach, uporządkowany ciąg etapów w środku, wyraźna linia odbioru u dołu; grafit, błękit i zieleń.

Orkiestracja: powiedz, jak pracować, nie co klikać

Dobry brief mówi też, w jaki sposób agent ma się zabrać do roboty — ale na poziomie wzorców, nie kliknięć. To się nazywa orkiestracja agentów: sposób, w jaki jeden agent rozdziela pracę między wielu pomocników i składa ją z powrotem w całość. Ci pomocnicy to sub-agenty, czyli osobne kopie modelu uruchamiane do wąskich zadań. Workflow agentowy to z kolei ustalony przepływ takiej pracy, powtarzalny krok po kroku.

Kilka wzorców warto podać wprost, znów zaznaczając, że to podłoga, nie sufit. Rozprosz kilku researcherów równolegle, żeby przeszukali różne źródła i spojrzeli na problem z różnych stron. Urządź turniej pomysłów: niech niezależne agenty zgłoszą konkurencyjne propozycje, a panel sędziów oceni je po kolei według jawnych kryteriów. Każdą ważną tezę każ obalić sceptykom, czyli agentom, których jedynym zadaniem jest udowodnić, że coś nie zadziała. Zanim domkniesz fazę, wpuść krytyka kompletności, który sprawdzi, czy naprawdę zrobione jest wszystko, co miało być.

Jest w tym jeszcze coś, co zaskakuje przy pierwszym zetknięciu. Agent zarządzający nie musi wykonywać pracy własnymi rękami. Może planować, rozdzielać zadania i sprawdzać wyniki, a samą robotę zlecać tańszym wykonawcom. Dlatego takie uruchomienie bywa jednocześnie lepsze i tańsze niż jeden drogi model próbujący zrobić wszystko naraz. Myślenie zostaje na górze, wykonanie schodzi niżej, a ty płacisz drogą stawkę tylko za koordynację. Ważna jest tu jedna pętla. Kiedy wykonawca odda swoją część, agent zarządzający ją sprawdza i, jeśli nie sięga poprzeczki, odsyła z krótką uwagą: jeszcze nie, popraw to i to. Dalej rusza dopiero ta część, która przeszła kontrolę.

Abstrakcyjny schemat koordynacji: jeden jaśniejszy centralny węzeł rozsyła zadania do wielu mniejszych, część zwraca sygnał sprzeciwu, całość zbiega się z powrotem; powściągliwa paleta grafitu, błękitu i zieleni.
Abstrakcyjny schemat koordynacji: jeden jaśniejszy centralny węzeł rozsyła zadania do wielu mniejszych, część zwraca sygnał sprzeciwu, całość zbiega się z powrotem; powściągliwa paleta grafitu, błękitu i zieleni.

Uczciwy przypis

Muszę dopowiedzieć dwie rzeczy, bo inaczej odmalowałbym to ładniej, niż wygląda naprawdę.

Po pierwsze, to nie jest magia na jedno kliknięcie. Nawet dobrze poprowadzony agent dowozi ci może połowę drogi do naprawdę dobrego wyniku. Resztę robisz iteracją: druga tura, w której wracasz z konkretną informacją zwrotną z pierwszej i mówisz, co poprawić. Pierwszy przebieg to nie finał, tylko mocny punkt wyjścia, który oszczędza ci tygodni zaczynania od zera.

Po drugie, największą dźwignię ma coś, co dzieje się jeszcze przed budowaniem: przetestowanie samego pomysłu na wejściu. Zanim pozwolisz agentowi zbudować całość, każ mu twardo sprawdzić, czy pomysł w ogóle się broni. Godzina spędzona na próbie obalenia słabego pomysłu jest warta więcej niż dzień spędzony na dopieszczaniu tego, czego i tak nikt nie potrzebuje.

Zostaje zasada na wynos, i to jest moje przekonanie, nie luźna uwaga. Jakość autonomicznego uruchomienia jest ograniczona jakością briefu i definicji „gotowe”, a nie mocą modelu. Umiejętnością, którą warto ćwiczyć, jest opisanie wyniku tak, żeby dało się go sprawdzić bez ciebie, a nie napisanie magicznego promptu. Następnym razem, gdy zechcesz zlecić agentowi coś dużego, nie zaczynaj od polecenia. Zacznij od zdania, które opisuje, jak wygląda skończona praca, i od pytania, kto z zewnątrz mógłby to potwierdzić.

Sprawdź się

Pięć pytań, żeby sprawdzić, ile zostało z lektury o zlecaniu pracy agentowi bez nadzoru.

  1. Co według tekstu najmocniej ogranicza jakość autonomicznego uruchomienia agenta?

  2. Dlaczego misję lepiej opisać jako oczekiwany wynik niż jako listę czynności do wykonania?

  3. Co odróżnia dobrą definicję „gotowe” od słabej?

  4. Kiedy zasada „decyduj sam i nie pytaj” działa, a nie zamienia się w pewne siebie bzdury?

  5. Na czym polega zaskakująca zaleta agenta zarządzającego, który rozdziela pracę między pomocników?