Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Platformos apribojimai

Paskaita 10 iš 14 Atnaujinta 2026 m. liepos 29 d. Pažengusiems
Šiame puslapyje
  1. Žinokite ribas
  2. Dvi sekundės tarp kiekvienos veiklos
  3. Du megabaitai vienam iškvietimui
  4. Įvykių ir apimties biudžetas
  5. Jokių įvesties/išvesties operacijų darbo eigoje
  6. Svarbiausi punktai

Žinokite ribas

„Mistral Workflows“ platforma yra viešojo peržiūros („Public Preview“) etape (2026 m. balandžio mėn. duomenimis). Kaip ir bet kuri orchestravimo sistema, ji taiko techninius apribojimus, kuriuos turite suprasti, kad galėtumėte kurti patikimus darbo eigų sprendimus. Šie apribojimai nėra tik dokumentacijos pastabos; jie pasireiškia gamybinėje aplinkoje, dažnai vėlyvame etape, kaip serializacijos klaidos arba netikėtai nutrauktos darbo eigos be jokio įspėjimo jūsų kode. Išankstinis jų žinojimas keičia tai, kaip struktūruojate savo apdorojimo logiką.

Toliau pateiktoje lentelėje apibendrinti pagrindiniai apribojimai ir konkrečios kiekvieno jų viršijimo pasekmės.

Apribojimas Reikšmė Pasekmė viršijus
Delsa tarp veiklų 2 sekundės Neišvengiama delsą tarp kiekvieno veiklos iškvietimo
Įvestis/išvestis vienam iškvietimui 2 MB Serializacijos klaida, darbo eiga nepavyksta
Įvykių vienam vykdymui skaičius 51 200 Darbo eiga priverstinai nutraukiama
Bendras dydis vienam vykdymui 50 MB Darbo eiga priverstinai nutraukiama
Numatytoji laiko riba 1 valanda Darbo eiga atšaukiama (galima konfigūruoti iki 7 dienų)
Maksimali laiko riba 7 dienos Darbo eiga automatiškai atšaukiama
Įvesties/išvesties operacijos darbo eigose Draudžiama Nedeterminizmo klaida perkuriant

Dvi sekundės tarp kiekvienos veiklos

Platforma taiko minimalią 2 sekundžių delsą tarp veiklų iškvietimų. Ši delsą nėra pradinio etapas problema; ji yra būdinga orchestravimo architektūrai, kuri prieš tęsdama išsaugo kiekvieną įvykį. Tai yra patvarumo kaina.

Poveikį lengva apskaičiuoti, ir jis dažnai nustebina. Darbo eiga, sujungianti dešimt nuoseklių veiklų, sunaudoja bent dvidešimt sekundžių orchestravimo laiko, nepaisant to, kiek laiko trunka pačios veiklos. Jei kiekviena veikla trunka penkiasdešimt milisekundžių, sukūrėte pusės sekundės užduotį, kurios rezultato gavimas trunka dvidešimt sekundžių.

Sprendimas – sugrupuoti operacijas, kurioms nereikia būti atskiromis, į vieną veiklą. Palyginkite šias dvi to paties NLP konvejerio versijas.

# NEOPTIMALU: 3 veiklos = 6 sekundės orchestravimo delsos
@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

# OPTIMIZUOTA: 1 veikla = 2 sekundės orchestravimo delsos
@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)

Taisyklė, kaip skaidyti, tampa paprasta: kurkite atskirą veiklą tik tada, jei tarp dviejų operacijų jums reikia patvarumo garantijos. Jei dvi operacijos gali nepavykti kartu nesukeldamos problemų – pavyzdžiui, lokalus tokenizavimas ir įterpinių skaičiavimas, sujungti atmintyje – sugrupuokite jas.

Du megabaitai vienam iškvietimui

Kiekvienas veiklos iškvietimas apribotas 2 MB įvesties ir 2 MB išvesties, remiantis serializuotu JSON duomenų vaizdavimu. Ataskaitos PDF failas, vaizdų rinkinys arba didelis CSV eksportas tai lengvai viršys, todėl darbo eiga nepavyks dėl serializacijos klaidos.

