Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Piirangud platvormil

Õppetund 10 / 14 Värskendatud 29. juuli 2026 Edasijõudnutele
Sellel lehel
  1. Tunneta piire
  2. Kaks sekundit iga tegevuse vahel
  3. Kaks megabaiti ühe väljakutse kohta
  4. Sündmuste ja mahu eelarve
  5. Puudub S/V töövoos
  6. Peamised punktid

Tunneta piire

Mistral Workflowsi platvorm on avalikus eelvaates (seisuga aprill 2026). Nagu iga orkestreerimissüsteem, kehtestab see tehnilised piirangud, mida pead mõistma, et kujundada töökindlaid töövooge. Need piirangud ei ole lihtsalt dokumentatsiooni jaluse märkused; need ilmnevad tootmises, sageli alles hilises faasis, serialiseerimisvigade või ootamatult katkenud töövoogudena, millele sinu koodis hoiatust ei leidu. Nende eelnev tundmine muudab viisi, kuidas oma töötlemisloogikat üles ehidad.

Allpool olev tabel võtab kokku peamised piirangud ja konkreetsed tagajärjed igaühe ületamisel.

Piirang Väärtus Tagajärg ületamisel
Viide tegevuste vahel 2 sekundit Vältimatu latentsus iga tegevuse väljakutse vahel
Sisend/väljund ühe väljakutse kohta 2 MB Serialiseerimisviga, töövoog nurjub
Sündmusi ühe täitmise kohta 51 200 Töövoog sunniviisiliselt lõpetatud
Kogumaht ühe täitmise kohta 50 MB Töövoog sunniviisiliselt lõpetatud
Vaikimisi aegumine 1 tund Töövoog tühistatud (seadistatav kuni 7 päevani)
Maksimaalne aegumine 7 päeva Töövoog automaatselt tühistatud
S/V töövoogudes Keelatud Mittedeterminismi viga taasesitamisel

Kaks sekundit iga tegevuse vahel

Platvorm jõustab tegevuste väljakutsete vahel minimaalse 2-sekundilise viite. See latentsus ei ole kasvuraskus; see on orkestreerimise arhitektuuri lahutamatu osa, mis salvestab iga sündmuse enne jätkamist. See on vastupidavuse hind.

Mõju on lihtne arvutada ja sageli üllatav. Töövoog, mis aheldab kümme järjestikust tegevust, tarbib vähemalt kakskümmend sekundit orkestreerimisaega, sõltumata sellest, kui kaua tegevused ise kestavad. Kui iga tegevus jookseb viiskümmend millisekundit, oled kujundanud poolesekundilise töö, mille tulemuse saamiseks kulub kakskümmend sekundit.

Lahenduseks on koondada toimingud, mis ei pea olema eraldatud, üheks tegevuseks. Võrdle neid kahte versiooni samast NLP torustikust.

# ALLOPTIMAALNE: 3 tegevust = 6 sekundit orkestreerimise latentsust
@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

# OPTIMEERITUD: 1 tegevus = 2 sekundit orkestreerimise latentsust
@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)

Jagamise reegel muutub lihtsaks: loo eraldi tegevus ainult siis, kui vajad kahe toimingu vahel püsivuse garantiid. Kui kaks toimingut võivad koos nurjuda ilma probleeme tekitamata – nagu kohalik tokeniseerimine ja manuste arvutamine, mis on aheldatud mälus – koonda need.

Kaks megabaiti ühe väljakutse kohta

Iga tegevuse väljakutse on piiratud 2 MB-ga sisendi ja 2 MB-ga väljundi jaoks, lähtudes andmete serialiseeritud JSON-esitusest. Aruande PDF, piltide komplekt või suur CSV-eksport ületavad seda kergesti, põhjustades töövoogu nurjumise serialiseerimisveaga.

Lahendus mahub ühte lausesse: edasta viiteid, mitte andmemahte. Tegevus laeb andmed välisest salvestusruumist alla, töötleb need kohapeal (kus neid piirab vaid töötaja mälu) ja tagastab tulemuse URL-i.

@workflows.activity()
async def traiter_gros_fichier(fichier_url: str) -> dict:
    """Laadi fail alla, töötle ja laadi uuesti üles.
    Ainult URL-id läbivad töövoogu."""
    async with httpx.AsyncClient() as client:
        # Laadi alla S3/GCS-ist
        response = await client.get(fichier_url)
        contenu = response.content  # Võib olla 100 MB

        # Töötle fail
        resultat = traiter(contenu)

        # Laadi tulemus üles
        await client.put(
            "https://storage.example.com/résultats/output.json",
            content=resultat
        )

    return {"url_resultat": "https://storage.example.com/résultats/output.json"}

Sündmuste ja mahu eelarve

Iga täitmine on piiratud 51 200 sündmusega. Platvorm genereerib sündmuse iga tegevuse käivitamise, iga tegevuse lõpetamise, iga vastuvõetud signaali ja iga käivitatud taimeri jaoks. Praktikas maksab tegevuse väljakutse metaandmete arvestamisel umbes kaks kuni kolm sündmust, asetades sajategevuselise töövoogu 250 kuni 300 sündmuse juurde. Teisisõnu võimaldab piirang viieteistkümnet kuni kahekümnet tuhandet tegevuse väljakutset ühe täitmise kohta: palju rohkem, kui enamik kasutusjuhte nõuab.

Selle piiranguni jõuad vaid mahutöötluse korral – näiteks iteratsioon viiekümne tuhande dokumendi üle ühes täitmises. Jätkumise muster, mida kirjeldatakse järgmises tunnis, lahendab selle: töövoog töötleb partii ja käivitab seejärel järgmise partii jaoks uue töövoogu, lähtestades sündmuste loenduri.

Teine piirang puudutab mahtu: kõigi sündmuste kumulatiivne suurus ühes täitmises ei tohi ületada 50 MB-t. See täitub kiiremini, kui sinu tegevused tagastavad rikkalikke objekte, kuna iga tulemus kirjutatakse logisse. Kehtib sama refleks – tagasta identifikaator täisstruktuuri asemel, salvesta vahe tulemused välisesse teenusesse, leheküljenda töötlemine partiidesse – ja sellest piisab valdaval enamikul juhtudel.

Puudub S/V töövoos

Viimane rida tabelis ei ole suuruse piirang, vaid kujundusreegel, mida juba käsitleti determinismi kontekstis. Töövoogu kood ei tohi sisaldada sisend/väljund toiminguid: puuduvad võrgukõned (httpx, aiohttp, requests), failide lugemine või kirjutamine (open, aiofiles), andmebaasi juurdepääs ja keskkonnamuutujate lugemine harude suunamiseks. Kõik need toimingud kuuluvad tegevustesse, mille tulemused logitakse ja on seetõttu identselt taasesitatavad.

Peamised punktid

  • 2 sekundit minimaalne latentsus iga tegevuse vahel – koonda seotud toimingud
  • 2 MB maksimum tegevuse sisendi/väljundi kohta – kasuta suurte andmete jaoks välist salvestusruumi
  • 51 200 sündmust ja 50 MB maksimum ühe täitmise kohta – kasuta väga pikkade töövoogude jaoks jätkumise mustrit
  • Puudub S/V töövoogu koodis – kõik kuulub tegevustesse
  • Need piirangud tulenevad aluseks olevast Temporal arhitektuurist ja avaliku eelvaate staatusest