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

Ir-Regola tad-Determiniżmu

Lezzjoni 8 / 14 Aġġornat 2 ta’ Novembru 2026 Avvanzat
F'din il-paġna
  1. Għaliex id-Determiniżmu huwa Obbligatorju
  2. Kif Jidher Dan fil-Kodiċi
  3. Sostituzzjonijiet tal-SDK
  4. Il-Fruntiera li Triftakar
  5. Kif Tiddijanostika Żball ta’ Non-Determiniżmu
  6. Punti Ewlenin

Għaliex id-Determiniżmu huwa Obbligatorju

Id-determiniżmu huwa l-aktar vincolu kritiku fil-flussi tax-xogħol (workflows) ta’ Mistral, u ġej direttament mill-mekkaniżmu ta’ “replay” li tgħallimt dwaru qabel. Meta ħaddiem (worker) ikompli fluss tax-xogħol li ġie interrott, jerġa’ jħaddem il-kodiċi tal-fluss mill-bidu u jqabbel, operazzjoni b’operazzjoni, dak li jipproduċi l-kodiċi ma’ dak li rreġistra l-ġurnal tal-istorja (history log). Sakemm iż-żewġ sekwenzi jaqblu, il-kompliment huwa inviżibbli. Fil-mument li jidverġu, il-pjattaforma ma jkollha l-ebda mod kif tkun fejn waqfet: tiskopri l-inkonsistenza u tfalli l-fluss tax-xogħol b’żball ta’ non-determiniżmu.

Fil-prattika, fluss tax-xogħol deterministiku jipproduċi l-eżatt istess sekwenza ta’ operazzjonijiet kull darba li jiġi eżegwit bl-istess inputs. Innota n-nuansa: ir-riżultati tal-attivitajiet jistgħu jvarjaw bejn l-eżekuzzjonijiet peress li ġejjin mill-ġurnal. Huwa l-ordni tas-sejħiet li trid tibqa’ identika.

Kif Jidher Dan fil-Kodiċi

Ikkunsidra fluss tax-xogħol li jibgħat rapport lil utent ibbażat fuq l-istatus tas-sottoskrizzjoni tiegħu.

@workflows.workflow.define(name="deterministic_workflow")
class DeterministicWorkflow:
    @workflows.workflow.entrypoint
    async def run(self, user_id: str) -> dict:
        # Dejjem l-istess sekwenza ta' sejħiet għall-istess input
        profile = await get_profile(user_id)
        
        if profile["premium"]:
            report = await generate_full_report(user_id)
        else:
            report = await generate_basic_report(user_id)
        
        await send_email(profile["email"], report)
        return {"status": "completed"}

Dan il-fluss tax-xogħol huwa deterministiku anke jekk fih fergħa (branch). Ir-raġuni tinsab fis-sors tal-kundizzjoni: profile["premium"] ġej minn riżultat ta’ attività, allura ġej mill-ġurnal. Matul ir-”replay”, get_profile tirritorna l-eżatt istess valur bħall-ewwel eżekuzzjoni, u tittieħed l-istess triq.

Issa qabbel dan ma’ din il-verżjoni, li tidher innoċenti iżda tkisser kollox.

import datetime
import random

@workflows.workflow.define(name="non_deterministic_workflow")
class NonDeterministicWorkflow:
    @workflows.workflow.entrypoint
    async def run(self, user_id: str) -> dict:
        # IPPROIBIT: datetime.now() jinbidel f'kull eżekuzzjoni
        if datetime.datetime.now().hour < 12:
            await send_morning_email(user_id)
        else:
            await send_afternoon_email(user_id)
        
        # IPPROIBIT: random.random() jagħti riżultat differenti kull darba
        if random.random() > 0.5:
            await send_notification(user_id)
        
        return {"status": "completed"}

Immaġina li l-ħaddiem (worker) jaqa’ fid-11:58 AM u jerġa’ jibda fil-12:03 PM. Matul ir-”replay”, datetime.now() tirritorna ħin ta’ wara nofsinhar filwaqt li l-istorja fiha sejħa għal send_morning_email. Il-fluss tax-xogħol ifalli. random.random() jipproduċi l-istess effett, biss huwa aktar diffiċli biex tiddijanostikah.

Sostituzzjonijiet tal-SDK

L-SDK mhux biss jipprojbixxi dawn is-sejħiet; jipprovdi ekwivalenti deterministiċi għat-tliet operazzjonijiet l-aktar komuni.

from mistralai.workflows import workflow

# Ikseb il-ħin kurrenti (deterministiku matul ir-replay)
current_time = workflow.now()          # Minflok datetime.now()

# Iġġenera ID uniku (deterministiku matul ir-replay)
request_id = workflow.uuid4()          # Minflok uuid.uuid4()

# Ikseb numru każwali (deterministiku matul ir-replay)
rand_value = workflow.random()         # Minflok random.random()

