Dvanásť agentov, jedna pamäť

Ako sa práca rozdeľuje medzi špecializovaných sub-agentov bez toho, aby náklady na koordináciu prevýšili prínos.

Problém

Jeden agent, ktorý má na starosti obstarávanie, financie, právo, obsah, výskum a prevádzku, si naraz nakumuluje dva problémy.

Rozrastanie nástrojov. Každá doména pridáva nástroje a každá definícia nástroja spotrebuje kontext pri každom volaní. Po prekročení určitého počtu model minie viac pozornosti na výber medzi nástrojmi než na ich použitie a spoľahlivosť klesá spôsobom, ktorý vyzerá ako problém kvality modelu, nie konfigurácie.

Rozrastanie promptov. Doménové pravidlá, ktoré by sa mali vzťahovať iba na otázky o dodávateľoch, sú prítomné aj pri právnych otázkach, a naopak. Vzájomne si prekážajú.

Zjavné riešenie — rozdeliť na špecialistov — prináša tretí problém: väčšina viacagentových systémov minie na koordináciu viac, než získa späť na sústredenosti.

Návrh

12 špecializovaných agentov, z ktorých každý je definovaný tromi vecami: nástrojmi, ktoré smie používať, doménami, ktoré vlastní, a — čo je kľúčové — explicitným zoznamom toho, čo nesmie riešiť, s uvedením správnej destinácie.

Práve tento zoznam odmietnutí je to, čo systém funkčným robí. Špecialista bez neho nasáva priľahlú prácu, ktorú zvláda zle, a výsledný výstup potom pôsobí ako problém schopností, nie smerovania.

NOT FOR: purchase prices (→ procurement) · payroll (→ HR) · legal analysis (→ legal)

Žiadny zdieľaný živý stav. Sub-agenti nevidia navzájom svoj kontext. Koordinácia prebieha iba dvoma spôsobmi: cez orchestrátor, ktorý drží úlohu, a cez súbory, ktoré pretrvávajú. Zdieľané kontextové okno sa skúšalo v skorších návrhoch a práve to spôsobovalo ich nepredvídateľnosť — uvažovanie každého agenta znečisťovalo uvažovanie všetkých ostatných.

Rozvetvenie (fan-out) je explicitné a ohraničené. Tam, kde úloha skutočne presahuje viacero domén, agenti bežia paralelne podľa napísanej tabuľky párovania — nový dodávateľ spúšťa obstarávanie plus výskum, zmluva s finančným dopadom spúšťa financie plus právo. Limit: 5 paralelne, každý približne 25 ťahov.

Každé delegovanie nesie 5-poľový brief. Úloha s jej dôvodom, kontext, tvar výstupu, limity, požadovaná sebaverifikácia. Práve pole „dôvod" umožňuje sub-agentovi urobiť úsudkové rozhodnutia, ktoré brief nepredpokladal.

Kompromisy

Smerovanie je teraz plochou pre zlyhania. Úloha odoslaná nesprávnemu špecialistovi produkuje sebavedomý, dobre naformátovaný výstup zo zlej domény. Toto je reálna cena a zoznamy odmietnutí existujú na jej obmedzenie, nie odstránenie.

Kontext necestuje. Sub-agent štartuje vždy „za studena", takže brief musí niesť všetko, čo potrebuje. Briefy sú preto dlhšie, než by sa mohlo zdať vhodné, a práve tenké briefy sú najčastejšou príčinou nepoužiteľných výsledkov.

Paralelné výsledky si vyžadujú zosúladenie. Dvaja špecialisti môžu vrátiť protichodné zistenia. To je jednoznačne lepšie než jeden agent, ktorý si potichu vyberie stranu — no niekto to musí zosúladiť, a týmto niekým je orchestrátor.

Náklady na úlohu sú vyššie. Každý sub-agent má vlastnú réžiu. Vypláca sa to pri úlohách, ktoré by inak vyžadovali jeden kontext držiaci šesť domén, a nevypláca sa to pri malých úlohách. Delegovanie úplne všetkého je spôsob, ako tento vzor prestane byť výhodný.

Ako úloha skutočne prebieha smerovaním

K rozhodnutiu o smerovaní dochádza skôr, než sa zapojí akýkoľvek špecialista, a je zámerne mechanické, nie „chytré".

Vyhráva prvá zhoda. Definícia každého agenta nesie vlastný zoznam spúšťačov a orchestrátor porovnáva práve s nimi namiesto voľného uvažovania o tom, ktorý špecialista sa „hodí". Voľné uvažovanie o smerovaní produkuje vierohodné nesprávne smerovania a vierohodné nesprávne smerovanie je nákladné práve preto, že výstup vyzerá v poriadku.

Viacdoménové úlohy sa rozvetvujú podľa napísanej tabuľky, nie podľa úsudku. Malá množina tvarov úloh má známe párovania a tieto párovania boli odvodené z prípadov, keď jediný špecialista dal sebavedomo neúplnú odpoveď:

