Newsletter · Raz w tygodniu

The Agentic ArchitectJak projektować agentów AI, którzy przetrwają produkcję

Cotygodniowy mail dla ludzi, którzy budują agentów AI. Każde wydanie bierze jeden wzorzec architektury agentowej. Pokazuje, gdzie pęka na produkcji i co wokół niego postawić. Za darmo, raz w tygodniu, po polsku albo po angielsku.

  • Jeden wzorzec w każdym wydaniu, rozrysowany jako przepływ
  • Prawdziwa awaria z produkcji, zanonimizowana, razem z poprawką
  • Nowinki o AI, ale tylko te, które zmieniają sposób budowania

Dostaniesz jednego maila z prośbą o potwierdzenie. Wypiszesz się jednym kliknięciem. Polityka prywatności

Na czym polega ta rola

O czym naprawdę decyduje agentic architect

Agentic architect decyduje, kto ma kontrolę na każdym kroku. Część kroków należy do modelu, bo wymaga oceny. Część należy do kodu, bo musi działać poprawnie za każdym razem. Kilka należy do człowieka, bo pomyłka jest tam droga albo nieodwracalna.

Większość projektów z agentami pada właśnie na tej granicy, a nie w prompcie. Model dostaje decyzję, której nie powinien mieć. Albo kod próbuje ogarnąć niejednoznaczność, której nie udźwignie. Ten newsletter jest o tym, jak dobrze tę granicę wyznaczyć.

01

Przepływ sterowania

Stała ścieżka albo model, który sam wybiera kolejny krok. Tę decyzję najdrożej zmienić później.

02

Narzędzia i uprawnienia

Co agent może wywołać, z jakimi argumentami i czego nie ruszy nigdy.

03

Weryfikacja

Kto sprawdza wynik. Model, który go napisał, to najgorszy możliwy sędzia.

04

Bramki dla człowieka

Które akcje czekają na człowieka: płatności, usuwanie danych, wszystko, co widzi klient.

05

Pamięć i kontekst

Co agent pamięta między krokami, a co trzeba mu powiedzieć jeszcze raz.

06

Budżety i logi

Ile kroków, tokenów i złotówek może zużyć jedno uruchomienie i gdzie zostaje ślad tego, co zrobiło.

Wzorce

Sześć przepływów agentowych obok siebie

Większość systemów na produkcji składa się z sześciu kształtów. Pierwszych pięć to workflow: kod ustala ścieżkę, a model wypełnia kroki. Szósty to agent: ścieżkę wybiera model. Podział pochodzi z tekstu Anthropic Building effective agents. Sposoby awarii i kontrolę dokłada produkcja.

Wywołanie modelu Kod (deterministyczny) Człowiek Wejście / wyjście
01

Łańcuch promptów

Zadanie podzielone na stałe kroki. Każde wywołanie modelu pracuje na wyniku poprzedniego.

nie przechodziWejścieModelkrok 1Kontrola (kod)Modelkrok 2Modelkrok 3WynikStop
Kiedy go użyć

Zadanie dzieli się na kroki, które są zawsze takie same: szkic, potem kontrola, potem tłumaczenie.

Gdzie pęka

Błąd z pierwszego kroku jedzie aż do końca. Bramka, która sprawdza tylko format, przepuszcza złą treść.

Co postawić wokół

Deterministyczna kontrola między krokami, która sprawdza treść, a nie kształt: czy są wymagane fakty i czy liczby zgadzają się ze źródłem.

02

Routing

Klasyfikator wysyła każde wejście na ścieżkę zbudowaną dla jego rodzaju.

WejścieModelklasyfikujModelodpowiedź z FAQKodreguły zwrotówCzłowiekreklamacjaWynik
Kiedy go użyć

Wejścia dzielą się na wyraźne rodzaje, które trzeba obsłużyć inaczej, np. FAQ, zwrot i zgłoszenie błędu.

Gdzie pęka

Zły wybór ścieżki jest cichy. Model klasyfikuje z pełną pewnością, a zgłoszenie ląduje w złej kolejce.

Co postawić wokół

Zmierz trafność routingu na oznaczonych przykładach. Wszystko ryzykowne wysyłaj do człowieka, niezależnie od tego, co powie router.

