An Riail Chinnteachta
Ar an leathanach seo
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ú.
- Láithreacht glaonna neamhchinntitheacha — Cuardaigh
datetime.now,uuid.uuid4,random.randomi gcód na sruthoibre - I/O Díreach — Caithfidh aon ghlao líonra nó comhaid bheith i ngníomhaíocht
- Athróga timpeallachta — Má úsáideann tú
os.environle haghaidh brainse, bog an léamh isteach i ngníomhaíocht - 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