Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Alustan rajoitukset

Oppitunti 10 / 14 Päivitetty 29. heinäkuuta 2026 Edistynyt
Tällä sivulla
  1. Tunne rajat
  2. Kaksi sekuntia jokaisen aktiviteetin välillä
  3. Kaksi megatavua kutakin kutsua kohti
  4. Tapahtuma- ja volyymibudjetti
  5. Ei I/O:ta työnkulussa
  6. Keskeiset asiat

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