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

Cruthaigh sreabhad oibre

Ceacht 5 as 14 Nuashonraithe 2 Samhain 2026 Ardleibhéal
Ar an leathanach seo
  1. Ról an tsreabha oibre
  2. Struchtúr an tsreabha oibre
  3. Sampla iomlán: píblíne próiseála
  4. Marthanacht an tsreabha oibre
  5. Sreabhad oibre le craobhú coinníollach
  6. Ionchuir le Pydantic
  7. Dea-chleachtais
  8. Príomhphointí

Ról an tsreabha oibre

Is é an sreabhad oibre an sraith comhordaithe d’fheidhmchlár. Sainíonn sé cad ba chóir tarlú, in cén ord, agus faoi ché coinníollacha—gan an obair féin a dhéanamh. Go praiticiúil, comhordaíonn sé gníomhaíochtaí, fanann sé le himeachtaí seachtracha, bainistíonn sé timers agus craobhacha coinníollacha, ach ní dhéanann sé teagmháil riamh leis an líonra ná leis an diosca.

Is féidir leat é seo a achoimriú in abairt amháin le coinneáil i gcuimhne gach uair a dhéanann tú athbhreithniú ar chód: déanann gníomhaíochtaí an obair, treoraíonn an sreabhad oibre. Má fheiceann tú httpx nó open() laistigh de rang sreabha oibre, tá rud éigin le bogadh.

Struchtúr an tsreabha oibre

Is rang Python é sreabhad oibre atá maisithe le @workflows.workflow.define(), ina bhfuil modh iontrála maisithe le @workflows.workflow.entrypoint:

import mistralai.workflows as workflows

@workflows.workflow.define(name="mon_premier_workflow")
class MonPremierWorkflow:
    @workflows.workflow.entrypoint
    async def run(self, nom: str) -> dict:
        """Workflow entry point."""
        resultat = await saluer(nom)
        return resultat

Cláraíonn an maisitheoir @workflows.workflow.define(name="...") an rang mar shreabhad oibre. Is é an name a fhaigheann sé an t-aitheantóir uathúil a úsáidfidh tú chun feidhmiú a spreagadh—is é an teaghrán seo, seachas ainm an ranga Python, a fheiceann an glaonnaí. Cuireann an maisitheoir @workflows.workflow.entrypoint in iúl an modh a ghlaotar ag am tosaithe. Fanann an chéad pharaiméadar, self, mar shampla an ranga, mar atá in aon oibiacht Python, agus úsáideann gach glaonna gníomhaíochta await.

Sampla iomlán: píblíne próiseála

Seo sreabhad oibre réadúil a chomhordaíonn gníomhaíochtaí iolracha chun doiciméad a phróiseáil. Tabhair faoi deara an roinnt oibre: tá an cód go léir a dhéanann teagmháil leis an domhan seachtrach sna trí fheidhm ag an mbarr, ach ní dhéanann an rang ag an mbun ach glaonna await a shlabhrú agus toradh a chur le chéile.

import mistralai.workflows as workflows
from mistralai.client import Mistral

# --- Activities ---

@workflows.activity()
async def extraire_texte(url_document: str) -> dict:
    """Download and extract text from a document."""
    async with httpx.AsyncClient() as client:
        response = await client.get(url_document)
        texte = response.text
    return {"texte": texte, "longueur": len(texte)}

@workflows.activity()
async def analyser_avec_mistral(texte: str) -> dict:
    """Analyze text with Mistral to extract key points."""
    client = Mistral()
    response = await client.chat.complete_async(
        model="mistral-large-latest",
        messages=[
            {"role": "system", "content": "Extract the 5 key points from this text."},
            {"role": "user", "content": texte}
        ]
    )
    return {"analyse": response.choices[0].message.content}

@workflows.activity()
async def sauvegarder_resultat(analyse: dict) -> dict:
    """Save the analysis result."""
    async with httpx.AsyncClient() as client:
        response = await client.post(
            "https://api.example.com/rapports",
            json=analyse
        )
        return {"id_rapport": response.json()["id"]}

# --- Workflow ---

@workflows.workflow.define(name="pipeline_analyse_document")
class PipelineAnalyseDocument:
    @workflows.workflow.entrypoint
    async def run(self, url_document: str) -> dict:
        """Orchestrate extraction, analysis, and saving."""
        # Step 1: Extract text
        extraction = await extraire_texte(url_document)

        # Step 2: Analyze with Mistral
        analyse = await analyser_avec_mistral(extraction["texte"])

        # Step 3: Save
        sauvegarde = await sauvegarder_resultat(analyse)

        return {
            "url_source": url_document,
            "longueur_texte": extraction["longueur"],
            "id_rapport": sauvegarde["id_rapport"]
        }

Is pointe marthanachta é gach await sa sreabhad oibre. Fiú é a fhíorú go meabhrach leis an sampla thuas: má theipeann ar an bpróiseas idir céim 2 agus céim 3, ní íoslódáilfear an doiciméad arís agus ní ghlaofar ar an múnla arís—mar sin, gan muirir breise token. Tosóidh an sreabhad oibre arís díreach ag an gcéim shábhála.

