Δημιουργία ενός worker
Σε αυτήν τη σελίδα
Ο ρόλος του worker
Ο worker είναι η διαδικασία Python που εκτελεί πραγματικά τα workflows και τις δραστηριότητές σας. Συνδέεται με την πλατφόρμα Mistral, ακούει για εκκρεμείς εργασίες και τις εκτελεί τοπικά στον υπολογιστή ή τον διακομιστή σας. Αυτή η αρχιτεκτονική λεπτομέρεια συχνά εκπλήσσει τους νεοεισερχόμενους: ο κώδικάς σας δεν εγκαταλείπει ποτέ το περιβάλλον σας· μόνο η κατάσταση της ενορχήστρωσης παραμένει στη Mistral.
Η συνέπεια είναι άμεση και εξηγεί τα περισσότερα προβλήματα «δεν συμβαίνει τίποτα» που συναντώνται στην αρχή ενός έργου: χωρίς έναν ενεργό worker, τα workflows σας δεν μπορούν να εκτελεστούν. Μπορείτε να ενεργοποιήσετε μια εκτέλεση, αλλά αυτή θα περιμένει απλώς μέχρι να εμφανιστεί ένας ικανός worker. Ο worker αποτελεί τον σύνδεσμο μεταξύ της πλατφόρμας ενορχήστρωσης Mistral και του τοπικού σας κώδικα.
Δημιουργία ενός ελάχιστου worker
Ένας λειτουργικός worker χωράει σε λίγες μόνο γραμμές. Το παρακάτω παράδειγμα συνδυάζει σκόπιμα τη δραστηριότητα, το workflow και τη λογική εκκίνησης σε ένα ενιαίο αρχείο, ώστε να μπορείτε να το εκτελέσετε άμεσα:
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())
Η βασική συνάρτηση είναι η workflows.run_worker(). Δέχεται μια λίστα κλάσεων workflow που μπορεί να εκτελέσει αυτός ο worker — και μόνο workflows. Οι δραστηριότητες ανακαλύπτονται μέσω αυτών, οπότε δεν χρειάζεται να τις καταγράψετε ξεχωριστά.
Τι κάνει η run_worker()
Όταν καλείτε την workflows.run_worker([MyWorkflow]), συμβαίνουν πέντε πράγματα διαδοχικά. Πρώτον, ο worker πιστοποιείται στην πλατφόρμα Mistral χρησιμοποιώντας το κλειδί API σας. Στη συνέχεια, καταχωρεί τα δηλωμένα workflows και τις δραστηριότητες. Αυτή η καταχώρηση ενημερώνει την πλατφόρμα ότι υπάρχει ένας εκτελεστής για το αναγνωριστικό salutation_workflow. Στη συνέχεια, ανοίγει μια μόνιμη σύνδεση και περιμένει για εργασίες, παραμένοντας σκόπιμα αδρανής μέχρι να ενεργοποιηθεί μια εκτέλεση. Όταν φτάσει μια εκτέλεση, ο worker εκτελεί τον κώδικα τοπικά και τα αποτελέσματα αποστέλλονται πίσω στην πλατφόρμα για μόνιμη αποθήκευση.
Ο worker παραμένει ενεργός όσο τρέχει η διαδικασία Python, γι’ αυτό και δεν επιστρέφει ποτέ τον έλεγχο στο τερματικό σας. Χρησιμοποιήστε το Ctrl+C για να τον σταματήσετε καθαρά.
Worker με πολλαπλά workflows
Τίποτα δεν επιβάλλει έναν worker ανά workflow. Μια ενιαία διαδικασία μπορεί να φιλοξενήσει πολλαπλά workflows, ακόμη και όταν μοιράζονται δραστηριότητες. Εδώ, οι extraire_texte και analyser_sentiment εξυπηρετούν και τα δύο:
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())
Συνιστώμενη δομή αρχείων
Ένα ενιαίο αρχείο λειτουργεί για μάθηση, αλλά όχι για ένα έργο σε παραγωγή. Για παραγωγή, διαχωρίστε τον κώδικά σας σε ενότητες ανά τύπο:
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
Το αρχείο worker.py περιέχει τότε μόνο εισαγωγές και λογική εκκίνησης, καθιστώντας το έναν ευανάγνωστο κατάλογο του τι μπορεί να εκτελέσει αυτή η διαδικασία:
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())
Εκκίνηση του worker
uv run python worker.py
Ο worker εμφανίζει ένα μήνυμα σύνδεσης και παραμένει ενεργός, περιμένοντας για εργασίες. Θα πρέπει να δείτε κάτι παρόμοιο με:
Worker connected. Listening for tasks...
Μέχρι να εμφανιστεί αυτή η γραμμή, μην ενεργοποιήσετε τίποτα. Πρώτα, ελέγξτε το κλειδί API και τη σύνδεση δικτύου σας.
Worker σε παραγωγή
Ένας worker που εκκινείται χειροκίνητα σε ένα τερματικό εξαφανίζεται μετά την πρώτη αποσύνδεση SSH. Αναθέστε τον σε έναν διαχειριστή διαδικασιών — systemd, supervisor ή pm2 — ο οποίος θα τον επανεκκινεί αυτόματα μετά από μια κατάρρευση ή επανεκκίνηση συστήματος:
# With pm2 (if Node.js is available)
pm2 start "uv run python worker.py" --name workflow-worker
# With systemd (create a .service file)
Αυτή η αυτόματη επανεκκίνηση ταιριάζει καλά με την ανθεκτικότητα: τα running workflows επαναλαμβάνονται μόνα τους μόλις συνδεθεί η νέα διαδικασία. Όσον αφορά τα μυστικά, μην κωδικοποιείτε ποτέ το κλειδί API απευθείας στο αρχείο του worker, διαφορετικά θα καταλήξει στο αποθετήριο Git σας. Το SDK διαβάζει αυτόματα τη μεταβλητή περιβάλλοντος:
import os
# The SDK automatically reads MISTRAL_API_KEY
# No need to pass it explicitly
Τέλος, λάβετε υπόψη την καταγραφή συμβάντων (logging). Ο worker εκπέμπει μηνύματα μέσω της τυπικής ενότητας logging της Python. Μια απλή διαμόρφωση κατά την εκκίνηση σας παρέχει ένα ίχνος των εκτελεσμένων δραστηριοτήτων, το οποίο είναι πολύτιμο για να κατανοήσετε τι εκτελούνταν κατά τη διάρκεια ενός περιστατικού:
import logging
logging.basicConfig(level=logging.INFO)
Βασικά σημεία
- Ο worker είναι η διαδικασία που εκτελεί τα workflows και τις δραστηριότητές σας τοπικά
- Η
workflows.run_worker([...])δέχεται μια λίστα κλάσεων workflow προς εκτέλεση - Ένας ενιαίος worker μπορεί να εκτελέσει πολλαπλά διαφορετικά workflows
- Ο worker παραμένει ενεργός και ακούει για εργασίες όσο τρέχει η διαδικασία
- Σε παραγωγή, χρησιμοποιήστε έναν διαχειριστή διαδικασιών για να διατηρήσετε τον worker σε λειτουργία
- Το κλειδί API διαβάζεται αυτόματα από το
MISTRAL_API_KEY