Workflows
Deterministické pipeliny, které orchestrují agenty, nástroje a data do opakovatelných procesů. Stejné vstupy produkují stejné výstupy, pokaždé. Vizuální editor nebo postavené agentem — vaše volba.
🛠 Ve vývoji — Q3 2026. Model a typy uzlů popsané zde odpovídají tomu, co stavíme. Vizuální editor, definice postavené agentem a externí triggery budou postupně k dispozici během Q3 2026.
Co je workflow
Workflow je orientovaný graf uzlů. Každý uzel dělá jednu věc: stáhne data, transformuje je, zavolá agenta, směruje podle podmínky, zapíše výstup. Hrany definují tok dat.
Workflows jsou deterministické — při stejném vstupu stejné workflow produkuje stejnou strukturu výstupu (modulo přirozená variance LLM). Tohle odlišuje workflow od „nech to agenta vyřešit”. Workflows jsou auditovatelné, opakovatelné a paralelizovatelné.
Kdy použít workflow vs. jen agenta
| Použijte workflow, když… | Použijte jen agenta, když… |
|---|---|
| Úloha běží na plán | Úloha je interaktivní / konverzační |
| Výstup teče do jiného systému (CSV, DB, e-mail) | Výstup čte člověk |
| Potřebujete pokaždé přesně stejné zpracování | Uživatel formuje požadavek pokaždé jinak |
| Potřebujete paralelizovat přes mnoho položek | Jednorázová otázka |
| Auditor potřebuje stopu, jak odpověď vznikla | Volné prozkoumávání |
Typy uzlů
Zdrojové uzly
Odkud data přicházejí. Nové dokumenty ve sledované složce, řádky z databázového dotazu, webhook payloady, scheduled tick.
Zpracovací uzly
Čisté transformace. StellarOCR na dokumentu, detekce jazyka, anonymizace, validace schématu, převod typů.
Agent uzly
Zavolá nakonfigurovaného agenta s upstream daty. Výstup agenta (strukturovaný dle jeho schématu) teče dál.
Model uzly
Volají konkrétní model přímo — váš vlastní klasifikátor, externí API, lokální LLM. Levnější než plné volání agenta, když nepotřebujete uvažování.
Routing uzly
Podmíněné větvení. „Pokud risk_level == HIGH, směruj na compliance schválení; jinak směruj na standardní výstup.”
Approval uzly
Human-in-the-loop brány. Workflow se pozastaví; určený reviewer schválí / upraví / zamítne; workflow pokračuje (nebo končí).
Výstupní uzly
Kam data jdou. CSV soubor, řádek databáze, e-mail, Slack notifikace, webhook do externího systému.
Stavba workflow
Vizuální editor
Přetáhněte uzly na canvas, propojte je šipkami, nakonfigurujte parametry každého uzlu. Live validace brání nevalidním grafům (cykly, type mismatche, chybějící povinná pole). Otestujte s ukázkovými vstupy, než pustíte do provozu.
Postavené agentem
Popište workflow přirozeným jazykem orchestrátorovi: „Pro každou novou smlouvu nahranou do M&A složky spusť StellarOCR, detekuj typ smlouvy, směruj k odpovídajícímu reviewer agentovi a vytvoř řádek risk registru.” Agent vygeneruje graf workflow; vy ho zrevidujete a upravíte.
Triggery
| Trigger | Use case |
|---|---|
| Plán (cron) | Noční dohled, týdenní reporty, měsíční fakturace |
| Nový dokument | Zpracovat každý nový soubor ve složce |
| Webhook | Externí systém POSTuje pro spuštění |
| Manuální / on-demand | Uživatel klikne na „Run” v UI |
| Řetězec workflow | Jiné workflow doběhne |
| Příchod e-mailu | Nová zpráva odpovídající filtru |
Determinismus a reruny
Každý běh je zaznamenaný s vstupy, mezivýstupy a finálním výsledkem. Můžete rerunout libovolný minulý běh se stejnými vstupy a ověřit, že výstup je konzistentní. Pokud změníte definici workflow, verze se zvýší — staré běhy odkazují na starou verzi, nové běhy používají novou.
Reruny jsou užitečné pro:
- Ověření opravy (vyprodukovala naše oprava jiný výstup?)
- What-if analýzu (označil by nový prompt tenhle případ?)
- Backfill (spusťte nové workflow proti historickým datům)
Paralelizace
Workflows zpracovávající mnoho položek (1 000 smluv, 4 000 pacientských reportů) se paralelizují automaticky. Platforma rozhoduje o souběžnosti podle rate limitů a vašeho tieru. Vidíte celkový postup i stav jednotlivých položek.
Error handling
Per-node retry politiky (default: 3 retries s exponenciálním backoffem). Trvalá selhání směřují do dead-letter fronty s důvodem selhání. Workflow pokračuje s ostatními položkami — jeden špatný vstup nezastaví běh.
Pro workflows, kde částečné dokončení není přijatelné (finanční uzávěrka, audit reporty), nakonfigurujte „all-or-nothing” sémantiku: jakékoli selhání rollbackuje všechny výstupy.
Observability
Pro každý běh:
- Čas zahájení, čas konce, doba trvání
- Doba per uzel (najdete pomalé kroky)
- Spotřeba tokenů (atribuce LLM nákladů)
- Počet chyb, počet retries
- Náhled výstupu
Trendy napříč běhy (týdenní běh trval včera 1 h, dnes 3 h — co se změnilo?) pomáhají ladit.
Sdílení a oprávnění
Workflows jsou Base-scoped. Uvnitř Base řídíte, kdo může:
- Zobrazit definici workflow
- Spustit on-demand běhy
- Editovat workflow
- Schvalovat human-in-the-loop brány
Příklady z případových studií
- Právo: ingest smlouvy → anonymizace → klasifikace typu → routing ke specializovanému agentovi → anotace Word + řádek risk registru
- Finance: ingest pojistky → anonymizace → extrakce struktury → routing po linii → řádek portfoliového porovnání
- Medicína: EHR pull → PHI anonymizace → souhrn případu → guideline + literatura → tumor board pack
- Výroba: SCADA telemetrie → CMMS kontext → anomaly model → specializovaný agent zařízení → work order
- Státní správa: zpráva příjemce → anonymizace PII → klasifikace programu → ESF+ / Procurement / Anomaly agenti → compliance register
Související
- Agents — stavební bloky logiky workflow
- Chat — volání workflows konverzačně
- Collaboration — schvalovací toky
