Przejdź do treści

Agent AI na Claude: Claude API, Agent SDK albo Managed Agents dla firmy

Agenta na modelach Anthropic zbudujesz na trzy sposoby, które różnią się tym, kto uruchamia pętlę agenta, gdzie działają narzędzia i ile kodu trzeba napisać. Opisuję, jak wybieram drogę i kiedy agent nie jest w ogóle potrzebny.

Autor: Szymon Łakomy. Aktualizacja:

Którą drogą zbudować agenta AI na Claude?

Drogę do agenta na Claude wybieram po tym, kto ma go hostować i jakich narzędzi potrzebuje:

DrogaKto hostujeNarzędzia agentaKiedy pasuje
Claude API z narzędziami (tool use)Ty, na własnym serwerze. Pętlę piszesz sam albo używasz pomocnika Tool Runner (beta)tylko te, które sam zdefiniujesz i wykonasz w kodzieagent jest częścią aplikacji i działa na Waszych funkcjach
Claude Agent SDKTy, w procesie, który utrzymujesz (Python lub TypeScript)wbudowane: pliki, bash, wyszukiwanie w plikach i w sieci, własne przez MCPagent pracuje na plikach i poleceniach, potrzebuje uprawnień, hooków i sesji
Managed Agents (beta)Anthropic: pętla agenta i osobny kontener na każdą sesjębash, pliki, wykonywanie kodu, wyszukiwanie w sieci, skille i MCPdługie zadania w tle, według harmonogramu, bez własnej infrastruktury

Według dokumentacji Anthropic, stan na 14 listopada 2026. Koszt użycia modelu sprawdzam w aktualnym cenniku Anthropic.

Porównanie z n8n i Copilot Studio opisuję na stronie jak zbudować agenta AI.

Kiedy w ogóle budować agenta, a kiedy wystarczy przepływ?

Agenta buduję dopiero wtedy, gdy prostsze rozwiązanie nie wystarcza, jak zaleca Anthropic w poradniku „Building effective agents”. Przed decyzją sprawdzam, czy zadanie spełnia cztery warunki:

  • Jest złożone. Liczby kroków nie da się przewidzieć z góry.
  • Jest wartościowe. Oszczędzony czas uzasadnia koszt tokenów i testów.
  • Model sobie z nim radzi. Na prawdziwych przypadkach Claude poprawnie wykonuje kluczowe kroki.
  • Błędy da się wyłapać. Wynik sprawdza test, reguła albo człowiek.

Gdy kroki są stałe, na przykład „przeczytaj maila, wyciągnij dane, zapisz w CRM”, wystarczy przepływ z jednym wywołaniem modelu. Różnicę między przepływem a agentem opisuję w porównaniu automatyzacja czy agent AI, a węzeł AI Agent w tekście agent AI w n8n.

Claude API z narzędziami: najwięcej kontroli

Przy Claude API model zwraca prośbę o wywołanie narzędzia, a Twój kod je uruchamia i odsyła wynik. Agent widzi wyłącznie funkcje, które mu udostępnię, z uprawnieniami aplikacji. Przykład hipotetyczny: agent sklepu sprawdza status zamówienia i pisze szkic odpowiedzi, ale zwrotu pieniędzy nie ma na liście narzędzi, więc nie może go zlecić. Szczegóły wywołań opisuję przy integracji Claude API.

Claude Agent SDK: Claude Code jako biblioteka

Claude Agent SDK daje w Pythonie i TypeScripcie pętlę agenta, narzędzia i zarządzanie kontekstem, z których korzysta Claude Code: agent od razu czyta i edytuje pliki, uruchamia polecenia i przeszukuje sieć. Ma też uprawnienia, hooki, subagentów i wznawiane sesje.

Agenta na SDK hostuję sam, na serwerze firmy albo w kontenerze, i łączę z Anthropic kluczem API, a nie kontem claude.ai. Skoro agent dostaje powłokę, ustawiam reguły uprawnień i hooki jak w Claude Code, co opisuję na stronie hooki w Claude Code.

Managed Agents: agent na infrastrukturze Anthropic (wersja beta)

W Managed Agents pętlę agenta uruchamia Anthropic, a każda sesja dostaje osobny kontener z powłoką, plikami i wykonywaniem kodu. Agent to zapisana, wersjonowana konfiguracja (model, instrukcja, narzędzia, skille, serwery MCP), a każde uruchomienie to osobna sesja.

  • Harmonogram. Uruchomienia cykliczne według wyrażenia cron.
  • Outcomes. Osobny oceniający odsyła pracę do poprawy, aż wynik spełni kryteria.
  • Sejf (vault). Dane dostępowe do usług trzyma sejf u Anthropic, a nie instrukcja agenta.
  • Dane sesji. Historia sesji w chmurze Anthropic zostaje tam, dopóki jej nie usuniesz, i nie obejmuje jej zerowa retencja danych.

Według dokumentacji usługa działa przez Claude API i oferty Anthropic w chmurach AWS i Google, ale nie przez Amazon Bedrock, Vertex AI ani Microsoft Foundry. Jest w wersji beta, więc przy kluczowym procesie planuję przejście na Agent SDK.

Bezpieczeństwo, testy i koszt agenta na Claude

Każdy agent na Claude dostaje najmniejszy potrzebny zakres: osobne konto, na start narzędzia do odczytu i akceptację człowieka przed działaniem nieodwracalnym. Projekt uprawnień opisuję na stronie bezpieczeństwo agentów AI, a testy przed startem na stronie testowanie agentów AI.

Model dobieram z rodzin Opus, Sonnet i Haiku na danych firmy, jak w poradniku wybór modelu AI do agenta. Agent do jednego zadania kosztuje od około 1200 zł netto, a system wieloagentowy od około 4500 zł netto. Tokeny opłacacie bezpośrednio u Anthropic.

Źródła

Opis opieram na poniższych źródłach. Przepisy, dokumentacja producentów i warunki usług się zmieniają, więc szczegóły warto sprawdzić u źródła:

Najczęstsze pytania

Czym różni się Claude Agent SDK od Claude API?

Claude API daje dostęp do modelu, a pętlę agenta i narzędzia piszesz sam albo używasz pomocnika Tool Runner. Claude Agent SDK to Claude Code w postaci biblioteki, z gotowymi narzędziami do plików i powłoki, uprawnieniami, hookami i sesjami. W obu przypadkach agenta hostujesz sam.

Czy Claude Managed Agents nadają się do produkcji?

Managed Agents są w wersji beta (stan na 14 listopada 2026), więc Anthropic może zmieniać ich działanie. Sprawdzają się w zadaniach w tle, w których firma ma testy wyniku. Przy kluczowym procesie zostawiam plan przejścia na samodzielnie hostowany Agent SDK.

Ile kosztuje zbudowanie agenta AI na Claude?

Agent do jednego zadania to od około 1200 zł netto, a system kilku współpracujących agentów od około 4500 zł netto. Do tego dochodzą tokeny płacone Anthropic i ewentualny hosting. Składniki kosztu rozpisuję na stronie ile kosztuje agent AI.

Czy agenta na Claude można zbudować w n8n?

Tak, w n8n model Anthropic podłączysz do węzła AI Agent i dasz mu narzędzia. To dobra droga, gdy agent łączy popularne systemy w tle. Do pracy na plikach, w powłoce albo w długich sesjach wybieram Agent SDK lub Managed Agents.

Powiązane strony

Chcesz zbudować agenta na Claude?

Opisz zadanie, systemy, z których agent ma korzystać, i miejsce, w którym ma działać. Odpowiem, którą drogę proponuję i ile kosztuje pierwszy etap.