03

Równoległość

Kilka wywołań modelu naraz, na osobnych częściach albo na tym samym zadaniu. Wyniki łączy kod.

WejścieModelczęść AModelczęść BModelczęść CŁączenie (kod)Wynik
Kiedy go użyć

Praca dzieli się na niezależne części albo chcesz kilku niezależnych odpowiedzi do głosowania.

Gdzie pęka

Głosy z tego samego modelu mają te same ślepe plamki. Agregator, który uśrednia, chowa niezgodę, którą trzeba było zobaczyć.

Co postawić wokół

Jawna reguła łączenia w kodzie. Niezgoda to sygnał do eskalacji, a nie coś do uśrednienia.

Newsletter

Kolejny wzorzec prosto do skrzynki

Jeden wzorzec, jedno case study i nowinki o AI, które mają znaczenie. Raz w tygodniu.

Dostaniesz jednego maila z prośbą o potwierdzenie. Wypiszesz się jednym kliknięciem. Polityka prywatności

04

Orkiestrator i wykonawcy

Jeden model dzieli zadanie w trakcie działania i rozdaje części wykonawcom.

ZadanieModelplanWykonawca 1Wykonawca 2Wykonawca nModelzłóż wynikWynik
Kiedy go użyć

Nie da się z góry znać podzadań, np. przy zmianie, która dotyka nieznanej liczby plików.

Gdzie pęka

Plan rośnie bez końca, wykonawcy dostają za mało kontekstu, a nikt nie sprawdza wyniku wykonawcy przed połączeniem.

Co postawić wokół

Limit wykonawców i kosztów, jawny kontekst dla każdego wykonawcy i kontrola każdego wyniku przed złożeniem całości.

05

Ewaluator i optymalizator

Jeden model pisze, drugi ocenia, a szkic krąży w pętli, dopóki nie przejdzie.

uwagiprzechodziWejścieModelpiszSędziainny model albo kodWynik
Kiedy go użyć

Umiesz opisać, jak wygląda dobry wynik, a druga runda wyraźnie go poprawia.

Gdzie pęka

Gdy sędzia to ten sam model co autor, zatwierdza własną pracę. Bez limitu pętla nigdy się nie kończy.

Co postawić wokół

Sędzia to inny model albo zwykły kod, kryteria ustalone przed startem pętli i maksymalna liczba rund.

06

Autonomiczny agent

Model planuje, wywołuje narzędzia, czyta wynik i sam wybiera kolejny krok, w pętli.

wywołujewyniknieodwracalne?gotowe albo budżet zużytyCelModelplanuj i działajNarzędzia (lista dozwolonych)Człowiekzatwierdź ryzykoLog audytowyWynik
Kiedy go użyć

Ścieżki nie da się poznać z góry, a środowisko jest bezpieczne do eksperymentów.

Gdzie pęka

Ciche awarie, koszt bez sufitu i nieodwracalne akcje wykonane z pełną pewnością siebie.

Co postawić wokół

Lista dozwolonych narzędzi, bramka dla człowieka przy wszystkim nieodwracalnym, budżet na uruchomienie i log, do którego można tylko dopisywać.

Porównanie

Który przepływ do jakiej pracy

Zacznij od góry tabeli. Schodź niżej tylko wtedy, gdy prostszy przepływ nie da rady. Każdy wiersz w dół daje więcej elastyczności i płaci za nią przewidywalnością.

PrzepływKto wybiera kolejny krokPrzewidywalnośćKoszt i opóźnienieDebugowanieWybierz, gdy
Łańcuch promptów KodWysokaNiskiŁatwekroki się nie zmieniają
Routing Model raz, potem kodWysokaNiskiŁatwewejścia mają wyraźne rodzaje
Równoległość KodWysokaŚredniŁatweczęści są niezależne albo trzeba głosowania
Orkiestrator i wykonawcy ModelŚredniaŚredni do wysokiegoTrudniejszepodzadania pojawiają się w trakcie
Ewaluator i optymalizator Model w granicach ustalonych przez kodŚredniaŚredni do wysokiegoŚredniejakość da się ocenić według stałych kryteriów
Autonomiczny agent ModelNiskaWysoki, ograniczony tylko budżetemNajtrudniejsześcieżki nie da się poznać, a zabezpieczenia są na miejscu
Główna teza

