Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Εγκατάσταση του Workflows SDK

Μάθημα 3 / 14 Ενημερώθηκε 29 Ιουλίου 2026 Προχωρημένος
Σε αυτήν τη σελίδα
  1. Τεχνικές προϋποθέσεις
  2. Έλεγχος της έκδοσης Python
  3. Εγκατάσταση του uv
  4. Δημιουργία έργου
  5. Εγκατάσταση του Workflows SDK
  6. Επαλήθευση της εγκατάστασης
  7. Διαμόρφωση του κλειδιού API
  8. Γρήγορη δημιουργία σκελετού (προαιρετικό)
  9. Συνιστώμενη δομή έργου
  10. Βασικά σημεία

Τεχνικές προϋποθέσεις

Πριν γράψετε την πρώτη γραμμή κώδικα workflow, πρέπει να έχετε στη διάθεσή σας τέσσερα στοιχεία. Πρώτον, χρειάζεστε Python 3.12 ή νεότερη έκδοση, καθώς τα workflows βασίζονται σε σύγχρονες λειτουργίες async που εισήχθησαν σε αυτή την έκδοση. Η Python 3.11 θα αποτύχει κατά την εισαγωγή (import) και όχι κατά την εκτέλεση, γεγονός που τουλάχιστον καθιστά το σφάλμα άμεσο. Δεύτερον, χρειάζεστε το uv, τον διαχειριστή πακέτων που προτείνει η Mistral για έργα Python. Διαχειρίζεται τόσο τα εικονικά περιβάλλοντα όσο και τις εξαρτήσεις. Τέλος, χρειάζεστε έναν λογαριασμό Mistral AI. Δημιουργήστε έναν στον ιστότοπο console.mistral.ai εάν δεν έχετε ήδη, και δημιουργήστε ένα κλειδί API στην ενότητα API Keys της κονσόλας.

Έλεγχος της έκδοσης Python

Ξεκινήστε με το πιο συχνό εμπόδιο: την έκδοση του διερμηνέα.

python --version
# Πρέπει να εμφανίζει Python 3.12.x ή νεότερη

Εάν η έκδοσή σας είναι χαμηλότερη από την 3.12, ενημερώστε την Python πριν συνεχίσετε. Σε Ubuntu/Debian:

sudo apt update
sudo apt install python3.12 python3.12-venv

Σε macOS με Homebrew:

brew install [email protected]

Εγκατάσταση του uv

Εάν δεν έχετε ακόμη το uv, εγκαταστήστε το. Η εντολή διαφέρει ανάλογα με το σύστημα:

# Linux / macOS
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Στη συνέχεια, επαληθεύστε ότι το εκτελέσιμο αρχείο βρίσκεται στο PATH σας. Εάν η παρακάτω εντολή επιστρέψει “not found”, ανοίξτε ένα νέο τερματικό. Το πρόγραμμα εγκατάστασης τροποποιεί το προφίλ του κελύφους σας:

uv --version

Δημιουργία έργου

Δημιουργήστε ένα νέο έργο Python με το uv:

mkdir mon-workflow-mistral
cd mon-workflow-mistral
uv init

Αυτό δημιουργεί ένα αρχείο pyproject.toml και μια τυπική δομή έργου. Το αρχείο pyproject.toml παραθέτει τις εξαρτήσεις σας και επιτρέπει σε έναν συνάδελφο να αναπαράγει ακριβώς το ίδιο περιβάλλον.

Εγκατάσταση του Workflows SDK

Έχετε δύο επιλογές εγκατάστασης και η επιλογή έχει σημασία. Εάν χρειάζεστε μόνο τη μηχανή workflows—επειδή οι δραστηριότητές σας καλούν εσωτερικά API, μια βάση δεδομένων ή υπηρεσίες τρίτων—η βασική έκδοση αρκεί:

uv add mistralai-workflows

Εάν θέλετε να χρησιμοποιήσετε ανθεκτικούς πράκτορες (durable agents), κλήσεις εργαλείων και μεταβιβάσεις μεταξύ πολλαπλών πρακτόρων απευθείας στα workflows σας, χρησιμοποιήστε την παραλλαγή με τα extras:

uv add "mistralai-workflows[mistralai]"

Η δεύτερη επιλογή εγκαθιστά το Mistral AI SDK ως εξάρτηση και ενεργοποιεί εγγενείς ενσωματώσεις με τα μοντέλα της Mistral. Εάν δεν είστε σίγουροι στην αρχή ενός έργου, η βασική έκδοση είναι πιο ελαφριά. Μπορείτε να προσθέσετε το extra αργότερα χωρίς να προκαλέσετε προβλήματα.

Επαλήθευση της εγκατάστασης