Marthanacht an tsreabha oibre

Maireann sreabhaí oibre trí atosuithe, teipeanna bonneagair, agus earráidí sealadacha toisc go dtaifeadann an ardán gach imeacht agus go ndéanann sé stát an tsreabha oibre a athchruthú le linn athsheinm. Níl an t-athchruthú seo iontaofa ach faoi choinníoll amháin, a luaigh muid cheana: caithfidh cód an tsreabha oibre an seicheamh céanna oibríochtaí a tháirgeadh i gcónaí don ionchur céanna. Is é seo an srian cinnteachta. Pléifimid na mionsonraí i gceacht 8.

Sreabhad oibre le craobhú coinníollach

Ní theoranta do sheicheamh líneach é sreabhad oibre. Is féidir loighic choinníollach a bheith ann, mar atá sa sampla próiseála ordaithe seo ina mbraitheann an cosán ar stádas an stoc:

@workflows.workflow.define(name="traitement_commande")
class OrderProcessing:
    @workflows.workflow.entrypoint
    async def run(self, order: dict) -> dict:
        # Check stock
        stock = await check_stock(order["produit_id"])

        if stock["disponible"]:
            # Standard path
            payment = await process_payment(order["montant"])
            shipment = await prepare_shipment(order)
            await send_confirmation(order["email"], shipment)
            return {"status": "confirmée", "tracking": shipment["tracking"]}
        else:
            # Alternative path
            await notify_stockout(order["email"], order["produit_id"])
            return {"status": "rupture_stock"}

Tá craobhacha if/else taca go hiomlán. Níl ach srian amháin maidir leis an ábhar a úsáidtear don chinneadh: caithfidh toradh na craoibhe brath ar luach tuairisce gníomhaíochta—luach a taifeadadh sa log agus a athsheinntear go hionann—seachas ar ghlaonna díreacha ar sheirbhís sheachtrach ón sreabhad oibre. Anseo, déanann verifier_stock ceist ar an bhfardal laistigh de ghníomhaíocht, agus léann an ráiteas if foclóir a taifeadadh cheana féin.

Ionchuir le Pydantic

Éiríonn sreabhad oibre a ghlacann sé pharaiméadar suíomhach doiléir go tapa. Maidir le hionchuir struchtúrtha, úsáid múnlaí Pydantic, a sholáthraíonn bailíochtú cineáil ag tús an fheidhmithe freisin:

from pydantic import BaseModel

class ReportParams(BaseModel):
    report_type: str
    include_details: bool = False
    start_date: str
    end_date: str

@workflows.workflow.define(name="generation_rapport")
class ReportGeneration:
    @workflows.workflow.entrypoint
    async def run(self, params: ReportParams) -> dict:
        data = await collect_data(params.report_type, params.start_date, params.end_date)
        
        if params.include_details:
            data = await enrich_data(data)
        
        report = await generate_pdf_report(data)
        return {"url_rapport": report["url"]}

Pointe rabhaidh agus tú ag spreagadh an tsreabha oibre seo: nuair a úsáideann tú BaseModel, éiríonn na réimsí ina n-eochracha barrleibhéil sa JSON ionchuir a sheoltar chuig an sreabhad oibre. Seolfaidh tú {"type_rapport": ..., "date_debut": ...}, ní oibiacht neadaithe faoi eochair params.

Dea-chleachtais

Déanann ceithre nós difríocht fadtéarmach. Ar an gcéad dul síos, cloígh le freagracht amháin in aghaidh an tsreabha oibre: déanann meascú billeála agus leanúna díolacháin sa rang céanna sé dodhéanta ceann amháin a athsheinm gan an ceann eile. Ina dhiaidh sin, tabhair aird ar ainmniú, ós rud é gur aitheantóir poiblí é name an tsreabha oibre a ghlaotar ó chórais eile—is inbhuanaithe "traitement_commande", ach ní hea "workflow_1". Ná tabhair isteach aon I/O sa sreabhad oibre: is i ngníomhaíocht a bhaineann gach glaonna líonra, rochtain ar chomhad, nó ceist bunachair sonraí. Ar deireadh, coinnigh cód an tsreabha oibre simplí trí loighic chasta—aistriú, claochluithe, ríomhaireachtaí troma—a aistriú chuig gníomhaíochtaí, áit ar féidir é a thástáil go leithlis gan srianta cinnteachta.

Príomhphointí

  • Is rang é sreabhad oibre atá maisithe le @workflows.workflow.define() a chomhordaíonn gníomhaíochtaí
  • Is é an modh @workflows.workflow.entrypoint an pointe iontrála a ghlaotar ag am tosaithe
  • Is pointe marthanachta é gach await gníomhaíochta (atosú uathoibríoch i gcás teipe)
  • Tacaítear le craobhacha coinníollacha agus lúba
  • Úsáid múnlaí Pydantic do pharaiméadair ionchuir struchtúrtha
  • Ní mór gan aon oibríochtaí I/O díreacha a bheith sa sreabhad oibre