Limitazzjonijiet tal-Pjattaforma
F'din il-paġna
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