Μια επιτυχής εισαγωγή (import) αξίζει περισσότερο από έναν μακροσκελή χειροκίνητο έλεγχο:

uv run python -c "import mistralai.workflows; print('Workflows SDK installed successfully!')"

Θα πρέπει να δείτε:

Workflows SDK installed successfully!

Εάν λάβετε ένα ModuleNotFoundError, μην προχωρήσετε αμέσως σε επανεγκατάσταση. Πρώτα, ελέγξτε ότι βρίσκεστε στον φάκελο του έργου όπου εκτελέσατε την εντολή uv add. Η εντολή uv run επιλύει το εικονικό περιβάλλον από τον τρέχοντα κατάλογο.

Διαμόρφωση του κλειδιού API

Το SDK πιστοποιείται μέσω της μεταβλητής περιβάλλοντος MISTRAL_API_KEY. Την διαβάζει αυτόματα· δεν χρειάζεται να την περάσετε ως όρισμα. Ορίστε την στο τερματικό σας:

# Linux / macOS
export MISTRAL_API_KEY="votre_clé_api_ici"

# Για να την κάνετε μόνιμη, προσθέστε την στο ~/.bashrc ή ~/.zshrc
echo export MISTRAL_API_KEY=votre_clé_api_ici >> ~/.bashrc

Αυτή η μέθοδος λειτουργεί για τοπική ανάπτυξη. Για έργα παραγωγής, προτιμήστε ένα αρχείο .env που φορτώνεται μέσω του python-dotenv ή τον διαχειριστή μυστικών της πλατφόρμας ανάπτυξής σας. Ένα κλειδί σε ένα αρχείο .bashrc θα καταλήξει αργά ή γρήγορα σε ένα αντίγραφο ασφαλείας ή σε μια κοινή χρήση οθόνης.

Γρήγορη δημιουργία σκελετού (προαιρετικό)

Η Mistral παρέχει ένα εργαλείο CLI που δημιουργεί ένα πλήρες έργο workflow. Αυτό είναι χρήσιμο για να δείτε την αναμενόμενη δομή πριν γράψετε τον δικό σας κώδικα:

uvx mistralai-workflows-cli setup

Η εντολή παράγει ένα αρχείο δείγματος workflow, ένα αρχείο δραστηριότητας, έναν worker έτοιμο για εκκίνηση και βασική διαμόρφωση. Σε λίγα δευτερόλεπτα, αποκτάτε ένα λειτουργικό έργο. Στη συνέχεια, μπορείτε να το αναλύσετε κομμάτι-κομμάτι για να κατανοήσετε τον ρόλο κάθε στοιχείου πριν ξεκινήσετε από το μηδέν.

Συνιστώμενη δομή έργου

Για ένα έργο workflow παραγωγής, συνιστούμε την ακόλουθη δομή:

mon-workflow-mistral/
├── pyproject.toml          # Εξαρτήσεις (mistralai-workflows)
├── .env                    # Κλειδί API (να μην commit-αριστεί)
├── activities/
│   ├── __init__.py
│   ├── email.py            # Δραστηριότητες σχετικές με email
│   └── data_processing.py  # Δραστηριότητες επεξεργασίας δεδομένων
├── workflows/
│   ├── __init__.py
│   └── pipeline.py         # Ορισμοί Workflow
└── worker.py               # Σημείο εισόδου του Worker

Ο διαχωρισμός των δραστηριοτήτων από τα workflows καθιστά τη συντήρηση και τον έλεγχο μονάδας (unit testing) ευκολότερους. Μια δραστηριότητα είναι μια τυπική async συνάρτηση που μπορείτε να καλέσετε απευθείας σε ένα τεστ, ενώ ένα workflow απαιτεί τη μηχανή για να εκτελεστεί. Αυτός ο διαχωρισμός παίρνει πέντε λεπτά στην αρχή ενός έργου και σας εξοικονομεί πολύ χρόνο μόλις αποκτήσετε περισσότερες από δέκα δραστηριότητες.

Βασικά σημεία

  • Απαιτούνται Python 3.12+ και uv για το Workflows SDK
  • Δύο λειτουργίες εγκατάστασης: βασική (mistralai-workflows) ή με ενσωμάτωση AI (mistralai-workflows[mistralai])
  • Διαμορφώστε το κλειδί API μέσω της μεταβλητής περιβάλλοντος MISTRAL_API_KEY
  • Η εντολή uvx mistralai-workflows-cli setup δημιουργεί ένα πλήρες έργο δείγματος
  • Διαχωρίστε τις δραστηριότητες, τα workflows και τον worker σε ξεχωριστά αρχεία για καλύτερη συντηρησιμότητα