Agent AI to program, w którym model językowy w pętli sam wybiera kolejne kroki: wywołuje narzędzia (wyszukiwarkę, API, bazę danych), czyta ich wyniki i decyduje, czy działać dalej, czy już odpowiedzieć. Od chatbota różni go to, że wykonuje akcje, a nie tylko odpowiada tekstem, a od zwykłej automatyzacji to, że kolejność kroków nie jest zapisana z góry.
Gdy ktoś mówi „agent AI”, raz ma na myśli asystenta, który pisze kod w Twoim repozytorium, innym razem bota, który sam zwraca pieniądze klientom, a jeszcze innym zwykły skrypt z dopisanym modelem językowym. Zanim zaczniesz budować albo kupować takie rozwiązanie, warto uporządkować, czym agent naprawdę jest, kiedy jest potrzebny i z czego się składa.
Czym są agenty AI i czym różnią się od chatbota?
Agent AI (czasem mówi się też o agentic AI, czyli podejściu agentowym) to system, w którym model językowy dostaje cel i narzędzia, a następnie sam decyduje, jakich narzędzi użyć i w jakiej kolejności, aż cel osiągnie albo trafi na limit. Kluczowe są dwie rzeczy: narzędzia (model może coś zrobić, a nie tylko napisać) i pętla (wynik jednego kroku wpływa na wybór następnego).
Najłatwiej to zobaczyć, porównując trzy rzeczy, które często się mylą:
| Chatbot | Workflow (automatyzacja) | Agent AI | |
|---|---|---|---|
| Co robi | Odpowiada tekstem na pytanie | Wykonuje z góry zapisane kroki | Sam wybiera kroki, żeby osiągnąć cel |
| Kto decyduje o kolejności | Nikt, jest jedna odpowiedź | Programista, w kodzie lub w edytorze | Model, w trakcie działania |
| Dostęp do narzędzi | Zwykle brak | Tak, ale zawsze te same w tej samej kolejności | Tak, model wybiera, które i kiedy |
| Przewidywalność | Wysoka | Bardzo wysoka | Niższa, bo ścieżka może być za każdym razem inna |
| Przykład | Odpowiedź na pytanie o godziny otwarcia | „Po zamówieniu wyślij mail, potem dodaj wiersz do arkusza” | „Ustal, czy ten zwrot się należy, i jeśli tak, zrealizuj go” |
Granica jest płynna: chatbot z dostępem do wyszukiwarki zaczyna przypominać agenta, a workflow z jednym krokiem „zapytaj model” bywa nazywany agentem w materiałach marketingowych. Praktyczny test jest prosty: jeśli to Ty zapisałeś kolejność kroków, to workflow; jeśli kolejność wybiera model, to agent.
Jak działa agent AI krok po kroku?
Każdy agent, niezależnie od frameworka, robi to samo w pętli (po angielsku agent loop):
- Dostaje cel od użytkownika i listę narzędzi, których może użyć.
- Model decyduje: odpowiedzieć od razu czy wywołać narzędzie (mechanizm nazywa się tool calling).
- Twój kod wykonuje to narzędzie i odsyła modelowi wynik.
- Model czyta wynik i wraca do punktu 2, aż uzna, że ma odpowiedź, albo pętla trafi na limit kroków.
W Pythonie szkielet takiej pętli to kilkanaście linii. Poniżej atrapa modelu zamiast prawdziwego API, żeby było widać samą logikę:
MAX_STEPS = 5
def search_docs(query: str) -> str:
# Narzędzie: tu mogłoby być zapytanie do bazy lub API
return f"Znaleziono 2 dokumenty o: {query}"
TOOLS = {"search_docs": search_docs}
def run_agent(goal: str, model) -> str:
messages = [{"role": "user", "content": goal}]
for _ in range(MAX_STEPS):
decision = model(messages)
if decision["type"] == "answer":
return decision["text"]
result = TOOLS[decision["name"]](**decision["args"])
messages.append({"role": "tool", "content": result})
return "Przerwano: przekroczono limit kroków."
Zwróć uwagę na MAX_STEPS. Bez limitu model, który nigdy nie uzna zadania za skończone, będzie wywoływał narzędzia w nieskończoność i naliczał koszty. Uruchomiony z atrapą, która zawsze prosi o kolejne narzędzie, ten kod kończy się komunikatem o przekroczeniu limitu zamiast zawieszenia. Pełną, działającą wersję z prawdziwym API, limitem tokenów i wykrywaniem powtórzeń opisujemy w artykule o pętli agenta w Pythonie od zera.
Z czego składa się agent AI?
Niezależnie od narzędzia, agent ma pięć elementów. Jeśli któryś pominiesz, agent albo nie zadziała, albo będzie niebezpieczny:
| Element | Za co odpowiada | Typowy błąd |
|---|---|---|
| Model językowy | Podejmuje decyzje: które narzędzie, z jakimi argumentami, kiedy skończyć | Zbyt słaby model do trudnego zadania albo zbyt drogi do prostego |
| Narzędzia | Pozwalają coś zrobić: wyszukać, przeczytać plik, wywołać API, zapisać dane | Niejasny opis narzędzia, przez który model go nie używa lub używa źle |
| Pętla sterująca | Wykonuje narzędzia, odsyła wyniki, pilnuje limitów | Brak limitu kroków i kosztów |
| Kontekst i pamięć | Historia rozmowy i wyniki narzędzi, które model widzi przy kolejnej decyzji | Rosnąca historia, która drożeje z każdym krokiem i w końcu przekracza okno kontekstu |
| Uprawnienia i nadzór | Określają, co agent wolno, i kiedy musi zapytać człowieka | Agent z dostępem do wszystkiego, bez zatwierdzania akcji |
Dwa z tych elementów zasługują na osobne omówienie. Po pierwsze, opis narzędzia jest dla modelu instrukcją: to na jego podstawie model decyduje, czy narzędzie pasuje do zadania. Jeśli agent „nie chce użyć żadnego narzędzia”, najczęściej winny jest niejasny opis lub schemat argumentów. Jak je poprawnie zapisać, pokazujemy w artykule o tool callingu w OpenAI API z Pydantic. Po drugie, okno kontekstu i koszt: im dłużej agent pracuje, tym dłuższą historię przesyła się do modelu przy każdym kroku, więc koszt rośnie szybciej niż liczba kroków. O mechanice tokenów i kontekstu piszemy w artykule o API OpenAI w Pythonie: tokeny, kontekst i koszty.
Jakie są przykłady agentów AI?
Poniższe przykłady różnią się tym, jakie narzędzia dostaje agent i jak dużo wolno mu zmienić:
| Przykład | Cel agenta | Typowe narzędzia | Poziom ryzyka |
|---|---|---|---|
| Agent do kodowania | Wprowadzić zmianę w repozytorium | Czytanie i edycja plików, uruchamianie testów i poleceń | Wysoki: zmienia kod i może uruchamiać polecenia |
| Agent wyszukujący w dokumentach | Odpowiedzieć na pytanie na podstawie firmowej bazy wiedzy | Wyszukiwanie semantyczne, odczyt sekcji dokumentu | Niski: tylko odczyt |
| Agent obsługi zwrotów | Sprawdzić zamówienie i zrealizować zwrot | Odczyt zamówienia, zwrot pieniędzy, wysłanie maila | Wysoki: ruszą się pieniądze |
| Agent badawczy | Zebrać informacje z wielu źródeł i zrobić podsumowanie | Wyszukiwarka w sieci, pobieranie stron | Średni: ryzyko błędnych lub podstawionych źródeł |
| Agent w automatyzacji procesów | Obsłużyć powtarzalny proces biznesowy, w którym część decyzji wymaga rozumienia tekstu | Integracje z systemami firmowymi, mail, arkusze | Zależy od uprawnień |
Pierwszy wiersz to narzędzia, o których pisaliśmy w porównaniu Cursora, Claude Code, Copilota i Codeksa: działają w trybie agentowym, czyli same czytają kod, wprowadzają zmiany i uruchamiają testy. Drugi przykład zbudujemy krok po kroku w artykule o agencie w Pythonie z narzędziami wyszukiwania i odczytu dokumentów. Zwróć uwagę, że poziom ryzyka rośnie razem z tym, co agentowi wolno zmienić, a nie z tym, jak „mądry” jest model.
Kiedy użyć agenta AI, a kiedy zwykłego workflow?
Agent jest wolniejszy, droższy i mniej przewidywalny niż workflow, więc nie jest odpowiedzią na każdy problem. Dobierz rozwiązanie do zadania:
| Sytuacja | Lepszy wybór | Dlaczego |
|---|---|---|
| Kroki znasz z góry i są zawsze takie same | Workflow lub zwykły skrypt | Tańsze, szybsze, w pełni przewidywalne |
| Trzeba zrozumieć tekst, ale kolejność działań jest stała | Workflow z jednym wywołaniem modelu | Model robi to, w czym jest dobry, a kolejność masz pod kontrolą |
| Liczba i rodzaj kroków zależą od tego, co się okaże po drodze | Agent | Nie da się zapisać wszystkich ścieżek z góry |
| Błąd kosztuje drogo (pieniądze, dane klientów) | Workflow lub agent z zatwierdzaniem przez człowieka | Nie zostawiaj nieodwracalnych akcji bez nadzoru |
| Wynik da się łatwo sprawdzić (np. testami) | Agent | Weryfikacja wyłapie błędy modelu |
Częsty błąd to budowanie agenta tam, gdzie wystarczyłby trzykrokowy skrypt. Agenta warto rozważyć dopiero wtedy, gdy zapisanie wszystkich możliwych ścieżek w kodzie byłoby niepraktyczne.
Jakie są rodzaje i wzorce agentów?
Pod hasłem „agent AI” kryje się kilka często spotykanych układów:
- Pojedynczy agent z narzędziami: jeden model, jedna pętla, kilka narzędzi. Dobry punkt wyjścia i wystarcza do większości zadań.
- Agent z wyszukiwaniem w dokumentach: model sam decyduje, czy szukać, czy przeczytać całą sekcję. Różni się od klasycznego RAG tym, że to model wybiera, kiedy sięgnąć do bazy. Sam RAG opisujemy w artykule o bazach wektorowych i RAG w Pythonie.
- Agent z człowiekiem w pętli (human-in-the-loop): przed ryzykowną akcją agent zatrzymuje się i czeka na zgodę. Jak to zaimplementować, pokazujemy w artykule o human-in-the-loop w LangGraph.
- System wieloagentowy (multi-agent): kilku wyspecjalizowanych agentów, których pracą steruje graf przepływu. Podstawy takiego grafu opisujemy w artykule o LangGraph w Pythonie: stan, węzły i krawędzie.
Więcej agentów nie znaczy lepiej. Każdy dodatkowy agent to kolejne wywołania modelu, kolejne koszty i kolejne miejsce, w którym coś może pójść źle, więc zaczynaj od jednego.
Jakie rozwiązania i narzędzia służą do budowy agentów?
Agenta możesz napisać samodzielnie na API modelu albo użyć gotowego rozwiązania. Różnią się tym, ile kontroli dostajesz i ile pracy musisz wykonać:
| Rozwiązanie | Czym jest | Kiedy ma sens |
|---|---|---|
| Surowe API modelu + własna pętla | Kilkanaście linii kodu na API z obsługą narzędzi | Gdy chcesz zrozumieć, co się dzieje, i mieć pełną kontrolę nad limitami |
| LangGraph | Biblioteka do opisywania agenta jako grafu: stan, węzły, krawędzie, zapis stanu | Gdy przepływ jest złożony, ma rozgałęzienia, pauzy i wznawianie |
| LangChain | Biblioteka z gotowymi komponentami do aplikacji opartych na modelach | Gdy chcesz szybko złożyć prototyp z gotowych klocków |
| MCP (Model Context Protocol) | Otwarty protokół, którym narzędzia udostępnia się agentom jako osobny serwer | Gdy to samo narzędzie ma być używane przez różne aplikacje agentowe |
| n8n i podobne platformy | Wizualne budowanie procesów z krokami opartymi na modelu | Gdy proces ma być utrzymywany także przez osoby nieprogramujące |
| Gotowe agenty (Claude Code, Codex, Cursor) | Narzędzia, w których agent jest już zbudowany | Gdy potrzebujesz agenta do pracy z kodem, a nie własnego produktu |
MCP często jest mylony z frameworkiem, a to tylko standard komunikacji między agentem a narzędziem. Wyjaśniamy go w artykułach o serwerze MCP w Pythonie z FastMCP oraz o kliencie MCP podłączonym do agenta OpenAI.
Z frameworkiem czy bez?
Początkujący często zaczynają od frameworka i na nim utykają. Na Stack Overflow pytania o agentów w LangChain zbierają dziesiątki tysięcy wyświetleń, a znaczna część dotyczy błędów importu, agenta, który nie wywołuje żadnego narzędzia, albo odpowiedzi, której nie widać w strumieniu. Wspólny mianownik jest taki, że autor pytania nie widzi, co agent robi w środku. Dlatego sensowna kolejność jest odwrotna: najpierw napisz pętlę na surowym API (jak w szkielecie wyżej), a dopiero potem sięgnij po framework, który ją za Ciebie uporządkuje. Wtedy wiesz, które zachowanie pochodzi z modelu, a które z biblioteki.
Jakie są ryzyka związane z agentami AI?
Ryzyka rosną razem z uprawnieniami, bo agent nie tylko może się pomylić, ale może też zrobić coś na podstawie błędu:
| Ryzyko | Na czym polega | Jak ograniczać |
|---|---|---|
| Błędne decyzje i halucynacje | Model wymyśla argumenty narzędzia albo „pamięta” coś, czego nie ma | Walidacja argumentów, sprawdzanie wyników, testy |
| Zapętlenie i koszty | Agent bez końca wywołuje te same narzędzia | Limit kroków, tokenów i czasu |
| Nadmierne uprawnienia | Agent ma dostęp do akcji, których nie powinien wykonywać sam | Role, narzędzia tylko do odczytu, dziennik audytowy |
| Prompt injection | Treść z zewnątrz (strona, mail, dokument) zawiera polecenia, które agent wykonuje jak instrukcje | Traktowanie wyników narzędzi jako danych, a nie poleceń; zatwierdzanie ryzykownych akcji |
| Wykonywanie cudzego kodu | Agent uruchamia polecenia lub kod z niezaufanego źródła | Izolacja środowiska, ograniczenie poleceń |
Zasada, która porządkuje większość z tych punktów: im więcej agent może zmienić, tym więcej nadzoru potrzebuje. Jak to rozwiązać w praktyce (role, zatwierdzanie akcji przez człowieka, dziennik audytowy), opisujemy w artykule o uprawnieniach agenta AI w Pythonie. O wymyślonych funkcjach i bibliotekach, które modele potrafią zaproponować, piszemy w artykule o halucynacjach AI w kodzie.
Jak zacząć budować własnego agenta AI?
Kolejność, w której warto się uczyć, odpowiada kolejności, w jakiej agent się „składa”:
- Wywołania API modelu: tokeny, kontekst, koszt. Zacznij od API OpenAI w Pythonie.
- Tool calling: jak model prosi o wywołanie Twojej funkcji i jak odsyłasz wynik. Zobacz tool calling w OpenAI API z Pydantic.
- Pętla agenta z limitami: pętla agenta w Pythonie od zera.
- Prawdziwe narzędzia: agent z wyszukiwaniem i odczytem dokumentów.
- Uprawnienia i zatwierdzanie akcji: uprawnienia agenta AI.
- MCP: serwer MCP w Pythonie i klient MCP.
- Grafy i wznawianie: LangGraph w Pythonie oraz checkpointy w LangGraph.
- Testy: agent bez testów to zgadywanie, więc zajrzyj do artykułu o testowaniu kodu z API LLM w pytest.
Jeśli wolisz przejść tę drogę z mentorem, który sprawdza kod i pokazuje, gdzie agent zawodzi, ta sama kolejność jest podstawą ścieżki AI Engineer: od API modelu, przez narzędzia i MCP, po systemy wieloagentowe i wdrożenie.
Najczęstsze pytania o agenty AI
Czy agent AI to to samo co ChatGPT?
Nie. ChatGPT to aplikacja z modelem językowym, w której rozmawiasz z modelem. Agentem staje się dopiero wtedy, gdy model dostaje narzędzia i działa w pętli, sam wybierając kroki. Wiele aplikacji łączy oba tryby, więc granica bywa płynna.
Co to jest agentic AI?
To określenie podejścia, w którym system oparty na modelu działa autonomicznie w kierunku celu, zamiast tylko odpowiadać na pojedyncze pytania. W praktyce oznacza to samo, co opisano wyżej: narzędzia, pętla i decyzje podejmowane przez model.
Czy agent AI zastąpi programistę?
Agenci przejmują część pracy (pisanie szablonowego kodu, uruchamianie testów, wstępne poprawki), ale ktoś musi określić cel, ocenić wynik i odpowiadać za skutki. Szerzej o tym, jak zmienia się zawód, piszemy w artykule Czy AI zastąpi programistów, czy tylko zmieni ich pracę.
Czy do budowy agenta potrzebny jest framework?
Nie. Podstawowego agenta napiszesz na samym API modelu w kilkunastu liniach, a framework warto dołożyć, gdy przepływ robi się złożony: z rozgałęzieniami, pauzami na zatwierdzenie i wznawianiem pracy po przerwie.
Czy agent AI jest bezpieczny?
Tylko w takim stopniu, w jakim go ograniczysz. Bezpieczeństwo zależy od uprawnień narzędzi, limitów kroków i kosztów, zatwierdzania ryzykownych akcji oraz traktowania treści z zewnątrz jako danych, a nie poleceń.


