Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Limitazzjonijiet tal-Pjattaforma

Lezzjoni 10 / 14 Aġġornat 29 ta’ Lulju 2026 Avvanzat
F'din il-paġna
  1. Ix-Xejjer il-Limiti
  2. Żewġ Sekondi Bejn Kull Attività
  3. Żewġ Megabytes Għal Kull Invokazzjoni
  4. Il-Baġit tal-Avvenimenti u l-Volum
  5. L-Ebda I/O fil-Workflow
  6. Punti Ewlenin

Ix-Xejjer il-Limiti

Il-pjattaforma Mistral Workflows tinsab f’Public Preview (sa April 2026). Bħal kull sistema ta’ orkestrazzjoni, timponi restrizzjonijiet tekniċi li trid tifhem biex tiddisinja workflows robusti. Dawn il-limiti mhumiex sempliċiment noti f’qiegħ id-dokumentazzjoni; jidhru fil-produzzjoni, spiss tard fil-proċess, bħala żbalji ta’ serializzazzjoni jew workflows mitmuma għal għarrieda mingħajr twissija fil-kodiċi tiegħek. Li tkun taf bihom minn qabel ibiddel il-mod kif tistruttura l-loġika tal-ipproċessar tiegħek.

It-tabella hawn taħt tissorvelja r-restrizzjonijiet ewlenin u l-konsegwenza konkreta li taqbeż kull wieħed minnhom.

Limitazzjoni Valur Konsegwenza jekk tinqabeż
Dewmien bejn l-attivitajiet 2 sekondi Latency inevitabbli bejn kull sejħa ta' attività
Input/output għal kull invokazzjoni 2 MB Żball ta' serializzazzjoni, il-workflow ifalli
Avvenimenti għal kull eżekuzzjoni 51,200 Il-workflow jiġi mitmum b'mod furzat
Daqs totali għal kull eżekuzzjoni 50 MB Il-workflow jiġi mitmum b'mod furzat
Timeout default Siegħa waħda Il-workflow jiġi kkanċellat (konfigurabbli sa 7 ijiem)
Massimu ta' timeout 7 ijiem Il-workflow jiġi kkanċellat awtomatikament
I/O fil-workflows Ipprojbit Żball ta' non-determiniżmu waqt ir-replay

Żewġ Sekondi Bejn Kull Attività

Il-pjattaforma timponi dewmien minimu ta’ 2 sekondi bejn is-sejħiet tal-attivitajiet. Din il-latency mhix problema ta’ bidu; hija inerenti għall-arkitettura tal-orkestrazzjoni, li tippersisti kull avveniment qabel ma tkompli. Dan huwa l-prezz tad-durabbiltà.

L-impatt huwa faċli biex jiġi kkalkulat u spiss sorprendenti. Workflow li jgħaqqad għaxar attivitajiet sekwenzjali jikkonsma mill-inqas għoxrin sekonda ta’ ħin ta’ orkestrazzjoni, irrispettivament minn kemm jieħdu l-attivitajiet innifishom. Jekk kull attività tiġri f’ħamsin millisekonda, iddisinjajt xogħol ta’ nofs sekonda li jieħu għoxrin sekonda biex jirritorna riżultat.

Is-soluzzjoni hija li tgħaqqad operazzjonijiet li m’għandhomx għalfejn ikunu separati f’attività waħda. Qabbel dawn iż-żewġ verżjonijiet tal-istess pipeline NLP.

# 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)

Ir-regola għad-diviżjoni ssir sempliċi: oħloq attività separata biss jekk teħtieġ il-garanzija ta’ persistenza bejn żewġ operazzjonijiet. Jekk żewġ operazzjonijiet jistgħu jfallu flimkien mingħajr ma jikkawżaw problemi—bħal tokenizzazzjoni lokali u kalkolu ta’ embedding imqabbda fil-memorja—għaqqadhom.

Żewġ Megabytes Għal Kull Invokazzjoni

