# Agent AI — cheatsheet 1-stronicowy

> **Agent = LLM + narzędzia + pętla decyzyjna.**
> Mozesz to mieć w 5 minut. Najgłupszy działający > Najmądrzejszy planowany.

## Czy potrzebujesz agenta?

| Sytuacja | Co wystarczy |
|---|---|
| Zadanie 1-krokowe, jedno pytanie → jedna odpowiedź | **Prompt** (ChatGPT/Claude bez Project) |
| Powtarzalne, ten sam wzorzec, z plikami referencyjnymi | **Asystent** (Custom GPT, Claude Project, Gemini Gem) |
| Wieloetapowe, wymaga decyzji „co dalej", sięga do zewn. systemów | **Agent** (Make/n8n + LLM, ChatGPT Agent, Claude Computer Use) |
| Kilka rzeczy naraz, różne specjalizacje | **Multi-agent** (CrewAI, LangGraph, Make.com z routerami) |

**Test 5 linii:** Czy umiesz rozpisać zadanie w 5 linijkach? **Tak** → prompt. **Nie** → agent.

## 5 komponentów agenta

```
   ┌─────────────────────────────────────────┐
   │             1. PLANER (LLM)             │
   │     myśli, decyduje, wybiera krok      │
   └────────────────┬────────────────────────┘
                    │
                    ▼
   ┌─────────────────────────────────────────┐
   │           2. NARZĘDZIA (Tools)          │
   │   wyszukiwarka, kod, kalendarz, mail,  │
   │   API, baza danych, Google Drive...    │
   └────────────────┬────────────────────────┘
                    │
                    ▼
   ┌─────────────────────────────────────────┐
   │            3. PAMIĘĆ (Memory)           │
   │  short-term · long-term · epizodyczna  │
   └────────────────┬────────────────────────┘
                    │
                    ▼
   ┌─────────────────────────────────────────┐
   │             4. PĘTLA (Loop)             │
   │   plan → akcja → obserwacja → refleksja│
   └────────────────┬────────────────────────┘
                    │
                    ▼
   ┌─────────────────────────────────────────┐
   │   5. WALIDACJA / GUARDRAILS / STOP      │
   │   max_steps · human-in-loop · limity   │
   └─────────────────────────────────────────┘
```

## 5 poziomów autonomii

| L | Nazwa | Człowiek | Kiedy |
|---|---|---|---|
| **L1** | Asystent | proponuje → klikam „wyślij" | krytyczne (mail do klienta, decyzja kadrowa) |
| **L2** | Z zatwierdzeniem | wykonuje → ja sprawdzam | szablonowe, ale wynik idzie dalej |
| **L3** | Wyrywkowy przegląd | pełna autonomia + sample 10-20% | duży wolumen, niskie ryzyko jednostkowe |
| **L4** | Z alarmami | autonomia + alert na anomalię | rutyna z jasnymi KPI |
| **L5** | Pełna autonomia | log do post-mortem | bardzo powtarzalne, mały koszt błędu |

## 4 wzorce multi-agent

- **Router** — dyspozytor klasyfikuje → kieruje do specjalisty
- **Kaskada** — A → B → C, wynik jednego = wejście następnego
- **Równoległy** — kilku robi to samo → agregator wybiera
- **Krytyk** — wykonawca + recenzent w pętli, aż recenzent zaakceptuje

## Top 5 narzędzi do budowy agentów (2026)

| Narzędzie | Cena | Najlepiej do |
|---|---|---|
| **ChatGPT Agent** (chatgpt.com) | Plus $20/mc | Przeglądarka + pliki + obrazy zintegrowane |
| **Claude Computer Use / Skills** | API $3-15/M tok | Klikanie w UI, integracje przez MCP |
| **Make.com** (make.com) | €9-29/mc | No-code wizualny, ~2000 integracji |
| **n8n** (n8n.io) | Free self-host / €20+ | Open-source, prywatność, niestandardowa logika |
| **Zapier** (zapier.com) | $20-60/mc | Najszybszy start, najwięcej gotowych |

## Pułapki - Top 5 błędów początkujących

1. **Pętla nieskończona** — zawsze ustawiaj `max_steps = 10`
2. **JSON malformed** — dodaj „Odpowiadaj DOKŁADNIE w JSON, bez markdown"
3. **Za duży prompt** — krótszy = szybszy + tańszy + skuteczniejszy
4. **Brak few-shot** — daj 2-3 przykłady poprawnych odpowiedzi
5. **Brak loga** — bez loga nie zrobisz audytu, gdy coś pójdzie nie tak

## Czeklista przed włączeniem agenta na produkcji

- [ ] `max_steps` ustawiony
- [ ] `max_cost` ustawiony (np. $5/zadanie)
- [ ] Whitelist narzędzi (tylko dozwolone akcje)
- [ ] Human-in-loop dla krytycznych akcji (mail, płatność, zapis do CRM)
- [ ] Log każdej akcji (timestamp + tool + input + output + confidence)
- [ ] Alerty na anomalie
- [ ] Plan rollback
- [ ] Tydzień obserwacji w trybie L1-L2 zanim podniesiesz autonomię

---

*AI Master · Dzień 4 · Toruń · 28.04.2026*