Sprendimas telpa į vieną sakinį: perduokite nuorodas, niekada – duomenų apkrovas. Veikla atsisiunčia duomenis iš išorinės saugyklos, apdoroja juos lokaliai (kur ją riboja tik darbuotojo atmintis) ir grąžina rezultato URL.

@workflows.activity()
async def traiter_gros_fichier(fichier_url: str) -> dict:
    """Atsisiųsti, apdoroti ir iš naujo įkelti failą.
    Per darbo eigą perduodami tik URL."""
    async with httpx.AsyncClient() as client:
        # Atsisiųsti iš S3/GCS
        response = await client.get(fichier_url)
        contenu = response.content  # Gali būti 100 MB

        # Apdoroti failą
        resultat = traiter(contenu)

        # Įkelti rezultatą
        await client.put(
            "https://storage.example.com/résultats/output.json",
            content=resultat
        )

    return {"url_resultat": "https://storage.example.com/résultats/output.json"}

Įvykių ir apimties biudžetas

Kiekvienas vykdymas apribotas 51 200 įvykių. Platforma generuoja įvykį kiekvienai veiklos pradžiai, kiekvienai veiklos pabaigai, kiekvienam gautam signalui ir kiekvienam suaktyvintam laikmačiui. Praktiškai veiklos iškvietimas kainuoja apie du–tris įvykius, įskaičiuojant metaduomenis, todėl šimto veiklų darbo eiga sukuria apie 250–300 įvykių. Kitaip tariant, riba leidžia atlikti penkiolika–dvidešimt tūkstančių veiklų iškvietimų vienam vykdymui: tai gerokai viršija daugumos naudojimo atvejų poreikius.

Šią ribą pasieksite tik vykdant masinį apdorojimą – pavyzdžiui, iteruojant per penkiasdešimt tūkstančių dokumentų vieno vykdymo metu. Tęstinumo modelis, išsamiai aprašytas kitoje pamokoje, išsprendžia šią problemą: darbo eiga apdoroja grupę, tada paleidžia naują darbo eigą kitai grupei, iš naujo nustatydama įvykių skaitiklį.

Antra riba susijusi su apimtimi: bendra visų vieno vykdymo įvykių suma neturi viršyti 50 MB. Tai užsipildo greičiau, jei jūsų veiklos grąžina turtingus objektus, nes kiekvienas rezultatas įrašomas į žurnalą. Galioja tas pats refleksas – grąžinkite identifikatorių, o ne visą struktūrą, tarpinius rezultatus saugokite išorinėje tarnyboje, apdorojimą vykdykite grupėmis – ir to pakanka daugeliu atvejų.

Jokių įvesties/išvesties operacijų darbo eigoje

Paskutinė lentelės eilutė yra ne dydžio apribojimas, o dizaino taisyklė, jau aptarta determinizmo kontekste. Darbo eigos kode negali būti jokių įvesties/išvesties operacijų: jokių tinklo užklausų (httpx, aiohttp, requests), jokių failų skaitymo ar rašymo operacijų (open, aiofiles), jokių duomenų bazių prieigos ir jokių aplinkos kintamųjų skaitymų šakojimui valdyti. Visos šios operacijos turi būti vykdomos veiklose, kurių rezultatai registruojami ir todėl gali būti identiški perkuriami.

Svarbiausi punktai

  • 2 sekundės minimali delsą tarp kiekvienos veiklos – sugrupuokite susijusias operacijas
  • 2 MB maksimalus dydis vienai veiklos įvesčiai/išvesčiai – naudokite išorinę saugyklą dideliems duomenims
  • 51 200 įvykių ir 50 MB maksimali apimtis vienam vykdymui – labai ilgoms darbo eigoms naudokite tęstinumo modelį
  • Jokių įvesties/išvesties operacijų darbo eigos kode – viskas turi būti veiklose
  • Šie apribojimai kyla iš pagrindinės „Temporal“ architektūros ir viešojo peržiūros („Public Preview“) statuso