Kull sejħa ta’ attività hija limitata għal 2 MB għall-input u 2 MB għall-output, ibbażata fuq ir-rappreżentazzjoni JSON serializzata tad-data. Rapport PDF, sett ta’ stampi, jew esportazzjoni kbira ta’ CSV faċilment taqbeż dan, u tikkawża li l-workflow ifalli b’żball ta’ serializzazzjoni.

Is-soluzzjoni hija f’sentenza waħda: għaddi referenzi, qatt payloads. L-attività tniżżel id-data minn ħażna esterna, tipproċessaha lokalment (fejn hija limitata biss mill-memorja tal-ħaddiem), u tirritorna l-URL tar-riżultat.

@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"}

Il-Baġit tal-Avvenimenti u l-Volum

Kull eżekuzzjoni hija limitata għal 51,200 avveniment. Il-pjattaforma tiġġenera avveniment għal kull bidu ta’ attività, kull tlestija ta’ attività, kull sinjal riċevut, u kull timer attivat. Fil-prattika, sejħa ta’ attività tispiċċa tiswa madwar żewġ sa tliet avvenimenti ladarba jingħaddu l-metadejta, u tqiegħed workflow ta’ mitt attività madwar 250 sa 300 avveniment. Fi kliem ieħor, il-limitu jippermetti ħmistax sa għoxrin elf sejħa ta’ attività għal kull eżekuzzjoni: ferm ‘il fuq minn dak li jeħtieġu l-biċċa l-kbira tal-każijiet ta’ użu.

Se tilħaq dan il-limitu biss b’ipproċessar bil-kwantità—pereżempju, li tgħaddi minn ħamsin elf dokument f’eżekuzzjoni waħda. Il-mudell ta’ kontinwazzjoni, iddettaljat fil-lezzjoni li jmiss, isolvi dan: il-workflow jipproċessa lott, imbagħad jnedi workflow ġdid għall-lott li jmiss, u jirrisettja l-kontatur tal-avvenimenti.

It-tieni limitu jikkonċerna l-volum: id-dażż kumulattiv tal-avvenimenti kollha f’eżekuzzjoni m’għandux jaqbeż il-50 MB. Dan jimtela aktar malajr jekk l-attivitajiet tiegħek jirritornaw oġġetti rikki, peress li kull riżultat jiġi miktub fil-log. L-istess rifless japplika—irritorna identifikatur minflok struttura sħiħa, aħżen ir-riżultati intermedjarji f’servizz estern, u pproċessa bil-lottijiet (pagination)—u dan huwa biżżejjed fil-vast maġġoranza tal-każijiet.

L-Ebda I/O fil-Workflow

L-aħħar linja tat-tabella mhix limitu tad-daqs iżda regola tad-disinn, diġà koperta taħt id-determiniżmu. Il-kodiċi tal-workflow m’għandu jkun fih l-ebda operazzjoni ta’ input/output: l-ebda sejħa tan-network (httpx, aiohttp, requests), l-ebda qari jew kitba ta’ fajls (open, aiofiles), l-ebda aċċess għad-database, u l-ebda qari ta’ varjabbli tal-ambjent biex timmaniġġja l-furkazzjoni. Dawn l-operazzjonijiet kollha jgħixu fl-attivitajiet, li r-riżultati tagħhom jiġu rreġistrati u għalhekk jistgħu jiġu rrepetuti bl-istess mod.

Punti Ewlenin

  • 2 sekondi ta’ latency minima bejn kull attività—għaqqad operazzjonijiet relatati
  • 2 MB massimu għal kull input/output tal-attività—uża ħażna esterna għal data kbira
  • 51,200 avveniment u 50 MB massimu għal kull eżekuzzjoni—uża l-mudell ta’ kontinwazzjoni għal workflows twil ħafna
  • L-ebda I/O fil-kodiċi tal-workflow—kollox imur fl-attivitajiet
  • Dawn il-limitazzjonijiet ġejjin mill-arkitettura sottostanti ta’ Temporal u l-istatus ta’ Public Preview