Sub-agent: recap + první živé spuštění

⏱ Odhadovaný čas 30 min

📍 Pozice Den 6, blok 2 / 7

🎯 Po tomto bloku budeš umět

• Spustil(a) jsi svůj první sub-agent živě
• Vidíš tool call indikátor (⏺ Task / ⏺ Agent) v UI
• Cítíš rozdíl mezi sub-agent voláním a obyčejným promptem

🔄 Recap z Dne 5 (8 min)

V Dne 5 Bloku 01 jsi viděl/a:

• Sub-agent = samostatná Claude instance spuštěná hlavním CC přes Task / Agent tool
• Vlastní izolovaný kontext — nevidí tvou aktuální konverzaci
• Specializovaný system prompt (general-purpose, Explore, Plan)
• Vrací jen výsledek, ne celý vnitřní log

Dnes to spustíš živě. Žádné další video, žádný další odstavec — všechno hands-on.

Mini-otázka (1 min)

Proč by sub-agent nevěděl, kdo jsi, když mu nepošleš info?

Odpověď

Protože má vlastní izolovaný kontext. Když hlavní CC spustí sub-agent přes Task tool, sub-agent dostane jen to, co napíšeš jako description parametr. Žádná Memory MCP, žádné CLAUDE.md, žádná předchozí zprava nikoho nevidí.

To je fíčura, ne bug — proto je sub-agent rychlý a soustředěný. Ale vyžaduje, abys mu poslal/a všechno potřebné v promptu. (V Bloku 03 to procvičíme detailněji.)

---

📚 Co je Task / Agent tool — krátká reference (4 min)

Tři built-in subagent_type

subagent_type	K čemu	Charakteristika
general-purpose	Universální, nejvíc flexibilní	Může všechno (nástroje, hledání, generování). Sonnet/Opus model.
Explore	Hledání ve struktuře (kód, soubory)	Read-only, Haiku model = rychlejší + levnější. Skvělé na orientaci.
Plan	Research v plan-mode	Read-only, na výzkumné úkoly bez modifikace.

Pro Den 6 použijeme hlavně general-purpose (univerzální). V Bloku 02 si ukážeme Explore.

ℹ️ `Task` vs `Agent` — staré vs nové jméno

Tool byl přejmenován z Task na Agent ve verzi Claude Code v2.1.63. Oba názvy fungují (zpětně kompatibilní). UI indikátor může být:

• ⏺ Task(subagent_type: ..., description: ...) (starší)
• ⏺ Agent(subagent_type: ..., description: ...) (novější)

Stejná funkcionalita. V kurzu používáme „Task” jako common name, ale neboj se ani Agent.

---

🧪 První spuštění (13 min, hands-on)

1. Spusť claude v projektové složce z Dne 4 (maturita-tutor/ / anglicky-tutor/).

2. Pošli první sub-agent volání:

   Student A

   Spusť Task tool s general-purpose subagentem. Úkol pro něj:
   "Vygeneruj seznam 5 zajímavých dějepisných faktů o Třicetileté
   válce (1618-1648) — krátké, ne víc než 2 věty na fakt. Jsou pro
   maturitního studenta, ne pro vědce."

   Student B

   Spusť Task tool s general-purpose subagentem. Úkol pro něj:
   "Vygeneruj 5 příkladů věty s past perfect (had + past participle).
   B1 úroveň, EN + CZ překlad. Pro českou studentku angličtiny.
   Témata: cestování, jídlo, rodina."

3. Sleduj v UI:

   • ⏺ Task(subagent_type: general-purpose, description: ...) indikátor objevil se? ✅
   • ⎿ Running... během 5-15 vteřin
   • ⎿ Done + výsledek (5-10 vět, ne celý vnitřní log)

4. Pokud neuvidíš tool call indikátor:

   • Hlavní CC mohl odpovědět bez sub-agenta (rozhodl se ho nezavolat)
   • Zkus přesnější formulaci: „Použij přesně Task tool s general-purpose subagentem, ne odpovídej sám. Úkol: …”
   • Pokud stále nic, zkus alternativně Agent místo Task

5. Druhý experiment — bez sub-agenta, pro srovnání:

   Student A

   Bez sub-agenta — odpověz přímo: 5 zajímavých dějepisných faktů
   o Třicetileté válce (1618-1648), 2 věty na fakt, pro maturitního
   studenta.

   Student B

   Bez sub-agenta — odpověz přímo: 5 příkladů věty s past perfect,
   B1, EN + CZ překlad, témata cestování/jídlo/rodina.

6. Srovnej oba výstupy — co je jiné?

---

✍️ Reflexe (5 min)

Do zaznamy.md v projektové složce zapiš:

1. Tool call indikátor — viděl/a jsi ho? ⏺ Task(...) nebo ⏺ Agent(...)? (ANO / NE / nejasné)
2. Rozdíl ve výstupu — co se ti zdá jiné mezi sub-agent voláním a přímým promptem?
3. Tvoje očekávání — co bys čekal/a, že sub-agent dělá lépe? Co hůř?

Vzorové odpovědi (otevři AŽ po napsání)

1. Tool call indikátor — typicky ⏺ Task(subagent_type: general-purpose, ...) + krátký Running... + Done s výsledkem.
2. Rozdíly:
   • Sub-agent má často konzistentnější formát (přesněji následuje strukturu úkolu)
   • Hlavní CC přímo je rychlejší (1 volání, ne 2), výstup může být v tónu konverzace
   • Sub-agent neví o předchozích zprávách → výstup je „čistší”, ale ne personalizovaný
3. Sub-agent lépe = soustředěný úkol, čistý výstup. Hůř = ztráta kontextu (neví o tobě), drahší (1 volání navíc), pomalejší u jednoduchých věcí.

---

💰 Cost disclaimer — nesleduj jen vstup, ale i výstup

Sub-agent volání je plnohodnotný API request s vlastním kontextem. Pravděpodobně 1× tokeny per call (jako běžné volání), ale je to volání navíc proti přímému promptu.

Praktické pravidlo:

• Free tier nebo přísný limit? → omez sub-agent volání na ~5/den
• Placený plán? → sleduj /cost v CC, sub-agenti se počítají
• Nepoužívej sub-agenta pro triviální úkoly (1-2 věty odpověď) — overhead
• Nasaď ho na velké, oddělitelné úkoly, kde se izolovaný kontext vyplatí

---

🧪 Checkpoint 30 min

• Spustil/a jsi sub-agent alespoň 2× (1× s, 1× bez sub-agenta)
• Vidíš (nebo víš, jak vypadá) tool call indikátor ⏺ Task(...) / ⏺ Agent(...)
• Rozumíš, kdy sub-agent stojí za to (velký oddělitelný úkol) a kdy je overhead (jednoduchý prompt)
• Reflexe v zaznamy.md napsaná

---

✅ První sub-agent spuštěn, vidím tool call indikátor, rozumím rozdílu

Pokračovat na blok 02: Explore agent →