Installera Workflows SDK
På denna sida
Tekniska förutsättningar
Du behöver ha fyra saker på plats innan du skriver din första rad med workflow-kod. Först behöver du Python 3.12 eller högre eftersom workflows förlitar sig på moderna async-funktioner som introducerades i denna version. Python 3.11 kommer att misslyckas vid import, inte vid körning, vilket åtminstone gör felet omedelbart synligt. För det andra behöver du uv, pakethanteraren som Mistral rekommenderar för Python-projekt. Den hanterar både virtuella miljöer och beroenden. Slutligen behöver du ett Mistral AI-konto. Skapa ett på console.mistral.ai om du inte redan har gjort det, och generera en API-nyckel i avsnittet API Keys i konsolen.
Kontrollera din Python-version
Börja med den vanligaste flaskhalsen: tolkens version.
python --version
# Måste visa Python 3.12.x eller högre
Om din version är lägre än 3.12 måste du uppdatera Python innan du fortsätter. På Ubuntu/Debian:
sudo apt update
sudo apt install python3.12 python3.12-venv
På macOS med Homebrew:
brew install [email protected]
Installera uv
Om du inte har uv än, installera det. Kommandot skiljer sig åt beroende på system:
# 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"
Verifiera sedan att binären finns i din PATH. Om följande kommando returnerar “not found”, öppna en ny terminal. Installationsprogrammet modifierar din skalprofil:
uv --version
Skapa ett projekt
Skapa ett nytt Python-projekt med uv:
mkdir mon-workflow-mistral
cd mon-workflow-mistral
uv init
Detta skapar en fil pyproject.toml och en standardprojektstruktur. Filen pyproject.toml listar dina beroenden och låter en kollega återskapa exakt samma miljö.
Installera Workflows SDK
Du har två installationsalternativ, och valet spelar roll. Om du bara behöver workflow-motorn – eftersom dina aktiviteter anropar interna API:er, en databas eller tredjepartstjänster – räcker basversionen:
uv add mistralai-workflows
Om du vill använda hållbara agenter, verktygsanrop och överlämningar mellan flera agenter direkt i dina workflows, använd varianten med extrafunktioner:
uv add "mistralai-workflows[mistralai]"
Det andra alternativet installerar Mistral AI SDK som ett beroende och aktiverar native-integrationer med Mistral-modeller. Om du är osäker i början av ett projekt är basversionen lättare. Du kan lägga till extrafunktionerna senare utan att något går sönder.
Verifiera installationen
En lyckad import slår en lång manuell kontroll:
uv run python -c "import mistralai.workflows; print('Workflows SDK installed successfully!')"
Du bör se:
Workflows SDK installed successfully!
Om du får ett ModuleNotFoundError, installera inte om direkt. Kontrollera först att du befinner dig i projektmappen där du körde uv add. Kommandot uv run löser den virtuella miljön från den aktuella katalogen.
Konfigurera din API-nyckel
SDK:t autentiserar via miljövariabeln MISTRAL_API_KEY. Den läses automatiskt; du behöver inte skicka den som ett argument. Ställ in den i din terminal:
# Linux / macOS
export MISTRAL_API_KEY="votre_clé_api_ici"
# För att göra det permanent, lägg till det i din ~/.bashrc eller ~/.zshrc
echo export MISTRAL_API_KEY=votre_clé_api_ici >> ~/.bashrc
Denna metod fungerar för lokal utveckling. För produktionsprojekt bör du föredra en .env-fil som laddas via python-dotenv eller din deploymentsplattformens hemlighetshanterare. En nyckel i en .bashrc-fil hamnar förr eller senare i en backup eller en skärmdelning.
Snabbstrukturering (valfritt)
Mistral tillhandahåller ett CLI-verktyg som genererar ett komplett workflow-projekt. Detta är användbart för att se den förväntade strukturen innan du skriver din egen kod:
uvx mistralai-workflows-cli setup
Kommandot producerar en exempel-workflow-fil, en aktivitetsfil, en arbetare redo att starta och en grundläggande konfiguration. På några sekunder har du ett fungerande projekt. Du kan sedan plocka isär det bit för bit för att förstå rollen för varje komponent innan du börjar från början.
Rekommenderad projektstruktur
För ett workflow-projekt i produktion rekommenderar vi följande struktur:
mon-workflow-mistral/
├── pyproject.toml # Beroenden (mistralai-workflows)
├── .env # API-nyckel (commit:a inte)
├── activities/
│ ├── __init__.py
│ ├── email.py # E-postrelaterade aktiviteter
│ └── data_processing.py # Aktiviteter för databehandling
├── workflows/
│ ├── __init__.py
│ └── pipeline.py # Workflow-definitioner
└── worker.py # Startpunkt för arbetaren
Att separera aktiviteter från workflows gör underhåll och enhetstestning enklare. En aktivitet är en vanlig async-funktion som du kan anropa direkt i ett test, medan en workflow kräver motorn för att köras. Denna separation tar fem minuter i början av ett projekt och sparar dig mycket tid när du har fler än tio aktiviteter.
Viktiga punkter
- Python 3.12+ och uv krävs för Workflows SDK
- Två installationslägen: bas (
mistralai-workflows) eller med AI-integration (mistralai-workflows[mistralai]) - Konfigurera API-nyckeln via miljövariabeln
MISTRAL_API_KEY - Kommandot
uvx mistralai-workflows-cli setupgenererar ett komplett exempelprojekt - Separera dina aktiviteter, workflows och arbetare i distinkta filer för bättre underhållbarhet