StellarBase
Dokumentace StellarBase platforma Workflow
StellarBase platforma

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žekJednorázová otázka
Auditor potřebuje stopu, jak odpověď vzniklaVolné 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

TriggerUse case
Plán (cron)Noční dohled, týdenní reporty, měsíční fakturace
Nový dokumentZpracovat každý nový soubor ve složce
WebhookExterní systém POSTuje pro spuštění
Manuální / on-demandUživatel klikne na „Run” v UI
Řetězec workflowJiné workflow doběhne
Příchod e-mailuNová 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