Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

An Riail Chinnteachta

Ceacht 8 as 14 Nuashonraithe 2 Samhain 2026 Ardleibhéal
Ar an leathanach seo
  1. Cén fáth a bhfuil an Chinnteacht Éigeantach
  2. Conas a Fheictear É seo sa Chód
  3. Ionadaíochtaí SDK
  4. An Teorainn le Cuimhneamh
  5. Earráid Neamhchinnteachta a Dhiagnóisiú
  6. Príomhphointí

Cén fáth a bhfuil an Chinnteacht Éigeantach

Is í an chinnteacht an srian is criticiúla i sruthoibreacha Mistral, agus eascraíonn sí go díreach as an meicníocht athsheinm a d’fhoghlaim tú níos luaithe. Nuair a aththosaíonn oibrí sruthoibre briste, déanann sé athsheinm ar chód na sruthoibre ón tús agus déanann sé comparáid, oibríocht ar oibríocht, idir an méid a tháirgeann an cód agus an méid a taifeadadh sa log staire. Fad is a mheaitseálann an dá sheicheamh, tá an t-aththosú dofheicthe. An tsoicind a imíonn siad ó chéile, níl aon bhealach ag an ardán a fháil amach cáir d’fhág sé: braithfidh sé an neamhréireacht agus teipfidh ar an sruthoibre le hearráid neamhchinnteachta.

Go praiticiúil, cruthaíonn sruthoibre chinntitheach an seicheamh cruinn céanna oibríochtaí gach uair a ritheann sí leis na hionchuir chéanna. Tabhair faoi deara an nuance: is féidir le torthaí gníomhaíochtaí athrú idir feidhmiúcháin ós rud é go dtagann siad ón iris. Is é ord na nglaonna a chaithfidh fanacht mar an gcéanna.

Conas a Fheictear É seo sa Chód

Breathnaigh ar shruthoibre a sheolann tuarascáil chuig úsáideoir bunaithe ar a stádas síntiúis.

@workflows.workflow.define(name="deterministic_workflow")
class DeterministicWorkflow:
    @workflows.workflow.entrypoint
    async def run(self, user_id: str) -> dict:
        # An seicheamh glaonna céanna i gcónaí don ionchur céanna
        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"}

Tá an sruthoibre seo cinntitheach cé go bhfuil brainse ann. Is é an fáth atá leis ná foinse an choinníll: tagann profile["premium"] ó thoradh gníomhaíochta, mar sin tagann sé ón iris. Le linn athsheinm, filleann get_profile an luach cruinn céanna leis an gcéad fheidhmiú, agus tógtar an cosán céanna.

Anois, déan comparáid idir é sin agus an leagan seo, a bhfuil cuma neamhchiontach air ach a bhriseann gach rud.

import datetime
import random

@workflows.workflow.define(name="non_deterministic_workflow")
class NonDeterministicWorkflow:
    @workflows.workflow.entrypoint
    async def run(self, user_id: str) -> dict:
        # TOIRMISCTE: athraíonn datetime.now() ar gach feidhmiú
        if datetime.datetime.now().hour < 12:
            await send_morning_email(user_id)
        else:
            await send_afternoon_email(user_id)
        
        # TOIRMISCTE: tugann random.random() toradh difriúil gach uair
        if random.random() > 0.5:
            await send_notification(user_id)
        
        return {"status": "completed"}

Samhlaigh go dtarlaíonn tuairt ar an oibrí ag 11:58 RN agus go n-atosaíonn sé ag 12:03 IN. Ar athsheinm, filleann datetime.now() am tráthnóna cé go bhfuil glao ar send_morning_email sa stair. Teipeann ar an sruthoibre. Cruthaíonn random.random() an éifeacht chéanna, ach is deacra é a dhiagnóisiú.

Ionadaíochtaí SDK

Ní thoirmscíonn an SDK na glaonna seo amháin; soláthraíonn sé coibhéisí cinntitheacha do na trí oibríocht is coitianta.

from mistralai.workflows import workflow

# Faigh an t-am reatha (cinntitheach le linn athsheinm)
current_time = workflow.now()          # In ionad datetime.now()

# Ginigh Aitheantas Uathúil (cinntitheach le linn athsheinm)
request_id = workflow.uuid4()          # In ionad uuid.uuid4()

# Faigh uimhir randamach (cinntitheach le linn athsheinm)
rand_value = workflow.random()         # In ionad random.random()

