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

Cruthaigh oibrí

Ceacht 6 as 14 Nuashonraithe 29 Iúil 2026 Ardleibhéal
Ar an leathanach seo
  1. Ról an oibrí
  2. Oibrí íosta a chruthú
  3. Cad a dhéanann run_worker()
  4. Oibrí le sreabhair oibre iolracha
  5. Struchtúr comhaid molta
  6. Tosaigh an t-oibrí
  7. Oibrí i dtáirgeadh
  8. Príomhphointí

Ról an oibrí

Is é an t-oibrí an próiseas Python a fhorghníomhaíonn do shreabhair oibre agus do ghníomhaíochtaí i ndáiríre. Déanann sé nasc leis an ardán Mistral, éisteann sé le tascanna atá ar feitheamh, agus rithíonn sé iad go logánta ar do mheaisín nó ar do fhreastalaí. Go minic, cuireann an mionsonraí ailtireachta seo iontas ar dhaoine nua: ní fhágann do chód do thimpeallacht riamh; níl ach staid na hordaithe ag Mistral.

Is díreach an impleacht a mhíníonn formhór na bhfadhbanna “níl aon rud ag tarlú” a thagann chun cinn go luath i dtionscadal: gan oibrí ag rith, ní féidir le do shreabhair oibre feidhmiú. Is féidir leat forghníomhú a spreagadh, ach fanfaidh sé go dtí go mbeidh oibrí in ann le feiceáil. Is é an t-oibrí an nasc idir ardán ordaithe Mistral agus do chód logánta.

Oibrí íosta a chruthú

Oireann oibrí feidhmiúil i líon beag línte. Comhcheanglaíonn an sampla thíos an ghníomhaíocht, an sreabhadh oibre, agus an loighic tosaithe d’aon ghnó i gcomhad amháin ionas gur féidir leat é a rith láithreach:

import asyncio
import mistralai.workflows as workflows

# Import your workflows and activities
@workflows.activity()
async def dire_bonjour(nom: str) -> dict:
    return {"message": f"Bonjour, {nom} !"}

@workflows.workflow.define(name="salutation_workflow")
class SalutationWorkflow:
    @workflows.workflow.entrypoint
    async def run(self, nom: str) -> dict:
        resultat = await dire_bonjour(nom)
        return resultat

# Start the worker
async def main() -> None:
    await workflows.run_worker([SalutationWorkflow])

if __name__ == "__main__":
    asyncio.run(main())

Is é workflows.run_worker() an fheidhm lárnach. Glacann sé le liosta de ranganna sreabha oibre is féidir leis an oibrí seo a fhorghníomhú—agus sreabhair oibre amháin. Faightear amach gníomhaíochtaí tríd na ranganna sin, mar sin ní gá duit gníomhaíochtaí a liostú ar leithligh.

Cad a dhéanann run_worker()

Nuair a ghlaonn tú workflows.run_worker([MyWorkflow]), tarlaíonn cúig rud as a chéile. Ar dtús, déanann an t-oibrí fíordheimhniú leis an ardán Mistral ag baint úsáide as do eochair API. Ansin, cláraíonn sé na sreabhair oibre agus na gníomhaíochtaí a dearbhaíodh. Ligeann an chlárúchán seo don ardán a fháil amach go bhfuil forghníomhaitheoir ann don aitheantóir salutation_workflow. Ina dhiaidh sin, osclaíonn sé nasc buan agus fanann sé le tascanna, ag fanacht go dánta go dtí go spreagtar forghníomhú. Nuair a thagann forghníomhú, rithíonn an t-oibrí an cód go logánta, agus seoltar na torthaí ar ais chuig an ardán le haghaidh marthanachta.

Fanann an t-oibrí gníomhach fad is a ritheann an próiseas Python, rud a fhágann nach dtugann sé smacht ar ais do do theirminéal riamh. Úsáid Ctrl+C chun é a stopadh go slán.

Oibrí le sreabhair oibre iolracha

Ní gá oibrí amháin in aghaidh an tsreabha oibre. Is féidir le próiseas amháin óstáil a dhéanamh ar shreabhair oibre iolracha, fiú nuair a roinneann siad gníomhaíochtaí. Anseo, feidhmíonn extraire_texte agus analyser_sentiment don dá cheann:

import asyncio
import mistralai.workflows as workflows

# --- Activities ---

@workflows.activity()
async def extraire_texte(url: str) -> dict:
    async with httpx.AsyncClient() as client:
        response = await client.get(url)
    return {"texte": response.text}

@workflows.activity()
async def analyser_sentiment(texte: str) -> dict:
    client = Mistral()
    response = await client.chat.complete_async(
        model="mistral-large-latest",
        messages=[
            {"role": "system", "content": "Analysez le sentiment : positif, négatif ou neutre."},
            {"role": "user", "content": texte}
        ]
    )
    return {"sentiment": response.choices[0].message.content}

