Moduł 4 30 min Zaawansowany

Subagents i multi-agent workflow

Czego się nauczysz
  • Rozumiesz koncepcję subagentów i izolacji kontekstu
  • Wiesz, kiedy delegować do subagenta
  • Potrafisz tworzyć custom subagentów
  • Znasz orchestration patterns i kontrolujesz koszty

Czym są subagenty

Subagent to izolowany agent uruchamiany przez głównego agenta do wykonania konkretnego podzadania. Każdy subagent ma własny kontekst - nie widzi pełnej historii rozmowy głównego agenta.

Analogia: Szef (główny agent) deleguje zadania pracownikom (subagentom). Każdy pracownik dostaje wytyczne i pracuje samodzielnie, a na końcu raportuje wynik.

Kiedy delegować

Dobre scenariusze:

  • Równoległe zadania (frontend + backend jednocześnie)
  • Eksploracja codebase (przeszukiwanie wielu plików)
  • Izolacja ryzyka (ryzykowne zmiany w osobnym kontekście)
  • Specjalizacja (security review, test review, style review)

Złe scenariusze:

  • Proste, jednoetapowe zadania (overhead > korzyść)
  • Gdy subagent potrzebuje pełnego kontekstu rozmowy
  • Gdy koszt tokenów jest priorytetem (subagenty mnożą koszty)

Custom subagenty

Tworzysz je jako pliki w .claude/agents/:

---
name: "security-reviewer"
description: "Sprawdza kod pod kątem bezpieczeństwa"
model: "sonnet"
allowedTools:
  - Read
  - Grep
  - Glob
---

## Instrukcje Security Review

Przeanalizuj wskazane pliki pod kątem:
1. Injection attacks (SQL, XSS, command injection)
2. Hardcoded secrets (klucze API, hasła)
3. Brakująca walidacja inputu
4. Niebezpieczne operacje na plikach
5. Problemy z autentykacją/autoryzacją

Format raportu:
- [KRYTYCZNY] -- wymaga natychmiastowej naprawy
- [WAŻNY] -- naprawić przed merge
- [SUGESTIA] -- warto rozważyć

YAML frontmatter:

  • name - nazwa subagenta
  • description - opis (Claude użyje do decyzji o delegacji)
  • model - model AI (sonnet/opus/haiku)
  • allowedTools - dozwolone narzędzia

Orchestration patterns

Sekwencyjny

Główny → Subagent A → wynik → Subagent B → wynik → Odpowiedź

Każdy subagent działa po kolei.

Równoległy

Główny → Subagent A --|
       → Subagent B --|→ Agregacja → Odpowiedź
       → Subagent C --|

Wiele subagentów jednocześnie. Główny czeka i łączy wyniki.

Hierarchiczny

Główny → Subagent-lider → Sub-subagent X
                        → Sub-subagent Y

Subagent sam deleguje dalej.

Przykład: Multi-agent PR review

"Zrób pełny review tego PR-a"
    |
    +→ security-reviewer -- bezpieczeństwo
    +→ test-reviewer -- pokrycie testami
    +→ style-reviewer -- zgodność z konwencjami
    |
    v
Główny agent: łączy raporty w jeden review

Monitorowanie i koszty

  • /cost - zsumowane koszty sesji (włącznie z subagentami)
  • Każdy subagent zużywa własne tokeny (niezależnie od głównej sesji)
  • Koszty rosną wielokrotnie wraz z liczbą subagentów

Pro tip: Używaj modelu Sonnet (lub Haiku) dla subagentów, a Opus dla głównego agenta. Optymalizuje to koszty bez znaczącej utraty jakości.

Ćwiczenie praktyczne: Uruchom workflow z subagentami:

  1. Stwórz custom subagenta .claude/agents/code-reviewer/AGENT.md z instrukcjami code review
  2. Poproś głównego agenta: "Zrób review ostatnich zmian, delegując security review do subagenta"
  3. Sprawdź koszty: /cost
  4. Porównaj jakość review z subagentami vs bez

Praktyczne przykłady multi-agentowych workflow znajdziesz w artykułach Autonomiczny zespół deweloperski AI i Zespoły agentów AI w marketingu.

Co dalej

W ostatniej lekcji modułu poznasz background tasks i headless mode - automatyzacja z CI/CD.