Ir-Regola tad-Determiniżmu
F'din il-paġna
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.
- Preżenza ta’ sejħiet mhux deterministiċi — Fittex
datetime.now,uuid.uuid4,random.randomfil-kodiċi tal-fluss tax-xogħol - I/O Dirett — Kwalunkwe sejħa tan-network jew tal-fajl trid tkun f’attività
- Varjabbli tal-ambjent — Jekk tuża
os.environgħall-fergħat (branching), mexxi l-qari f’attività - 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à