@workflows.activity()
async def envoyer_alerte(message: str) -> dict:
    # Envoi vers Slack, email, etc.
    return {"status": "envoyé"}

# --- Workflows ---

@workflows.workflow.define(name="analyse_document")
class DocumentAnalysis:
    @workflows.workflow.entrypoint
    async def run(self, url: str) -> dict:
        extraction = await extraire_texte(url)
        sentiment = await analyser_sentiment(extraction["texte"])
        return sentiment

@workflows.workflow.define(name="surveillance_mentions")
class MentionMonitoring:
    @workflows.workflow.entrypoint
    async def run(self, url: str, seuil: str) -> dict:
        extraction = await extraire_texte(url)
        sentiment = await analyser_sentiment(extraction["texte"])
        if sentiment["sentiment"] == "négatif":
            await envoyer_alerte(f"Mention négative détectée : {url}")
        return sentiment

# --- Worker ---

async def main() -> None:
    await workflows.run_worker([
        DocumentAnalysis,
        MentionMonitoring,
    ])

if __name__ == "__main__":
    asyncio.run(main())

Struchtúr comhaid molta

Oibríonn comhad amháin chun foghlama, ach ní oibríonn sé do thionscadal beo. Maidir le táirgeadh, scar do chód i modúil de réir cineáil:

mon-projet/
├── activities/
│   ├── __init__.py
│   ├── extraction.py      # extraire_texte()
│   ├── analyse.py          # analyser_sentiment()
│   └── notifications.py    # envoyer_alerte()
├── workflows/
│   ├── __init__.py
│   ├── analyse_document.py
│   └── surveillance.py
└── worker.py               # Single entry point

Níl ach allmhairithe agus loighic tosaithe i gcomhad worker.py ansin, rud a fhágann go bhfuil sé ina chatalóg inléite de na rudaí is féidir leis an bpróiseas seo a fhorghníomhú:

import asyncio
import mistralai.workflows as workflows

from workflows.document_analysis import DocumentAnalysis
from workflows.monitoring import MentionMonitoring

async def main() -> None:
    await workflows.run_worker([
        DocumentAnalysis,
        MentionMonitoring,
    ])

if __name__ == "__main__":
    asyncio.run(main())

Tosaigh an t-oibrí

uv run python worker.py

Taispeánann an t-oibrí teachtaireacht nasctha agus fanann sé gníomhach, ag feitheamh le tascanna. Ba chóir duit rud éigin cosúil leis seo a fheiceáil:

Worker connected. Listening for tasks...

Go dtí go dtagann an líne seo amach, ná spreag aon rud. Ar dtús, seiceáil do eochair API agus do nasc líonra.

Oibrí i dtáirgeadh

Imíonn oibrí a sheoltar de láimh i dteirminéal tar éis an chéad dícheangal SSH. Tabhair é do bhainisteoir próisis—systemd, supervisor, nó pm2—a dhéanfaidh é a atosú go huathoibríoch tar éis tuairteála nó atosaithe:

# With pm2 (if Node.js is available)
pm2 start "uv run python worker.py" --name workflow-worker

# With systemd (create a .service file)

Téann an t-atosú uathoibríoch seo go maith le marthanacht: leanann sreabhair oibre atá ag rith ar aghaidh leo féin chomh luath agus a nascann an próiseas nua. Maidir le rúin, ná crua-chódaigh an eochair API riamh sa chomhad oibrí, nó críochnóidh sé i do stór Git. Léann an SDK an athróg timpeallachta go huathoibríoch:

import os

# The SDK automatically reads MISTRAL_API_KEY
# No need to pass it explicitly

Ar deireadh, smaoinigh ar logáil. Eisíonn an t-oibrí teachtaireachtaí trí mhodúl caighdeánach logging Python. Tugann cumraíocht shimplí ag am tosaithe rian duit de ghníomhaíochtaí a forghníomhaíodh, rud atá luachmhar chun tuiscint a fháil ar an méid a bhí ag rith le linn teagmhais:

import logging
logging.basicConfig(level=logging.INFO)

Príomhphointí

  • Is é an t-oibrí an próiseas a fhorghníomhaíonn do shreabhair oibre agus do ghníomhaíochtaí go logánta
  • Glacann workflows.run_worker([...]) le liosta de ranganna sreabha oibre le forghníomhú
  • Is féidir le hoibrí amháin sreabhair oibre éagsúla iolracha a fhorghníomhú
  • Fanann an t-oibrí gníomhach agus éisteann sé le tascanna fad is a ritheann an próiseas
  • I dtáirgeadh, úsáid bainisteoir próisis chun an t-oibrí a choinneáil ag rith
  • Léitear an eochair API go huathoibríoch ó MISTRAL_API_KEY