Omejitve platforme
Na tej strani
Spoznaj omejitve
Platforma Mistral Workflows je v fazi javnega predogleda (stanje april 2026). Kot vsak sistem za orkestracijo nalaga tehnične omejitve, ki jih moraš razumeti, da zasnuješ robustne delovne tokove. Te omejitve niso le opombe v dokumentaciji; pojavijo se v produkcijskem okolju, pogosto pozno v procesu, kot napake pri serializaciji ali nepričakovano prekinjeni delovni tokovi brez opozorila v tvoji kodi. Poznavanje teh omejitev vnaprej spremeni način, kako strukturiraš svojo logiko obdelave.
Spodnja tabela povzema ključne omejitve in konkretne posledice njihovega presežka.
| Omejitev | Vrednost | Posledica presežka |
|---|---|---|
| Zamik med aktivnostmi | 2 sekundi | Neizogibna zakasnitev med vsakim klicem aktivnosti |
| Vhod/izhod na priklic | 2 MB | Napaka pri serializaciji, delovni tok odpove |
| Dogodki na izvedbo | 51.200 | Delovni tok prisilno končan |
| Skupna velikost na izvedbo | 50 MB | Delovni tok prisilno končan |
| Privzeta časovna omejitev | 1 ura | Delovni tok preklican (nastavljivo do 7 dni) |
| Najdaljša časovna omejitev | 7 dni | Delovni tok samodejno preklican |
| V/I v delovnih tokovih | Prepovedano | Napaka nedeterminizma med ponovnim predvajanjem |
Dve sekundi med vsako aktivnostjo
Platforma vsiljuje najmanjši zamik 2 sekund med klici aktivnosti. Ta zakasnitev ni otroška bolezen razvoja; inherentna je arhitekturi orkestracije, ki pred nadaljevanjem trajno shrani vsak dogodek. To je cena za obstojnost.
Vpliv je enostavno izračunati in pogosto presenetljiv. Delovni tok, ki zaporedno poveže deset aktivnosti, porabi vsaj dvajset sekund časa orkestracije, ne glede na to, koliko časa same aktivnosti trajajo. Če vsaka aktivnost teče petdeset milisekund, si zasnoval polsekundno opravilo, ki za vrnitev rezultata potrebuje dvajset sekund.
Rešitev je združevanje operacij, ki ne potrebujejo ločenega izvajanja, v eno samo aktivnost. Primerjaj ti dve različici istega pipeline-a za obdelavo naravnega jezika (NLP).
# PODOPTIMALNO: 3 aktivnosti = 6 sekund zakasnitve orkestracije
@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
# OPTIMIZIRANO: 1 aktivnost = 2 sekundi zakasnitve orkestracije
@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)
Pravilo za razdeljevanje postane preprosto: ustvari ločeno aktivnost le, če med dvema operacijama potrebuješ garancijo trajnosti. Če lahko dve operaciji skupaj odpoveta brez težav – kot sta lokalna tokenizacija in izračun vgraditev, povezani v pomnilniku – ju združi.
Dva megabajta na priklic
Vsak klic aktivnosti je omejen na 2 MB za vhod in 2 MB za izhod, kar temelji na serializirani JSON reprezentaciji podatkov. PDF poročilo, niz slik ali velik izvoz CSV bo to zlahka presegel in povzročil odpoved delovnega toka z napako pri serializaciji.
Rešitev je en stavek: posreduj reference, nikoli vsebine. Aktivnost prenese podatke iz zunanjega shrambe, jih obdela lokalno (kjer je omejena le s pomnilnikom delavca) in vrne URL rezultata.
@workflows.activity()
async def traiter_gros_fichier(fichier_url: str) -> dict:
"""Prenesi, obdelaj in ponovno naloži datoteko.
Skozi delovni tok potujejo le URL-ji."""
async with httpx.AsyncClient() as client:
# Prenos iz S3/GCS
response = await client.get(fichier_url)
contenu = response.content # Lahko znaša 100 MB
# Obdelava datoteke
resultat = traiter(contenu)
# Naloži rezultat
await client.put(
"https://storage.example.com/résultats/output.json",
content=resultat
)
return {"url_resultat": "https://storage.example.com/résultats/output.json"}
Proračun dogodkov in prostornine
Vsaka izvedba je omejena na 51.200 dogodkov. Platforma ustvari dogodek za vsak začetek aktivnosti, vsak zaključek aktivnosti, vsak prejeti signal in vsak sprožen časovnik. V praksi klic aktivnosti stane približno dva do tri dogodke, ko se upoštejo metapodatki, kar pomeni, da delovni tok s sto aktivnostmi porabi med 250 in 300 dogodkov. Z drugimi besedami, omejitev omogoča petnajst do dvajset tisoč klicev aktivnosti na izvedbo: daleč več, kot zahteva večina primerov uporabe.
To omejitev boš dosegel le pri obsežni obdelavi – na primer pri iteraciji skozi petdeset tisoč dokumentov v eni sami izvedbi. Vzorec nadaljevanja, podrobneje opisan v naslednji lekciji, to reši: delovni tok obdela serijo podatkov, nato pa za naslednjo serijo sproži nov delovni tok, s čimer se števec dogodkov ponastavi.
Druga meja se nanaša na prostornino: kumulativna velikost vseh dogodkov v izvedbi ne sme preseči 50 MB. To se hitreje zapolni, če tvoje aktivnosti vračajo bogate objekte, saj se vsak rezultat zapiše v dnevnik. Uporabi isti refleks – vrni identifikator namesto polne strukture, vmesne rezultate shrani v zunanjo storitev, obdelavo paginiraj v serije – in to bo v veliki večini primerov zadostovalo.
Brez V/I v delovnem toku
Zadnja vrstica tabele ni omejitev velikosti, temveč pravilo načrtovanja, ki je bilo že obravnavano v okviru determinizma. Koda delovnega toka ne sme vsebovati operacij vhoda/izhoda: brez omrežnih klicev (httpx, aiohttp, requests), brez branja ali pisanja datotek (open, aiofiles), brez dostopa do baze podatkov in brez branja spremenljivk okolja za usmerjanje razvejanja. Vse te operacije živijo v aktivnostih, katerih rezultati so zabeleženi in zato enako ponovljivo predvajani.
Ključne ugotovitve
- Najmanjša zakasnitev 2 sekundi med vsako aktivnostjo – združi povezane operacije
- Največ 2 MB na vhod/izhod aktivnosti – za velike podatke uporabi zunanjo shrambo
- Največ 51.200 dogodkov in 50 MB na izvedbo – za zelo dolge delovne toke uporabi vzorec nadaljevanja
- Brez V/I v kodi delovnega toka – vse spada v aktivnosti
- Te omejitve izhajajo iz osnovne arhitekture Temporal in statusa javnega predogleda