# Workbook uczestnika

Ten dokument wypełniasz podczas szkolenia. Nie wpisuj tu haseł, tokenów, kluczy API ani niezanonimizowanych danych klientów.

## 0. Mój rezultat po ośmiu godzinach

**Proces, który chcę usprawnić:**

..............................................................................

**Artefakt istniejący na końcu procesu:**

..............................................................................

**Definicja sukcesu — mierzalna i możliwa do sprawdzenia:**

..............................................................................

**Działanie, którego system nigdy nie wykonuje bez mojej zgody:**

..............................................................................

---

# Arkusz 1. Workflow czy agent?

## 1.1 Obecny proces

Oznaczenia: **D** — deterministyczny, **M** — model, **C** — człowiek, **X** — krok zbędny.

| Nr | Krok | D/M/C/X | Input | Output | Najczęstszy błąd |
|---:|---|---|---|---|---|
| 1 |  |  |  |  |  |
| 2 |  |  |  |  |  |
| 3 |  |  |  |  |  |
| 4 |  |  |  |  |  |
| 5 |  |  |  |  |  |
| 6 |  |  |  |  |  |
| 7 |  |  |  |  |  |
| 8 |  |  |  |  |  |

## 1.2 Ocena przypadku

| Wymiar | Wynik 0–2 | Uzasadnienie |
|---|---:|---|
| częstotliwość |  |  |
| koszt ręczny |  |  |
| powtarzalność inputu |  |  |
| mierzalność wyniku |  |  |
| odwracalność błędu |  |  |
| dostęp do danych |  |  |
| **Suma** |  |  |

## 1.3 Decyzja architektoniczna

- [ ] deterministyczna automatyzacja
- [ ] workflow z modelem
- [ ] agent wybierający kroki
- [ ] jeszcze nie wiem — potrzebny eksperyment

**Dlaczego:**

..............................................................................

**Najprostsza wersja bez agenta:**

..............................................................................

**Warunek uzasadniający dodanie autonomii:**

..............................................................................

---

# Arkusz 2. Kontrakt zadania

## 2.1 Trigger

Proces uruchamia się, gdy:

..............................................................................

Trigger jest:

- [ ] ręczny
- [ ] czasowy
- [ ] webhook/event
- [ ] nowy rekord lub plik
- [ ] inny: .................................................................

## 2.2 Input

| Pole | Typ | Wymagane? | Wartość domyślna | Walidacja |
|---|---|---:|---|---|
|  |  |  |  |  |
|  |  |  |  |  |
|  |  |  |  |  |
|  |  |  |  |  |
|  |  |  |  |  |

**Brak którego pola musi zatrzymać proces?**

..............................................................................

## 2.3 Output

| Pole | Typ | Znaczenie | Kto go używa dalej? |
|---|---|---|---|
| status | enum | aktualny wynik kroku |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |

Dozwolone statusy:

```text

```

## 2.4 Warunek stopu

System kończy sukcesem, gdy:

..............................................................................

System zatrzymuje się bez sukcesu, gdy:

..............................................................................

Maksymalna liczba kroków/prób:

..............................................................................

---

# Arkusz 3. Mapa kontekstu

| Warstwa | Co trafia do modelu? | Skąd pochodzi? | Kiedy jest ładowane? |
|---|---|---|---|
| cel i granice |  |  | zawsze |
| dane zadania |  |  | na początku |
| wiedza domenowa |  |  |  |
| obecny stan |  |  | każdy krok |
| narzędzia |  |  |  |
| przykłady/kryteria |  |  |  |

## Budżet kontekstu

**Zawsze:**

..............................................................................

**Na żądanie:**

..............................................................................

**Tylko jako referencja/ID:**

..............................................................................

**Nigdy w kontekście:**

..............................................................................

## Instrukcja systemowa — wersja robocza

```text
ROLA

CEL

GRANICE

PROCES

KRYTERIA

FORMAT WYNIKU

WARUNEK STOPU
```

---

# Arkusz 4. Katalog narzędzi

| Narzędzie | Klasa | Input | Output/statusy | Retry? | Approval? | Idempotency |
|---|---|---|---|---|---|---|
|  | read/compute/write/action |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |

## Narzędzie najwyższego ryzyka

**Nazwa:** ...................................................................

**Możliwy negatywny skutek:** ................................................

**Minimalne uprawnienia:** ...................................................

**Co musi zobaczyć człowiek przed zatwierdzeniem:**

..............................................................................

**Jak unikam dwukrotnego wykonania:**

..............................................................................

## API, MCP czy A2A?

- [ ] bezpośrednie API
- [ ] MCP dla agent–narzędzie/dane
- [ ] A2A dla niezależnych agentów
- [ ] brak potrzeby integracji

Uzasadnienie:

..............................................................................

---

# Arkusz 5. Stany i trwałość

