Ograničenja platforme
Na ovoj stranici
Upoznaj ograničenja
Platforma Mistral Workflows nalazi se u fazi javnog pregleda (stanje u travnju 2026.). Kao i svaki sustav za orkestraciju, nameće tehnička ograničenja koja moraš razumjeti kako bi dizajnirao robusne tijekove rada. Ta ograničenja nisu samo fusnote u dokumentaciji; pojavljuju se u produkciji, često kasno u procesu, kao pogreške serijalizacije ili neočekivano prekinuti tijekovi rada bez upozorenja u tvom kodu. Poznavanje tih ograničenja unaprijed mijenja način na koji strukturiraš svoju logiku obrade.
Tablica u nastavku sažima ključna ograničenja i konkretne posljedice njihova prekoračenja.
| Ograničenje | Vrijednost | Posljedica prekoračenja |
|---|---|---|
| Kašnjenje između aktivnosti | 2 sekunde | Neizbježna latencija između svakog poziva aktivnosti |
| Ulaz/izlaz po pozivu | 2 MB | Pogreška serijalizacije, tijek rada ne uspijeva |
| Događaji po izvršenju | 51.200 | Tijek rada prisilno prekinut |
| Ukupna veličina po izvršenju | 50 MB | Tijek rada prisilno prekinut |
| Zadano vrijeme čekanja | 1 sat | Tijek rada otkazan (moguće konfigurirati do 7 dana) |
| Maksimalno vrijeme čekanja | 7 dana | Tijek rada automatski otkazan |
| U/I u tijekovima rada | Zabranjeno | Pogreška nedeterminizma tijekom ponovnog izvršavanja |
Dvije sekunde između svake aktivnosti
Platforma nameće minimalno kašnjenje od 2 sekunde između poziva aktivnosti. Ta latencija nije dječja bolest sustava; inherentna je arhitekturi orkestracije koja trajno pohranjuje svaki događaj prije nastavka. To je cijena izdržljivosti.
Utjecaj je lako izračunati i često iznenađuje. Tijek rada koji povezuje deset sekvencijalnih aktivnosti troši najmanje dvadeset sekundi vremena orkestracije, bez obzira na to koliko same aktivnosti traju. Ako svaka aktivnost traje pedeset milisekundi, dizajnirao si posao od pola sekunde kojem treba dvadeset sekundi da vrati rezultat.
Rješenje je grupiranje operacija koje ne moraju biti odvojene u jednu aktivnost. Usporedi ove dvije verzije istog NLP pipelinea.
# SUBOPTIMAL: 3 activities = 6 seconds of orchestration latency
@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
# OPTIMIZED: 1 activity = 2 seconds of orchestration latency
@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 razdvajanje postaje jednostavno: stvori zasebnu aktivnost samo ako ti treba jamstvo trajnosti između dviju operacija. Ako dvije operacije mogu zajedno failati bez izazivanja problema – poput lokalne tokenizacije i izračuna ugradnji (embedding) povezanih u memoriji – grupiraj ih.
Dva megabajta po pozivu
Svaki poziv aktivnosti ograničen je na 2 MB za ulaz i 2 MB za izlaz, na temelju serijaliziranog JSON prikaza podataka. PDF izvješće, skup slika ili velik CSV izvoz lako će prijeći to ograničenje, uzrokujući neuspjeh tijeka rada s pogreškom serijalizacije.
Rješenje je jedna rečenica: prosljeđuj reference, nikada terete (payloads). Aktivnost preuzima podatke iz vanjske pohrane, obrađuje ih lokalno (gdje je ograničena samo memorijom radnika) i vraća URL rezultata.
@workflows.activity()
async def traiter_gros_fichier(fichier_url: str) -> dict:
"""Download, process, and re-upload the file.
Only URLs pass through the workflow."""
async with httpx.AsyncClient() as client:
# Download from S3/GCS
response = await client.get(fichier_url)
contenu = response.content # Could be 100 MB
# Process the file
resultat = traiter(contenu)
# Upload the result
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 događaja i volumena
Svako izvršenje ograničeno je na 51.200 događaja. Platforma generira događaj za svaki početak aktivnosti, svaki završetak aktivnosti, svaki primljeni signal i svaki pokrenuti tajmer. U praksi, poziv aktivnosti košta oko dva do tri događaja kada se uračunaju metapodaci, što stavlja tijek rada od sto aktivnosti u raspon od 250 do 300 događaja. Drugim riječima, ograničenje dopušta petnaest do dvadeset tisuća poziva aktivnosti po izvršenju: daleko više od onoga što većina slučajeva upotrebe zahtijeva.
Doći ćeš do ovog ograničenja samo kod masovne obrade – na primjer, iteriranja kroz pedeset tisuća dokumenata u jednom izvršenju. Uzorak nastavka (continuation pattern), detaljno opisan u sljedećoj lekciji, rješava to: tijek rada obrađuje šaržu (batch), zatim pokreće novi tijek rada za sljedeću šaržu, resetirajući brojač događaja.
Druga granica odnosi se na volumen: kumulativna veličina svih događaja u izvršenju ne smije prijeći 50 MB. To se brže popunjava ako tvoje aktivnosti vraćaju bogate objekte, jer se svaki rezultat zapisuje u dnevnik. Isti refleks vrijedi – vrati identifikator umjesto pune strukture, pohrani međurezultate u vanjsku uslugu, paginiraj obradu u šaržama – i to je dovoljno u velikoj većini slučajeva.
Nema U/I u tijeku rada
Posljednji redak tablice nije ograničenje veličine već pravilo dizajna, već obrađeno pod determinizmom. Kod tijeka rada ne smije sadržavati operacije ulaza/izlaza: nema mrežnih poziva (httpx, aiohttp, requests), nema čitanja ili pisanja datoteka (open, aiofiles), nema pristupa bazi podataka i nema čitanja varijabli okruženja za upravljanje grananjem. Sve te operacije žive u aktivnostima, čiji se rezultati bilježe i stoga su identično ponovljivo izvršivi.
Ključne točke
- 2 sekunde minimalne latencije između svake aktivnosti – grupiraj povezane operacije
- 2 MB maksimuma po ulazu/izlazu aktivnosti – koristi vanjsku pohranu za velike podatke
- 51.200 događaja i 50 MB maksimuma po izvršenju – koristi uzorak nastavka za vrlo duge tijekove rada
- Nema U/I u kodu tijeka rada – sve ide u aktivnosti
- Ta ograničenja proizlaze iz temeljne arhitekture Temporal i statusa javnog pregleda