Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Installera Workflows SDK

Lektion 3 av 14 Uppdaterad 29 juli 2026 Avancerad
På denna sida
  1. Tekniska förutsättningar
  2. Kontrollera din Python-version
  3. Installera uv
  4. Skapa ett projekt
  5. Installera Workflows SDK
  6. Verifiera installationen
  7. Konfigurera din API-nyckel
  8. Snabbstrukturering (valfritt)
  9. Rekommenderad projektstruktur
  10. Viktiga punkter

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 setup genererar ett komplett exempelprojekt
  • Separera dina aktiviteter, workflows och arbetare i distinkta filer för bättre underhållbarhet