Obmedzenia platformy
Na tejto strane
Poznaj svoje limity
Platforma Mistral Workflows je vo fáze verejnej ukážky (Public Preview) (k aprílu 2026). Ako každý orchestračný systém ukladá technické obmedzenia, ktoré musíš pochopiť, aby si navrhol robustné workflow. Tieto limity nie sú len poznámkami v dokumentácii; objavujú sa v produkcii, často až neskoro v procese, ako chyby serializácie alebo neočakávane ukončené workflow bez varovania v tvojom kóde. Ich včasná znalosť mení spôsob, akým štruktúruješ svoju logiku spracovania.
Nižšie uvedená tabuľka sumarizuje kľúčové obmedzenia a konkrétne dôsledky ich prekročenia.
| Obmedzenie | Hodnota | Dôsledok prekročenia |
|---|---|---|
| Oneskorenie medzi aktivitami | 2 sekundy | Nevyhnutná latencia medzi každým volaním aktivity |
| Vstup/výstup na jedno volanie | 2 MB | Chyba serializácie, workflow zlyhá |
| Udalosti na jedno spustenie | 51 200 | Workflow násilne ukončené |
| Celková veľkosť na jedno spustenie | 50 MB | Workflow násilne ukončené |
| Predvolený časový limit | 1 hodina | Workflow zrušené (konfigurovateľné až na 7 dní) |
| Maximálny časový limit | 7 dní | Workflow automaticky zrušené |
| I/O vo workflow | Zakázané | Chyba nedeterminizmu počas replayu |
Dve sekundy medzi každou aktivitou
Platforma vynucuje minimálne 2-sekundové oneskorenie medzi volaniami aktivít. Táto latencia nie je detskou chorobou; je neodmysliteľnou súčasťou architektúry orchestrácie, ktorá pred pokračovaním persistuje každú udalosť. Je to cena za odolnosť voči výpadkom.
Dopad sa ľahko vypočíta a často prekvapí. Workflow, ktoré reťazí desať sekvenčných aktivít, spotrebuje aspoň dvadsať sekúnd času orchestrácie, bez ohľadu na to, ako dlho trvajú samotné aktivity. Ak každá aktivita beží päťdesiat milisekúnd, navrhol si polsekundovú úlohu, ktorej vrátenie výsledku trvá dvadsať sekúnd.
Riešením je zlučovanie operácií, ktoré nemusia byť oddelené, do jednej aktivity. Porovnaj tieto dve verzie toho istého NLP pipeline.
# SUBOPTIMÁLNE: 3 aktivity = 6 sekúnd latencie orchestrácie
@workflows.workflow.define(name="pipeline_lent")
class SlowPipeline:
@workflows.workflow.entrypoint
async def run(self, text: str) -> dict:
tokens = await tokenize(text)
embeddings = await calculate_embeddings(tokens)
clusters = await cluster(embeddings)
return clusters
# OPTIMALIZOVANÉ: 1 aktivita = 2 sekundy latencie orchestrácie
@workflows.activity()
async def complete_nlp_processing(text: str) -> dict:
tokens = tokenize_local(text)
embeddings = calculate_embeddings_local(tokens)
clusters = cluster_local(embeddings)
return {"clusters": clusters}
@workflows.workflow.define(name="pipeline_rapide")
class FastPipeline:
@workflows.workflow.entrypoint
async def run(self, text: str) -> dict:
return await complete_nlp_processing(text)
Pravidlo pre rozdelenie sa stáva jednoduchým: vytvor samostatnú aktivitu len vtedy, ak potrebuješ záruku persistencie medzi dvoma operáciami. Ak môžu dve operácie zlyhať spoločne bez spôsobenia problémov – ako lokálna tokenizácia a výpočet vektorových reprezentácií (embeddings) reťazené v pamäti – zluč ich.
Dva megabajty na jedno volanie
Každé volanie aktivity je obmedzené na 2 MB pre vstup a 2 MB pre výstup, pričom sa vychádza zo serializovanej JSON reprezentácie dát. PDF správa, sada obrázkov alebo veľký export CSV toto obmedzenie ľahko prekročia, čo spôsobí zlyhanie workflow s chybou serializácie.
Riešením je jedna veta: odovzdávaj referencie, nikdy nie payloady. Aktivita si stiahne dáta z externého úložiska, spracuje ich lokálne (kde je obmedzená len pamäťou workeru) a vráti URL výsledku.
@workflows.activity()
async def traiter_gros_fichier(fichier_url: str) -> dict:
"""Stiahnuť, spracovať a znovu nahrať súbor.
Cez workflow prechádzajú len URL."""
async with httpx.AsyncClient() as client:
# Stiahnuť z S3/GCS
response = await client.get(fichier_url)
contenu = response.content # Môže byť 100 MB
# Spracovať súbor
resultat = traiter(contenu)
# Nahrať výsledok
await client.put(
"https://storage.example.com/résultats/output.json",
content=resultat
)
return {"url_resultat": "https://storage.example.com/résultats/output.json"}
Rozpočet na udalosti a objem
Každé spustenie je obmedzené na 51 200 udalostí. Platforma generuje udalosť pre každý štart aktivity, každé dokončenie aktivity, každý prijatý signál a každý spustený časovač. V praxi stojí volanie aktivity asi dve až tri udalosti po započítaní metadát, čo znamená, že workflow so sto aktivitami sa pohybuje okolo 250 až 300 udalostí. Inými slovami, limit umožňuje pätnásť až dvadsaťtisíc volaní aktivít na jedno spustenie: ďaleko nad rámec toho, čo vyžaduje väčšina prípadov použitia.
Tento limit narazíš len pri hromadnom spracovaní – napríklad pri iterácii cez päťdesiattisíc dokumentov v rámci jedného spustenia. Vzorec pokračovania (continuation pattern), podrobne opísaný v nasledujúcej lekcii, toto rieši: workflow spracuje dávku, potom spustí nové workflow pre ďalšiu dávku a tým resetuje počítadlo udalostí.
Druhým obmedzením je objem: kumulatívna veľkosť všetkých udalostí v rámci jedného spustenia nesmie presiahnuť 50 MB. Toto sa zaplní rýchlejšie, ak tvoje aktivity vracajú bohaté objekty, keďže každý výsledok sa zapisuje do logu. Platí rovnaký reflex – vráť identifikátor namiesto celej štruktúry, ukladaj priebežné výsledky do externej služby, spracúvaj po dávkach s pagináciou – a vo veľkej väčšine prípadov to stačí.
Žiadne I/O vo workflow
Posledný riadok tabuľky nie je limitom veľkosti, ale pravidlom návrhu, ktoré už bolo pokryté v kontexte determinizmu. Kód workflow nesmie obsahovať žiadne operácie vstup/výstup (I/O): žiadne sieťové volania (httpx, aiohttp, requests), žiadne čítanie alebo zápis súborov (open, aiofiles), žiadny prístup k databáze a žiadne čítanie premenných prostredia na riadenie vetvenia. Všetky tieto operácie patria do aktivít, ktorých výsledky sa logujú, a sú preto identicky replayovateľné.
Kľúčové poznatky
- Minimálna latencia 2 sekundy medzi každou aktivitou – zlučuj súvisiace operácie
- Maximum 2 MB na vstup/výstup aktivity – pre veľké dáta použi externé úložisko
- Maximum 51 200 udalostí a 50 MB na jedno spustenie – pre veľmi dlhé workflow použi vzorec pokračovania
- Žiadne I/O v kóde workflow – všetko patrí do aktivít
- Tieto obmedzenia vyplývajú zo základnej architektúry Temporal a stavu verejnej ukážky (Public Preview)