Multi-agent workflow
Jedna stránka na dve súvisiace veci: najprv (voliteľne) vygenerovať jednu súvislú produktovú špecifikáciu workshopom, potom ju použiť ako vstup do hlavného multi-agent workflow (plan alebo execute). Všetko beží na serveri ako job + SSE; tento prehliadač len posiela telo požiadavky a počúva stream.
OPENAI_API_KEY. GUI už neposiela Bearer token.
-
Ktorý repozitár: len výber priečinka (projektu) pod serverovým
WORKSPACE_ROOT— nie zadávanie cesty k disku v GUI. - Spoločný kontext: cieľ, projekt, fáza — kopírujú sa do workshopu aj do hlavného workflow.
- (Voliteľné) Workshop špecifikácie: session → job → výsledok do textového poľa → úpravy / refine → potvrdenie.
-
Implementácia: skopíruj špecifikáciu do poľa „Biznis
špecifikácia“ a spusti workflow (najčastejšie
plan, neskôrexecute).
Výber projektu (git clone vo workspace)
Kde na disku sú uložené naklonované projekty, určuje výhradne konfigurácia
servera: premenná WORKSPACE_ROOT v .env (predvolené
relatívne data/projects). Z GUI nastavuješ iba to,
ktorý podpriečinok v tomto sklade — teda o aký produkt / repo ide.
Agenti vyhľadávajú kontext z koreňa vybraného projektu (úryvky súborov, nie celý repo). Ak nevyberieš projekt, použije sa pracovný adresár procesu servera (vhodné len na lokálny vývoj).
Uložené workflow behy
Záznamy z tabuľky workflow_runs (vyžaduje DATABASE_URL).
API: GET /api/runs,
GET /api/runs/:id.
| ID | Čas | Mode | Workflow | Cieľ (náhľad) | Tokens |
|---|
Diagnostiku sleduj pri vybratom prompte v sekcii Diagnostika nižšie.
Ucelený popis flowu pred kódovaním
Tu LLM simuluje viacerých product managerov (odlišné „persony“)
a potom viacerých klientov. Najprv sa zlúči PM pohľad do
konceptu špecifikácie, potom klienti zpochybňujú návrh; na záver vznikne jedna
markdown špecifikácia (sekcie flowov, kritériá, riziká…). Je to samostatný
POST …/product-spec/sessions/:id/run-workshop job —
línia v logu začína značkou [spec].
Vyšší počet = dlhší a drahší beh; čísla sú horný limit — presné mená profilov dopĺňa server predvolenými personami, ak nepošleš vlastné z API.
Tu len spúšťaš/stopuješ workshop pre aktuálny prompt.
Refine = jeden produktový agent prepíše celý dokument podľa poľa steering (musí byť neprázdne). Najprv ulož ručné úpravy tlačidlom „Uložiť“, ak chceš mať konzistentný stav na serveri.
Plan / execute nad repozitárom
Toto je existujúci orchestrátor (runMultiAgentWorkflow): Product →
Tester → Developer → simulovaní klienti → rozhodnutie → voliteľne vývojársky cyklus
→ infra/design/tester/reviewer. Pole „Biznis špecifikácia“ zo
spoločných vstupov vyššie sa posiela ako
businessSpec. „Počet client agentov“ tu je len pre tento workflow (nie
pre workshop).
Audit a komunikácia agentov
Prompt: —
Agenti pracujú…
Najprv riadky auditu (kto v ktorom kroku beží), potom boxy s ich výstupmi a úvahami.
Keď nič nebeží, môžeš doplniť ďalší pokyn — zlúči sa s uloženou špecifikáciou alebo kódom a so súhrnom predchádzajúceho behu.
Finálny výsledok
Dry-run diffov (per-hunk accept/reject)
Vlož JSON pole edits (alebo celý plán z ktorého sa pole
vytiahne). Server vypočíta navrhované zmeny bez zápisu.
Pre každý súbor ti zobrazí jednotlivé „hunks“ (bloky diffu) s checkboxmi —
tie začiarknuté sa uložia na disk, ostatné sa zahodia.
Plán → epiky → stories → build
Najprv vygeneruj plán z user-goal + (voliteľne) naposledy uloženej štruktúrovanej špecifikácie. Potom spúšťaj jednotlivé stories — každá spustí samostatný execute beh (architect → infra/design → test-author → developer loop → reviewer → spec-reconcile).