nový dodávateľ → obstarávanie + výskum · zmluva s finančným dopadom → financie + právo · realitný obchod s právnou expozíciou → nehnuteľnosti + právo · ranný prehľad → prevádzka + financie + výskum

Tabuľka je krátka a svoje miesto si zaslúži tým, že je zapísaná. To isté párovanie odvodené nanovo zakaždým vyjde inak.

Čokoľvek pod prahom zložitosti sa vôbec nedeleguje. Delegovanie stojí brief, štart za studena a zosúladenie. Pod pár krokmi táto réžia prevyšuje prínos a orchestrátor, ktorý deleguje všetko, je pomalší a menej presný než ten, ktorý jednoduché veci robí priamo.

Špecialista, ktorý dostane prácu mimo svojho rozsahu, odmietne a pomenuje destináciu. Nepokúša sa o čiastočnú odpoveď. Toto je jediné najdôležitejšie správanie v celom návrhu, pretože alternatíva — špecialista, ktorý sa ochotne snaží mimo svojej domény — produkuje presne ten výstup, ktorý sa najťažšie odhaľuje: dobre naformátovaný, sebavedomý a nesprávny spôsobom, ktorý orchestrátor nevidí.

Čo sa pokazilo

Čiastočný úspech hlásený ako úspech. Rozvetvenie na 5 vetiev vrátilo čistý súhrn pokrývajúci 4 z nich. Zlyhaná vetva neposkytla žiadny výstup a jej absencia bola v súhrne neviditeľná. Náprava: každé rozvetvenie hlási X of Y, pomenúva zlyhané vetvy a raz sa pokúsi o opakovanie, než to nahlási ako problém.

Sub-agenti si vymýšľajú čísla. Brief, ktorý nedal povolenie na zlyhanie, produkoval odpoveď, ktorá vyzerala kompletne, ale obsahovala vymyslenú zložku. Agent optimalizujúci na úplnú odpoveď takú odpoveď aj vyprodukuje. Náprava: explicitné „nenájdené je platný výsledok" v poli limitov, plus označenie miery istoty pri každom čísle.

Delegované zápisy prepisovali súbory. Agent poverený niečo zaznamenať prepísal existujúci súbor novým. Náprava: pred zápisom čítať, pri existujúcom obsahu pripájať alebo upravovať, a zapisovať iba do prázdnych alebo nových súborov.

Kedy nedeliť

Tento vzor sa dá ľahko nadužívať. Tri signály, že by sa doména nemala stať samostatným agentom.

Menej než hŕstka úloh mesačne. Špecialista, ktorý beží zriedka, je definičný súbor, ktorý zastará — jeho nástroje sa menia, jeho doménové pravidlá sa rozchádzajú a nikto si to nevšimne, pretože ho nič netestuje. Keď sa nakoniec spustí, beží na predpokladoch spred mesiacov.

Žiadna odlišná sada nástrojov. Ak navrhovaný agent používa presne tie isté nástroje, aké má už orchestrátor, rozdelenie neprináša nič okrem štartu za studena. Prínos pochádza zo zúženia plochy nástrojov; bez toho ide iba o réžiu v prezlečení.

Hranica, ktorú nemožno vyjadriť ako odmietnutie. Ak nedokážete napísať riadok NEPATRÍ SEM — čo tento agent musí odmietnuť a kam to má ísť namiesto toho — doména ešte nie je oddeliteľná. Pokus o rozdelenie aj tak vyprodukuje dvoch agentov, ktorí obaja napoly vlastnia tú istú prácu, a rozhodnutie o smerovaní sa stane hodom mincou, ktorý sa robí nanovo zakaždým.

Za zmienku stojí aj opačný signál. Doména si zaslúži vlastného agenta vtedy, keď orchestrátor pri jednom type otázky opakovane načítava tie isté 3 alebo 4 referenčné súbory spolu. Tento vzor spoločného načítavania je doménou, ktorá sa sama hlási, a je viditeľný v tabuľke spúšťačov ešte skôr, než sa niekto rozhodne ho formalizovať.

Súbory

Jeden definičný súbor na agenta — popis, nástroje, domény, zoznam odmietnutí a vstavaný rámcový stack pre jeho špecializáciu. Jedna smerovacia tabuľka mapujúca tvary úloh na agentov. Jedna párovacia tabuľka pre paralelné prípady. Jeden log dispečingov, zapisovaný automaticky.

Smerovacia tabuľka je práve tá časť, ktorá potrebuje najviac údržby a dostáva jej najmenej, pretože nesprávna trasa produkuje vierohodný výstup namiesto chyby.

Pozri tiež

the-library-behind-the-agent · memory-as-files · the-five-field-handoff

[Dvanásť agentov, jedna pamäť](https://stillvalid.dev/sk/architecture/twelve-agents-one-memory) — stillvalid, SV-5002 (deep-dive, verified 2026-08-14)