Agentní architektury: ReAct, tool use, plánování

Proč architektura matters

Můžete mít nejinteligentnější model na světě, ale pokud ho zabalíte do špatné architektury, dostanete špatného agenta. Architektura určuje, jak agent přemýšlí, rozhoduje se a provádí akce. V této lekci se podíváme na tři základní přístupy.

ReAct: Reasoning + Acting

ReAct (Reasoning and Acting) je nejrozšířenější agentní architektura. Princip je jednoduchý: model střídavě přemýšlí a jedná. Thought (přemýšlím, co potřebuji zjistit) -> Action (zavolám nástroj) -> Observation (vidím výsledek) -> Thought (na základě výsledku přemýšlím, co dál) -> Action...

Úkol: Zjisti, jaký framework používá projekt a jaké má závislosti

Thought: Potřebuji zjistit strukturu projektu. Začnu čtením package.json.
Action: read_file("package.json")
Observation: { "dependencies": { "next": "16.x", "react": "19.x" ... } }
Thought: Je to Next.js 16 s React 19. Podívám se na tsconfig pro další info.
Action: read_file("tsconfig.json")
Observation: { "compilerOptions": { "target": "ES2022" ... } }
Thought: Mám dost informací. Projekt používá Next.js 16, React 19, TypeScript.
Answer: Projekt používá Next.js 16 s React 19 a TypeScript...

Výhody ReAct: transparentní reasoning (vidíte, proč agent dělá, co dělá), dobrý pro úlohy, kde se plán mění podle výsledků, jednoduchá implementace. Nevýhody: může se zacyklit (thought -> action -> thought o tom samém), každý krok stojí tokeny/peníze, pomalejší než přímé přístupy.

Plan and Execute

Alternativní přístup: agent nejdřív vytvoří plán všech kroků, a pak je provede. Na rozdíl od ReAct, kde agent přemýšlí po každém kroku, tady přemýšlí na začátku a provádí sériově.

Úkol: Přidej autentizaci do aplikace

Plán:
1. Analyzovat existující app strukturu
2. Nainstalovat auth knihovnu (next-auth)
3. Vytvořit auth API route
4. Přidat login/logout komponenty
5. Chránit existující stránky
6. Přidat testy
7. Spustit build a ověřit

Execution:
Step 1: read_file("src/app/layout.tsx") -> OK, mám strukturu
Step 2: run_command("npm install next-auth") -> OK
Step 3: write_file("src/app/api/auth/[...nextauth]/route.ts") -> OK
...

Výhody: efektivnější pro úlohy s jasným postupem, méně kroků přemýšlení = nižší náklady, snazší pro uživatele sledovat postup. Nevýhody: plán se může ukázat jako špatný až v průběhu provádění, méně flexibilní než ReAct, vyžaduje dostatečný počáteční kontext.

Tool Use (Function Calling)

Tool use není sama o sobě architektura, ale základní stavební kámen všech agentních architektur. Model dostane popis dostupných nástrojů a rozhodne, který použít. Klíčové: model nástroj NEVYKONÁVÁ — vrací strukturovaný požadavek (název nástroje + parametry) a váš kód nástroj vykoná.

# Definice nástroje pro Claude API
tools = [{
    "name": "read_file",
    "description": "Přečte obsah souboru na dané cestě",
    "input_schema": {
        "type": "object",
        "properties": {
            "path": {
                "type": "string",
                "description": "Cesta k souboru"
            }
        },
        "required": ["path"]
    }
}]

# Model se rozhodne nástroj použít
# a vrací: {"name": "read_file", "input": {"path": "src/app/page.tsx"}}
# Váš kód přečte soubor a výsledek pošle zpět modelu

Pokročilé patterny

Reflexe

Agent po dokončení úkolu zhodnotí svou práci a opraví chyby. Například: napíše kód -> spustí testy -> testy failují -> analyzuje chybu -> opraví kód -> znovu spustí testy. Toto je běžné v coding agentech jako Claude Code.

Tool search

Když agent má přístup ke stovkám nástrojů, nepošlou se všechny v kontextu. Místo toho agent nejdřív hledá relevantní nástroje. Anthropic nabízí Tool Search Tool, který ušetří až 85 % kontextu oproti tradičnímu přístupu.

Paralelní volání nástrojů

Agent může volat více nástrojů najednou — například číst 5 souborů paralelně. To dramaticky zrychluje provádění, zvlášť u I/O-bound operací.

Jak vybrat architekturu

• ReAct: když neznáte předem všechny kroky, úkol vyžaduje exploraci, nebo se plán mění podle výsledků
• Plan and Execute: když je úkol jasně definovaný, kroky jsou predikovatelné, a chcete minimalizovat náklady
• Hybridní: plán na začátku, ale s možností replánovat po každém kroku — nejpoužívanější přístup v praxi