Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Ograničenja platforme

Lekcija 10 od 14 Ažurirano 29. srpnja 2026. Napredno
Na ovoj stranici
  1. Upoznaj ograničenja
  2. Dvije sekunde između svake aktivnosti
  3. Dva megabajta po pozivu
  4. Proračun događaja i volumena
  5. Nema U/I u tijeku rada
  6. Ključne točke

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