| Stan | Jak do niego wchodzimy? | Co zapisujemy? | Następny stan | Właściciel decyzji |
|---|---|---|---|---|
| received |  |  |  | system |
|  |  |  |  |  |
|  |  |  |  |  |
| awaiting_approval |  |  |  | człowiek |
|  |  |  |  |  |
| failed |  |  |  |  |

## Checkpoint

Po którym kroku zapisuję checkpoint i dlaczego?

..............................................................................

Minimalna zawartość checkpointu:

- [ ] run_id
- [ ] stan
- [ ] wersja inputu
- [ ] wykonane narzędzia
- [ ] referencje wyników
- [ ] liczba prób
- [ ] kolejny dozwolony krok
- [ ] inne: ................................................................

## Retry

| Błąd | Ponawiam? | Ile razy? | Odstęp | Co robię po wyczerpaniu? |
|---|---:|---:|---|---|
| invalid_input | nie | 0 | — | proszę o poprawę |
| rate_limited |  |  |  |  |
| unauthorized |  |  |  |  |
| temporary_unavailable |  |  |  |  |
| unknown |  |  |  |  |

---

# Arkusz 6. Granice autonomii

| Działanie | Automatycznie | Po akceptacji | Nigdy |
|---|:---:|:---:|:---:|
| odczyt publicznego źródła |  |  |  |
| analiza zanonimizowanego dokumentu |  |  |  |
| utworzenie prywatnego szkicu |  |  |  |
| wysłanie maila |  |  |  |
| publikacja posta |  |  |  |
| usunięcie rekordu |  |  |  |
| zakup lub płatna operacja |  |  |  |
| zmiana uprawnień |  |  |  |
| inne: |  |  |  |

## Rekord zgody

Zgoda musi wskazywać:

- [ ] dokładny artefakt
- [ ] jego wersję
- [ ] działanie
- [ ] konto/cel
- [ ] zatwierdzającego
- [ ] czas zatwierdzenia
- [ ] wygaśnięcie

Co unieważnia zgodę?

..............................................................................

---

# Arkusz 7. Ryzyka i zabezpieczenia

| Ryzyko | Prawdopodobieństwo 1–3 | Skutek 1–3 | Zabezpieczenie | Test |
|---|---:|---:|---|---|
| model wymyśla źródło |  |  | URL tylko z narzędzia |  |
| prompt injection w dokumencie |  |  |  |  |
| publikacja bez zgody |  |  |  |  |
| dwukrotne wykonanie |  |  |  |  |
| wyciek sekretu |  |  |  |  |
| błędne konto docelowe |  |  |  |  |
| niekontrolowany koszt |  |  |  |  |
|  |  |  |  |  |

Największe ryzyko:

..............................................................................

Warunek natychmiastowego wyłączenia systemu:

..............................................................................

---

# Arkusz 8. Evale

Zaprojektuj 3 przypadki typowe, 3 brzegowe, 2 awarie narzędzi i 2 przypadki bezpieczeństwa.

| ID | Typ | Input/scenariusz | Oczekiwany stan | Kryteria pass | Wynik |
|---|---|---|---|---|---|
| E01 | typowy |  |  |  |  |
| E02 | typowy |  |  |  |  |
| E03 | typowy |  |  |  |  |
| E04 | brzegowy |  |  |  |  |
| E05 | brzegowy |  |  |  |  |
| E06 | brzegowy |  |  |  |  |
| E07 | awaria |  |  |  |  |
| E08 | awaria |  |  |  |  |
| E09 | bezpieczeństwo |  |  |  |  |
| E10 | bezpieczeństwo |  |  |  |  |

## Moje metryki

Wybierz maksymalnie pięć:

1. ...........................................................................
2. ...........................................................................
3. ...........................................................................
4. ...........................................................................
5. ...........................................................................

---

# Arkusz 9. Koszt i gotowość

## Koszt jednego zakończonego zadania

| Składnik | Szacunek |
|---|---:|
| model |  |
| wyszukiwanie/retrieval |  |
| infrastruktura |  |
| integracje |  |
| ręczna kontrola |  |
| **Razem** |  |

## Bramka go/no-go

- [ ] 10 evali przechodzi ustalony próg
- [ ] publikacja bez zgody jest niemożliwa
- [ ] log nie zawiera sekretów
- [ ] retry nie duplikuje efektów
- [ ] znam koszt poprawnego wyniku
- [ ] mam warunek wyłączenia
- [ ] mam właściciela procesu

Decyzja:

- [ ] GO — ograniczony pilotaż
- [ ] NO-GO — wracam do poprawek
- [ ] SHADOW — system działa bez skutków zewnętrznych

---

# Arkusz 10. Plan 14 dni

## Dni 1–3

..............................................................................

## Dni 4–7

..............................................................................

## Dni 8–10

..............................................................................

## Dni 11–14

..............................................................................

## Jedna rzecz, której nie dodaję w tej wersji

..............................................................................

## Metryka, którą sprawdzę po 14 dniach

..............................................................................