Is é an prionsabal céanna é agus atá le gníomhaíochtaí: ríomhtar an luach agus taifeadtar san iris é ar an gcéad fheidhmiú, ansin déantar é a athsheinm go simplí ina dhiaidh sin. Ansin, bíonn an sampla roimhe seo sábháilte go hiomlán.

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:
        # CEART: tá workflow.now() cinntitheach le linn athsheinm
        current_hour = workflow.now()
        if current_hour.hour < 12:
            await send_morning_email(user_id)
        else:
            await send_afternoon_email(user_id)
        
        # CEART: tá workflow.random() cinntitheach le linn athsheinm
        if workflow.random() > 0.5:
            await send_notification(user_id)
        
        # CEART: tá workflow.uuid4() cinntitheach le linn athsheinm
        trace_id = workflow.uuid4()
        await log_trace(str(trace_id), user_id)
        
        return {"status": "completed", "trace_id": str(trace_id)}

An Teorainn le Cuimhneamh

Tá na nithe seo a leanas toirmiscthe i gcód sruthoibre: datetime.now(), datetime.utcnow(), agus time.time(); uuid.uuid4() agus uuid.uuid1(); random.random(), random.randint(), agus random.choice(); aon ghlao líonra díreach (httpx, aiohttp, requests); aon léamh nó scríobh comhaid (open(), aiofiles); aon rochtain bunachair sonraí; os.environ, toisc gur féidir le hathróga timpeallachta athrú idir athsheinm; agus ar deireadh threading agus multiprocessing, ós rud é go láimhseálann an t-ardán comhthreomhaireacht inmheánach.

Tá gach rud in-atáirgthe fós ceadaithe: glaonna ar ghníomhaíochtaí trí await, úsáid a bhaint as workflow.now(), workflow.uuid4(), agus workflow.random(), loighic choinníollach nó lúba a scríobh a bhraitheann a gcoinníollacha ar thorthaí gníomhaíochtaí, sonraí sa chuimhne a láimhseáil (ríomhaireachtaí, teaghráin), agus logáil — meastar gur fo-iarsma inghlactha é logáil.

Earráid Neamhchinnteachta a Dhiagnóisiú

Nuair a bhuaileann an earráid, is minic go leorann ceithre sheiceáil chun í a aimsiú.

  1. Láithreacht glaonna neamhchinntitheacha — Cuardaigh datetime.now, uuid.uuid4, random.random i gcód na sruthoibre
  2. I/O Díreach — Caithfidh aon ghlao líonra nó comhaid bheith i ngníomhaíocht
  3. Athróga timpeallachta — Má úsáideann tú os.environ le haghaidh brainse, bog an léamh isteach i ngníomhaíocht
  4. Leabharlanna tríú páirtí — Déanann roinnt leabharlann glaonna líonra nó úsáideann siad randamacht go hinmheánach

Is é an pointe deireanach seo an ceann is insidious: is féidir le leabharlann sraithe a dhéanann sórtáil de réir Aitheantais a ghintear go randamach, nó cliant HTTP a chruthaítear ag lódáil an mhodúil, teip a chur ar athsheinm gan aon líne amhrasach amháin le feiceáil i do shruthoibre.

Is é an chosaint is éifeachtaí ná an sruthoibre a choinneáil chomh leanúnach agus is féidir agus gach loighic chasta a bhrú isteach i ngníomhaíochtaí. Níl aon deis mheicniúil ag sruthoibre a nascann trí ghlao amháin a bheith neamhchinntitheach.

# DEA-CHLEACHTAS: sruthoibre simplí, loighic i ngníomhaíochtaí
@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

Príomhphointí

  • Caithfidh cód sruthoibre a bheith cinntitheach: ionchuir chéanna = seicheamh oibríochtaí céanna
  • Úsáid workflow.now(), workflow.uuid4(), workflow.random() in ionad coibhéisí caighdeánacha Python
  • Caithfidh gach oibríocht I/O (líonra, comhad, Bunachar Sonraí) bheith i ngníomhaíocht, riamh sa sruthoibre
  • Tá brainse coinníollacha ceadaithe má bhraitheann siad ar thorthaí gníomhaíochtaí
  • Cuireann sárú cinnteachta faoi deara teip na sruthoibre le linn athsheinm
  • Má tá amhras ort, bog an loighic isteach i ngníomhaíocht