Poradniki · 04 / 15

Agenci AI w firmie

Z czego składa się agent, kiedy jeden wystarczy i jak pracuje zespół agentów.

Stan na: 7.11.2026

Agent to model z rękami, pamięcią i planem

Agent AI to program, który sam planuje kolejne kroki i wywołuje narzędzia: czyta pliki, uruchamia polecenia, pisze do systemów. Sam model tylko odpowiada tekstem. Agent działa.

Agent potrzebuje warstw:

Agenci w firmie: zasady, które się sprawdzają

• Agent pisze szkic, człowiek wysyła. Maile, oferty, posty i zmiany w systemach przechodzą przez akceptację.
• Jedno źródło prawdy. Wiedza firmy leży w plikach w repozytorium (opis firmy, styl, decyzje, obietnice), a agent czyta je na starcie.
• Uprawnienia minimalne. Agent dostaje tylko te narzędzia, których potrzebuje do zadania. Dostęp do odczytu tam, gdzie zapis nie jest konieczny.
• Ślad. Każda zmiana agenta to commit albo wpis w historii, więc wiesz, kto i co zmienił, i możesz to cofnąć.

Chcesz to u siebie w firmie? Wdrożenie AI w 4 godziny.

1. Jeden agent w pętli

Domyślny wzorzec. Jeden agent, jedna rozmowa: polecenie, działanie, wynik, przegląd, kolejne polecenie.

Ty → polecenie → agent → działanie → wynik → przegląd → polecenie → ...

Tak domyślnie działa Claude Code. Sprawdza się w większości zadań: nowe funkcje, poprawki, refaktoryzacja, dokumentacja. Ograniczenie: jedno zadanie naraz, a okno kontekstu zapełnia się przy dużych zmianach.

2. Agenci równolegle

Kilku niezależnych agentów pracuje jednocześnie nad osobnymi zadaniami.

          ┌→ agent A (testy)
Ty ───────┼→ agent B (research biblioteki)
          └→ agent C (poprawki lintera)

W Claude Code możesz uruchomić kilka sesji obok siebie albo użyć subagentów: główny agent przydziela podzadania i zbiera wyniki. Sesje w tle podejrzysz w jednym widoku.

Kiedy: zadania od siebie niezależne, research równolegle z kodem, kilka podejść do jednego problemu. Ryzyko: konflikty w tych samych plikach.

3. Potok

Wynik agenta A jest wejściem agenta B: plan, implementacja, testy, przegląd.

claude -p "Zaplanuj wdrożenie funkcji X" > plan.md
claude -p "Wdróż plan z pliku plan.md i opisz zmiany" > zmiany.md
claude "Napisz testy do zmian opisanych w zmiany.md"

Flaga -p uruchamia Claude Code bez interfejsu, więc nadaje się do skryptów i CI. Ryzyko: wolno, a błąd z pierwszego etapu przechodzi dalej.

4. Orkiestrator

Jeden agent dzieli zadanie i przydziela je specjalistom, jak lider zespołu.

              orkiestrator
            /      |       \
     frontend   backend    testy

Orkiestrator rozbija zadanie, przydziela podzadania, zbiera wyniki, rozwiązuje konflikty i sprawdza całość. W Claude Code główny agent robi to przez subagentów. W LangGraph opisujesz to jako graf stanów z węzłami i krawędziami.

5. Pętla przeglądu

Jeden agent pisze, drugi recenzuje, aż wynik spełni próg jakości. Recenzent ma świeży kontekst, więc widzi to, czego autor nie widzi. Ustal z góry maksimum rund, np. trzy, a potem decyduje człowiek.

Kiedy wielu agentów

Jeden agent wystarcza do: funkcji (nawet dużych), poprawek, refaktoryzacji, testów, dokumentacji i przeglądu kodu.

Wielu agentów pomaga przy: dużej refaktoryzacji podzielonej na moduły, researchu równolegle z kodem, automatycznych etapach w CI, generowaniu podobnego kodu dla wielu encji.

Reguła: jeśli jeden agent skończy zadanie w jednej sesji i zostanie mu kontekstu, wystarczy jeden. Dodawaj agentów, gdy zadanie samo dzieli się na niezależne części albo etapy.

Antywzorce

• Nadmiar orkiestracji: pięciu agentów do zadania na dziesięć minut.
• Niekończący się przegląd: brak limitu rund, więc ustaw trzy i oddaj decyzję człowiekowi.
• Zgubiony kontekst: wyniki pośrednie zapisuj w plikach, zamiast liczyć na pamięć agenta.
• Konflikty zmian: przydziel pliki agentom albo daj każdemu osobną gałąź.
• Echo: agent recenzuje agenta z tymi samymi uprzedzeniami, więc na końcu i tak patrzy człowiek.
• Przedwczesna automatyzacja: przejdź przepływ ręcznie trzy razy, potem automatyzuj.

Frameworki do budowania agentów

Szybki wybór:

• aplikacja na Next.js z czatem: AI SDK;
• agent na narzędziach Claude Code we własnej aplikacji: Claude Agent SDK;
• złożony przepływ ze stanem i powrotami: LangGraph;
• prosty zespół ról w Pythonie: CrewAI;
• środowisko Microsoftu: Microsoft Agent Framework.

Ściąga

Zacznij od jednego agenta. Dodawaj kolejnych, gdy poczujesz wąskie gardło.