Kurs 2: aplikacje agentowe na modelach lokalnych — indeks

Utworzony 23 września 2026. Dla Michała. Kontynuacja kursu 1 — 00-KURS-INDEKS.md, części 1–10 (na Macu piętro wyżej, na maszynie w ../kurs_lokalne_modele/).

Cel całości. Po tym kursie projektujesz i utrzymujesz systemy agentowe, a nie tylko uruchamiasz agenta. Budujesz jeden rosnący system — $OSA/ — i stawiasz na nim trzech współpracujących agentów osobistych, którzy działają tygodniami, budzą się sami, pamiętają, są mierzeni i nie mogą zrobić Ci krzywdy.

Kurs 1 uczył, jak działa model. Kurs 2 uczy, jak zbudować wokół niego system, któremu można zaufać.

---

Teza, na której stoi cały kurs

Wynik agenta zmienia się bardziej wraz z harnessem niż z modelem. Ten sam model pod dwoma szkieletami daje istotnie różne liczby.

Zmienna, nad którą masz pełną kontrolę — system wokół modelu — jest ważniejsza niż zmienna, nad którą nie masz żadnej — wagi. Dlatego w tym kursie nie ma części o dostrajaniu modeli, a jest sześć części o pomiarze.

⭐ W części 14 zweryfikujesz tę tezę na własnym sprzęcie. Jeśli się nie potwierdzi, kurs mówi Ci wprost: popraw kurs.

---

Droga

  BLOK I · FUNDAMENT ─────────────────────────────── ~14 h
   01 architektury          mapa terenu, OpenClaw rozłożony, loop engineering
   02 szkielet              brama, konfiguracja, sesja jako dziennik zdarzeń
   03 harness         ⭐⭐  pętla, która przeżywa pięć okien kontekstu
              │
  BLOK II · KONTEKST I PAMIĘĆ ────────────────────── ~16 h
   04 kontekst              budżet uwagi, context rot ZMIERZONY, kompakcja
   05 pamięć           ⭐  trzy szkoły, graf bi-temporalny od zera
   06 tożsamość            SOUL/AGENTS/GRANICE — pliki zamiast dostrajania
              │
  BLOK III · DZIAŁANIE ───────────────────────────── ~20 h
   07 narzędzia            ergonomia, promień rażenia, ile to za dużo
   08 code-mode       ⭐⭐  agent pisze program — największa zmiana 2026
   09 protokoły            MCP vs CLI vs funkcja — mierzone, nie dyskutowane
   10 piaskownica          drabina izolacji, proxy, sekrety, próby ucieczki
              │
  BLOK IV · PROAKTYWNOŚĆ I WIELOŚĆ ───────────────── ~16 h
   11 harmonogram      ⭐  agent budzi się sam i NIE zawraca głowy
   12 kanały               kanał jako granica zaufania
   13 flota            ⭐  trzej agenci, granice uprawnień, kaskada
              │
  BLOK V · JAKOŚĆ I ZAUFANIE ─────────────────────── ~14 h
   14 ewaluacja       ⭐⭐  zbiór złoty, sędzia, pass^k, bramka regresji
   15 obserwowalność       ślady OTel, odtwarzanie, śledztwo po awarii
   16 bezpieczeństwo   ⭐  OWASP ASI01–ASI10, 20 ataków na własną flotę
              │
  BLOK VI · PRODUKCJA ────────────────────────────── ~12 h
   17 hybryda              lokalny domyślnie, granica prywatności w kodzie
   18 wydanie              wersjonowanie, wycofanie, runbook
              │
   19 CAPSTONE ─────────► osobisty asystent + powtórzony pomiar z części 1

⚠️ Kolejność nie jest dekoracją. Część 8 (code-mode) bez części 10 (piaskownica) to zdalne wykonanie kodu z uprzejmym interfejsem. Część 13 (flota) bez części 10 i 7 to jeden cel ataku z sumą wszystkich uprawnień. Nie przeskakuj w blokach III i IV.

---

Trzej agenci, których zbudujesz

Różnią się granicami, nie inteligencją — i to jest główna nauka architektoniczna tego kursu.

---

Pliki

Razem: ~102 godziny przy klawiaturze. To nie jest kurs do przeczytania.

---

Anatomia każdej części

Stała, żeby dało się nawigować:

0. Problem — po co ta warstwa istnieje
1-N. Teoria — z odnośnikiem do źródła
   ⭐ „Jak robią to najlepsi" — OpenClaw, Anthropic, Steinberger
OD ZERA — piszesz mechanizm sam, bez zależności
PRODUKCYJNIE — tabela „Twoje vs gotowe": co dokładają, co kosztują
⭐ EKSPERYMENT — hipoteza, procedura, tabela DO WYPEŁNIENIA, predykcja
ĆWICZENIE — produkuje coś w rosnącym systemie
Pułapki — ponumerowane, z objawem i lekarstwem
Checkpoint — skrypt, który MUSI przejść przed następną częścią