Il-prinċipju huwa l-istess bħal għall-attivitajiet: il-valur jiġi kkalkulat u rreġistrat fil-ġurnal fl-ewwel eżekuzzjoni, imbagħad sempliċiment jiġi rrepetut (replayed) wara. L-eżempju preċedenti mbagħad isir perfettament sikur.

import mistralai.workflows as workflows
from mistralai.workflows import workflow

@workflows.workflow.define(name="fixed_workflow")
class FixedWorkflow:
    @workflows.workflow.entrypoint
    async def run(self, user_id: str) -> dict:
        # KORRETT: workflow.now() huwa deterministiku matul ir-replay
        current_hour = workflow.now()
        if current_hour.hour < 12:
            await send_morning_email(user_id)
        else:
            await send_afternoon_email(user_id)
        
        # KORRETT: workflow.random() huwa deterministiku matul ir-replay
        if workflow.random() > 0.5:
            await send_notification(user_id)
        
        # KORRETT: workflow.uuid4() huwa deterministiku matul ir-replay
        trace_id = workflow.uuid4()
        await log_trace(str(trace_id), user_id)
        
        return {"status": "completed", "trace_id": str(trace_id)}

Il-Fruntiera li Triftakar

Dan li ġej huwa pprojbit fil-kodiċi tal-fluss tax-xogħol: datetime.now(), datetime.utcnow(), u time.time(); uuid.uuid4() u uuid.uuid1(); random.random(), random.randint(), u random.choice(); kwalunkwe sejħa diretta tan-network (httpx, aiohttp, requests); kwalunkwe qari jew kitba ta’ fajl (open(), aiofiles); kwalunkwe aċċess għad-database; os.environ, għax il-varjabbli tal-ambjent jistgħu jinbidlu bejn ir-”replays”; u finalment threading u multiprocessing, peress li l-pjattaforma tittratta l-parallelism intern.

Kollox li jista’ jiġi riprodott jibqa’ permess: sejħa ta’ attivitajiet permezz ta’ await, użu ta’ workflow.now(), workflow.uuid4(), u workflow.random(), kitba ta’ loġika kondizzjonali jew loops li l-kundizzjonijiet tagħhom jiddependu fuq riżultati ta’ attivitajiet, manipolazzjoni ta’ data fil-memorja (kalkoli, strings), u logging—il-logging huwa kkunsidrat bħala effett sekondarju aċċettabbli.

Kif Tiddijanostika Żball ta’ Non-Determiniżmu

Meta jolqot l-iżball, erba’ verifiki ġeneralment ikunu biżżejjed biex tinsab fejn qiegħed.

  1. Preżenza ta’ sejħiet mhux deterministiċi — Fittex datetime.now, uuid.uuid4, random.random fil-kodiċi tal-fluss tax-xogħol
  2. I/O Dirett — Kwalunkwe sejħa tan-network jew tal-fajl trid tkun f’attività
  3. Varjabbli tal-ambjent — Jekk tuża os.environ għall-fergħat (branching), mexxi l-qari f’attività
  4. Libreriji ta’ partijiet terzi — Xi libreriji jagħmlu sejħiet tan-network jew jużaw każwalità internament

Dan l-aħħar punt huwa l-aktar insidjuż: librerija tas-serializzazzjoni li tissorja b’ID iġġenerat b’mod każwali, jew klijent HTTP istanzjat matut-tagħbija tal-modulu, jista’ jfalli “replay” mingħajr linja waħda suspettuża li tidher fil-fluss tax-xogħol tiegħek.

L-aktar difiża effettiva hija li żżomm il-fluss tax-xogħol kemm jista’ jkan sempliċi u timbotta l-loġika kumplessa kollha f’attivitajiet. Flus tax-xogħol li sempliċiment iħabbat tliet sejħiet m’għandux mekkanikament l-ebda opportunità li jkun mhux deterministiku.

# L-AĦJAR PRATTIKA: fluss tax-xogħol sempliċi, loġika f'attivitajiet
@workflows.workflow.define(name="simple_pipeline")
class SimplePipeline:
    @workflows.workflow.entrypoint
    async def run(self, params: dict) -> dict:
        step1 = await prepare_data(params)
        step2 = await process_data(step1)
        step3 = await finalize(step2)
        return step3

Punti Ewlenin

  • Il-kodiċi tal-fluss tax-xogħol irid ikun deterministiku: l-istess inputs = l-istess sekwenza ta’ operazzjonijiet
  • Uża workflow.now(), workflow.uuid4(), workflow.random() minflok l-ekwivalenti standard ta’ Python
  • L-operazzjonijiet kollha tal-I/O (network, fajl, DB) iridu jkunu f’attività, qatt fil-fluss tax-xogħol
  • Il-fergħat kondizzjonali huma permessi jekk jiddependu fuq riżultati ta’ attivitajiet
  • Ksur tad-determiniżmu jikkawża li l-fluss tax-xogħol ifalli matul ir-”replay”
  • Meta jkollok dubju, mexxi l-loġika f’attività