Alustan rajoitukset
Tällä sivulla
Tunne rajat
Mistral Workflows -alusta on julkisessa esiversiossa (huhtikuuhun 2026 mennessä). Kuten mikä tahansa orkestrointijärjestelmä, se asettaa teknisiä rajoituksia, jotka sinun on ymmärrettävä suunnitellaksesi kestäviä työnkulkuja. Nämä rajat eivät ole vain dokumentaation alaviitteitä; ne tulevat esiin tuotantoympäristössä, usein myöhäisessä vaiheessa, sarjoitusvirheinä tai odottamattomasti päättyvinä työnkulkuina ilman varoitusta koodissasi. Niiden tunteminen etukäteen muuttaa tapaa, jolla jäsentelet käsittelylogiikkaasi.
Alla olevassa taulukossa on yhteenveto keskeisistä rajoituksista ja kunkin ylittämisen konkreettisista seurauksista.
| Rajoitus | Arvo | Seuraus ylityksestä |
|---|---|---|
| Viive aktiviteettien välillä | 2 sekuntia | Väistämätön viive jokaisen aktiviteettikutsun välillä |
| Syöte/tulos kutakin kutsua kohti | 2 Mt | Sarjoitusvirhe, työnkulku epäonnistuu |
| Tapahtumia suorituksen kohti | 51 200 | Työnkulku pakotetusti päätetty |
| Koko yhteensä suorituksen kohti | 50 Mt | Työnkulku pakotetusti päätetty |
| Oletusaikakatkaisu | 1 tunti | Työnkulku peruutettu (muokattavissa jopa 7 päivään) |
| Enimmäisaikakatkaisu | 7 päivää | Työnkulku peruutettu automaattisesti |
| I/O työnkuluissa | Kielletty | Epädeterminismivirhe toiston aikana |
Kaksi sekuntia jokaisen aktiviteetin välillä
Alusta pakottaa vähintään kahden sekunnin viiveen aktiviteettikutsujen välille. Tämä viive ei ole lastentauti; se on luontainen osa orkestrointiarkkitehtuuria, joka pysyvöi jokaisen tapahtuman ennen etenemistä. Se on kestävyyden hinta.
Vaikutus on helppo laskea ja usein yllättävä. Työnkulku, joka ketjuttaa kymmenen peräkkäistä aktiviteettia, kuluttaa vähintään kaksikymmentä sekuntia orkestrointiaikaa riippumatta siitä, kuinka kauan itse aktiviteetit kestävät. Jos jokainen aktiviteetti suoritetaan viidessäkymmenessä millisekunnissa, olet suunnitellut puolen sekunnin tehtävän, jonka tuloksen saaminen kestää kaksikymmentä sekuntia.
Ratkaisu on niputtaa toiminnot, joiden ei tarvitse olla erillisiä, yhdeksi aktiviteetiksi. Vertaa näitä kahta versiota samasta NLP-putkesta.
# EI OPTIMAALINEN: 3 aktiviteettia = 6 sekuntia orkestrointiviivettä
@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
# OPTIMOITU: 1 aktiviteetti = 2 sekuntia orkestrointiviivettä
@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)
Sääntö jakamiselle yksinkertaistuu: luo erillinen aktiviteetti vain, jos tarvitset pysyvyyden takuun kahden toiminnon välillä. Jos kaksi toimintoa voivat epäonnistua yhdessä aiheuttamatta ongelmia – kuten paikallinen tokenisointi ja upotuslaskenta ketjutettuna muistiin – niputa ne.
Kaksi megatavua kutakin kutsua kohti
Jokainen aktiviteettikutsu on rajoitettu 2 megatavuun syötteelle ja 2 megatavuun tulokselle perustuen datan sarjoitettuun JSON-esitykseen. Raportti PDF-muodossa, kuvajoukko tai suuri CSV-vienti ylittävät tämän helposti, mikä aiheuttaa työnkulun epäonnistumisen sarjoitusvirheen vuoksi.
Ratkaisu on yksi lause: välitä viittauksia, älä koskaan hyötykuormia. Aktiviteetti lataa datan ulkoisesta tallennustilasta, käsittelee sen paikallisesti (missä sitä rajoittaa vain workerin muisti) ja palauttaa tulos-URL-osoitteen.
@workflows.activity()
async def traiter_gros_fichier(fichier_url: str) -> dict:
"""Lataa, käsittele ja lähetä tiedosto uudelleen.
Vain URL-osoitteet kulkevat työnkulun läpi."""
async with httpx.AsyncClient() as client:
# Lataa S3:stä/GCS:stä
response = await client.get(fichier_url)
contenu = response.content # Voi olla 100 Mt
# Käsittele tiedosto
resultat = traiter(contenu)
# Lähetä tulos
await client.put(
"https://storage.example.com/résultats/output.json",
content=resultat
)
return {"url_resultat": "https://storage.example.com/résultats/output.json"}
Tapahtuma- ja volyymibudjetti
Jokainen suoritus on rajoitettu 51 200 tapahtumaan. Alusta generoi tapahtuman jokaisen aktiviteetin käynnistyessä, jokaisen aktiviteetin valmistuessa, jokaisen vastaanotetun signaalin ja jokaisen laukaistun ajastimen kohdalla. Käytännössä aktiviteettikutsu maksaa noin kaksi tai kolme tapahtumaa, kun metadata lasketaan mukaan, mikä asettaa sadan aktiviteetin työnkulun noin 250–300 tapahtumaan. Toisin sanoen raja sallii viisitoista–kaksikymmentätuhatta aktiviteettikutsua suorituksen kohti: paljon enemmän kuin useimmat käyttötapaukset vaativat.
Törmäät tähän rajaan vain massakäsittelyssä – esimerkiksi iteroidessasi viittäkymmentätuhatta asiakirjaa yhdessä suorituksessa. Jatkuvuusmalli, jota käsitellään yksityiskohtaisesti seuraavassa oppitunnissa, ratkaisee tämän: työnkulku käsittelee erän ja käynnistää sitten uuden työnkulun seuraavaa erää varten nollaten tapahtumalaskurin.
Toinen raja koskee volyymiä: kaikkien tapahtumien kumulatiivinen koko suorituksen aikana ei saa ylittää 50 Mt:tä. Tämä täyttyy nopeammin, jos aktiviteettisi palauttavat rikkaita objekteja, sillä jokainen tulos kirjoitetaan lokiin. Sama refleksi pätee – palauta tunniste täydellisen rakenteen sijaan, tallenna välitulokset ulkoiseen palveluun, jaa käsittely osiin erissä – ja se riittää valtaosassa tapauksia.
Ei I/O:ta työnkulussa
Taulukon viimeinen rivi ei ole kokorajoitus vaan suunnittelusääntö, joka on jo käsitelty determinismin yhteydessä. Työnkulkukoodi ei saa sisältää syöte/tulostustoimintoja: ei verkkokutsuja (httpx, aiohttp, requests), ei tiedostojen lukemista tai kirjoittamista (open, aiofiles), ei tietokantayhteyksiä eikä ympäristömuuttujien lukemista haarautumisen ohjaamiseen. Kaikki nämä toiminnot kuuluvat aktiviteetteihin, joiden tulokset lokitetaan ja jotka ovat siten toistettavissa identtisesti.
Keskeiset asiat
- 2 sekuntia vähimmäisviive jokaisen aktiviteetin välillä – niputa siihen liittyvät toiminnot
- 2 Mt enimmäiskoko aktiviteetin syötteelle/tulokselle – käytä ulkoista tallennustilaa suurille datoille
- 51 200 tapahtumaa ja 50 Mt enimmäiskoko suorituksen kohti – käytä jatkuvuusmallia hyvin pitkiin työnkulkuihin
- Ei I/O:ta työnkulkukoodissa – kaikki kuuluu aktiviteetteihin
- Nämä rajoitukset johtuvat taustalla olevasta Temporal-arkkitehtuurista ja julkisen esiversion statuksesta