Deterministyczna kontrola wokół niedeterministycznego modelu

Niezależnie od przepływu model tylko proponuje. O tym, co naprawdę się stanie, decyduje kod, drugi sprawdzający, a czasem człowiek. Ta myśl przewija się przez każde wydanie. To także kręgosłup Radaru Inżynierii Agentowej, który dzieli te techniki na produkcję, pilotaż, eksperyment i pułapkę cichej awarii.

Model proponujeKod walidujeNiezależna kontrolaCzłowiek zatwierdzaAkcja trafia do logu
Model proponuje

Szkic, wywołanie narzędzia, klasyfikację. Nigdy samą akcję.

Kod waliduje

Schemat, typy, listy dozwolonych, limity. Tanio, szybko i poprawnie za każdym razem.

Niezależna kontrola

Inny model, test albo reguła. Nigdy autor oceniający samego siebie.

Człowiek zatwierdza

Tylko tam, gdzie pomyłka kosztuje pieniądze, zaufanie albo jest nieodwracalna.

Akcja trafia do logu

Tylko do dopisywania, żeby cicha awaria zostawiła ślad do znalezienia.

Więcej na blogu:

Co tydzień

Co trafia do Twojej skrzynki

01

Wzorzec

Jeden wzorzec architektury agentowej z diagramem przepływu: kiedy pasuje, gdzie pęka i co wokół niego postawić.

02

Case study

Prawdziwa awaria albo poprawka z produkcji, zanonimizowana. Co się stało, dlaczego i jaka zmiana to zatrzymała.

03

Nowinki o AI

Tylko te premiery i publikacje, które w tym tygodniu zmieniają sposób budowania. Reszta odpada.

Bez piksela śledzącego: otwarcia nie są liczone. Wypisujesz się jednym kliknięciem w każdym wydaniu.

Newsletter

Kolejny wzorzec prosto do skrzynki

Jeden wzorzec, jedno case study i nowinki o AI, które mają znaczenie. Raz w tygodniu.

Dostaniesz jednego maila z prośbą o potwierdzenie. Wypiszesz się jednym kliknięciem. Polityka prywatności

Kto to pisze

Szymon Paluch

Były CTO z exitem startupu. Wdrożyłem na produkcję ponad dziesięć agentów i systemów AI i piszę o tym, co w nich działa, a co się sypie. Newsletter to ciąg dalszy bloga: krócej, co tydzień i z diagramami.

Więcej o mnie →
FAQ

Pytania o newsletter

Kim jest agentic architect? +

To osoba, która projektuje, jak zbudowany jest agent AI: które kroki należą do modelu, a które do kodu, jakie narzędzia agent może wywołać, jak sprawdza się jego wynik i gdzie podpisuje się człowiek. Newsletter jest dla każdego, kto robi tę pracę, niezależnie od stanowiska.

Dla kogo jest The Agentic Architect? +

Dla inżynierów, tech leadów i CTO, którzy wbudowują agentów AI w produkty albo narzędzia wewnętrzne. Także dla technicznych founderów, którzy muszą zdecydować, na ile tym agentom ufać.

Jak często będzie przychodził? +

Raz w tygodniu. Nic pomiędzy.

Czy to coś kosztuje? +

Nie. Newsletter jest darmowy.

Po polsku czy po angielsku? +

Są dwie edycje. Dostajesz język strony, na której się zapiszesz. Żeby zmienić język, zapisz się na drugiej wersji strony i wypisz z pierwszej.

Czy sprawdzasz, czy otwieram maile? +

Nie. Wydania nie mają piksela śledzącego, więc otwarcia nie są liczone.

Jak się wypisać? +

Na dole każdego wydania jest link do wypisu. Jedno kliknięcie i maile przestają przychodzić.

Newsletter

Buduj agentów, którzy wytrzymują produkcję

Dołącz do The Agentic Architect. Za darmo, raz w tygodniu, a wypisujesz się jednym kliknięciem.

Dostaniesz jednego maila z prośbą o potwierdzenie. Wypiszesz się jednym kliknięciem. Polityka prywatności