Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Omezení platformy

Lekce 10 z 14 Aktualizováno 29. července 2026 Pokročilý
Na této stránce
  1. Poznej limity
  2. Dvě sekundy mezi každou aktivitou
  3. Dva megabajty na jedno volání
  4. Rozpočet událostí a objemu
  5. Žádné I/O ve workflow
  6. Klíčové poznatky

Poznej limity

Platforma Mistral Workflows je ve fázi Public Preview (k dubnu 2026). Jako každý orchestračný systém ukládá technická omezení, která musíš znát, abys navrhl robustní workflow. Tyto limity nejsou jen poznámkami pod čarou v dokumentaci; objeví se v produkci, často až v pozdní fázi, jako chyby serializace nebo neočekávaně ukončená workflow bez varování v tvém kódu. Znalost těchto omezení předem změní způsob, jakým strukturuješ svou zpracovatelskou logiku.

Následující tabulka shrnuje klíčová omezení a konkrétní důsledek jejich překročení.

Omezení Hodnota Důsledek překročení
Prodleva mezi aktivitami 2 sekundy Neodstranitelná latence mezi každým voláním aktivity
Vstup/výstup na jedno volání 2 MB Chyba serializace, workflow selže
Události na jedno spuštění 51 200 Workflow násilně ukončeno
Celková velikost na jedno spuštění 50 MB Workflow násilně ukončeno
Výchozí časový limit 1 hodina Workflow zrušeno (lze nastavit až na 7 dní)
Maximální časový limit 7 dní Workflow automaticky zrušeno
I/O ve workflow Zakázáno Chyba nedeterminismu během replaye

Dvě sekundy mezi každou aktivitou

Platforma vynucuje minimální prodlevu 2 sekund mezi voláními aktivit. Tato latence není dětskou nemocí; je inherentní součástí architektury orchestrace, která před pokračováním persistuje každou událost. Je to cena za odolnost.

Dopad se snadno spočítá a často překvapí. Workflow řetězící deset sekvenčních aktivit spotřebuje alespoň dvacet sekund času orchestrace, bez ohledu na to, jak dlouho samotné aktivity běží. Pokud každá aktivita běží padesát milisekund, navrhl jsi půlsekundovou úlohu, která vrátí výsledek až za dvacet sekund.

Řešením je sloučit operace, které nemusí být oddělené, do jediné aktivity. Porovnej tyto dvě verze stejného NLP pipeline.

# SUBOPTIMÁLNÍ: 3 aktivity = 6 sekund latence orchestrace
@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 latence orchestrace
@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 pro rozdělení se stává jednoduchým: vytvoř samostatnou aktivitu pouze tehdy, pokud potřebuješ záruku persistence mezi dvěma operacemi. Pokud mohou dvě operace selhat společně bez způsobení problémů – jako je lokální tokenizace a výpočet embeddingů řetězené v paměti – sluč je dohromady.

Dva megabajty na jedno volání

Každé volání aktivity je omezeno na 2 MB pro vstup a 2 MB pro výstup, na základě serializované JSON reprezentace dat. PDF report, sada obrázků nebo velký export CSV toto omezení snadno překročí, což způsobí selhání workflow s chybou serializace.

Řešení je jedna věta: předávej reference, nikdy ne payloady. Aktivita stáhne data z externího úložiště, zpracuje je lokálně (kde je omezena pouze pamětí workeru) a vrátí URL výsledku.

@workflows.activity()
async def traiter_gros_fichier(fichier_url: str) -> dict:
    """Stáhnout, zpracovat a znovu nahrát soubor.
    Přes workflow procházejí pouze URL."""
    async with httpx.AsyncClient() as client:
        # Stáhnout z S3/GCS
        response = await client.get(fichier_url)
        contenu = response.content  # Může být 100 MB

        # Zpracovat soubor
        resultat = traiter(contenu)

        # Nahrát výsledek
        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 událostí a objemu

Každé spuštění je omezeno na 51 200 událostí. Platforma generuje událost pro každé spuštění aktivity, každé dokončení aktivity, každý přijatý signál a každý spuštěný časovač. V praxi stojí volání aktivity asi dvě až tři události, jakmile se započítají metadata, což staví workflow se sto aktivitami na zhruba 250 až 300 událostí. Jinými slovy, limit umožňuje patnáct až dvacet tisíc volání aktivit na jedno spuštění: daleko nad rámec toho, co vyžaduje většina případů použití.

Tohoto limitu dosáhneš pouze při hromadném zpracování – například při iteraci padesáti tisíci dokumenty v rámci jednoho spuštění. Vzorec pokračování (continuation pattern), podrobně popsaný v další lekci, toto řeší: workflow zpracuje dávku a poté spustí nové workflow pro další dávku, čímž resetuje čítač událostí.

Druhé omezení se týká objemu: kumulativní velikost všech událostí ve spuštění nesmí překročit 50 MB. To se rychle zaplní, pokud tvé aktivity vracejí bohaté objekty, protože každý výsledek se zapisuje do logu. Platí stejný reflex – vracej identifikátor místo celé struktury, ukládej průběžné výsledky do externí služby, zpracovávej po dávkách s stránkováním – a ve velké většině případů to stačí.

Žádné I/O ve workflow

Poslední řádek tabulky není limit velikosti, ale pravidlo návrhu, již pokryté pod tématem determinismu. Kód workflow nesmí obsahovat žádné operace vstup/výstup: žádná síťová volání (httpx, aiohttp, requests), žádné čtení nebo zápis souborů (open, aiofiles), žádný přístup k databázi a žádné čtení proměnných prostředí pro řízení větvení. Všechny tyto operace patří do aktivit, jejichž výsledky jsou logovány, a tedy identicky replayovatelné.

Klíčové poznatky

  • Minimální latence 2 sekundy mezi každou aktivitou – slučuj související operace
  • Maximum 2 MB na vstup/výstup aktivity – pro velká data použij externí úložiště
  • Maximum 51 200 událostí a 50 MB na spuštění – pro velmi dlouhá workflow použij vzorec pokračování
  • Žádné I/O v kódu workflow – vše patří do aktivit
  • Tato omezení vyplývají z podkladové architektury Temporal a stavu Public Preview