⭐ Sekcja EKSPERYMENT jest sednem tego kursu. Każda ma predykcję — co spodziewam się zobaczyć — i pustą tabelę na Twój wynik. Gdy się rozjadą, Twój pomiar wygrywa i popraw kurs. Pliki są Twoje.

---

Zasady, których trzymam się w całym kursie

1. Mechanizm od zera, potem biblioteka. Najpierw piszesz sam (~80 linii), potem pokazuję gotowe: co dokłada, co kosztuje, kiedy warto się przełączyć.
2. Nic bez pomiaru. Każdy próg w Twoim systemie pochodzi z eksperymentu, nie z tego kursu. Cudze liczby są punktem wyjścia, nie wnioskiem.
3. Minimum trzy przebiegi. Agenci są niedeterministyczni; jedno uruchomienie to anegdota (P61).
4. Domyślnie najwęziej. Brak reguły = najmniejsze uprawnienia. Wszędzie (P66).
5. Bezpieczeństwo w kodzie, nie w prompcie. Prompt jest ostatnią linią obrony, nigdy pierwszą.
6. Każda decyzja dostaje ADR z warunkiem falsyfikacji: „jak poznam, że to była zła decyzja".
7. Pułapki numerowane dalej po kursie 1. Sprzętowe P1–P18 (TECHNIKA.md), programowe kurs 1: P20–P52, kurs 2: P60–P139.

---

Czego w tym kursie nie ma — i dlaczego

---

Zanim zaczniesz

cd ~/Desktop/github_repos/llm-education   # katalog repozytorium (u Ciebie może być inny)
source rig-env.sh
$LB/llama-cli --version                     # oczekuj: build z commita 987498f
rocm-smi --showid                           # 2× R9700 + iGPU jako GPU[2]
python3 --version                           # oczekuj ≥ 3.12
which bwrap systemd-run sqlite3 git         # wszystkie cztery wymagane
test -f $AGENT/agent.py && echo "✓ pętla z kursu 1 — punkt wyjścia"

⚠️ HIP_VISIBLE_DEVICES=0,1 musi być ustawione (P12/P32 z kursu 1) — inaczej małe modele lądują na iGPU z 2 GB.

⚠️ Po dołożeniu kart 3 i 4 numeracja się zmieni (P13). Przemapuj przez amd-smi list, zaktualizuj rig-env.sh i powtórz eksperymenty 4, 7, 8, 13 i 17 — wszystkie progi pochodzą z pomiarów na dwóch kartach.

---

Rejestr pułapek programowych — P60–P139

Osiemdziesiąt pułapek. Każda ma w swojej części objaw i lekarstwo.

---

Gdzie co leży

Co powstanie w trakcie:

$OSA/
├── brama.py konfig.py sesje.py harness.py kontekst.py     cz. 2–4
├── decyzje/          ADR z warunkiem falsyfikacji         cz. 1
├── pomiary/          ⭐ wyniki eksperymentów — plik na część
├── dziennik/         sesje + ślady OTel                   cz. 2, 15
├── agenci/           archiwista/ badacz/ gospodarz/       cz. 6
├── narzedzia/        rejestr, promień, idempotencja       cz. 7
├── kod/              code-mode: API + wykonanie           cz. 8
├── piaskownica/      poziomy, proxy, sekrety              cz. 10
├── harmonogram/      planista                             cz. 11
├── kanaly/           gniazdo, HTTP, routing               cz. 12
├── flota/            delegacja, zaufanie, bezpieczniki    cz. 13
├── ewaluacja/        zbiór złoty, sędzia, bramka          cz. 14
├── obserwacja/       tracer, metryki, odtwarzanie         cz. 15
├── bezpieczenstwo/   izolacja, sekwencje, dryf, zgody     cz. 16
├── router/           granica prywatności, audyt wyjścia   cz. 17
├── wydanie/          manifest, wydaj, wycofaj, kontrola   cz. 18
├── testy/            zbiór złoty, ucieczki, 20 ataków
├── RUNBOOK.md        ⭐ co robić o 3:00
└── STOP.sh           ⭐ wyłącznik awaryjny

---

Trzy liczby, które będziesz znał po tym kursie

Nikt inny ich nie zna, bo pochodzą z Twojej maszyny:

1. Gdzie załamuje się synteza Twoich modeli — realny limit kontekstu, nie deklarowany (część 4).
2. Ile narzędzi wytrzymują — zanim wybór zacznie się psuć (część 7).
3. O ile harness bije model — i czy warto kupować większy (część 14).

⭐ Trzecia jest najważniejsza. Jeśli ją znasz, przestajesz zgadywać i zaczynasz inżynierię.

---

Start: 01-ARCHITEKTURY-AGENTOWE.md. Pierwszy eksperyment znajdzie pięć miejsc, w których pęka Twoja obecna pętla. To jest program reszty kursu.