Piirangud platvormil
Sellel lehel
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