Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Installér Workflows SDK

Lektion 3 af 14 Opdateret 29. juli 2026 Avanceret
På denne side
  1. Tekniske forudsætninger
  2. Tjek din Python-version
  3. Installér uv
  4. Opret et projekt
  5. Installér Workflows SDK
  6. Verificér installationen
  7. Konfigurér din API-nøgle
  8. Hurtig stillads (valgfrit)
  9. Anbefalet projektstruktur
  10. Vigtige pointer

Tekniske forudsætninger

Du skal have fire ting på plads, før du skriver din første linje workflow-kode. For det første skal du bruge Python 3.12 eller nyere, fordi workflows afhænger af moderne async-funktioner, der blev introduceret i denne version. Python 3.11 vil fejle ved importtidspunktet, ikke køretidspunktet, hvilket i det mindste gør fejlen øjeblikkelig. For det andet skal du bruge uv, pakkehåndteringen som Mistral anbefaler til Python-projekter. Den håndterer både virtuelle miljøer og afhængigheder. Endelig skal du bruge en Mistral AI-konto. Opret en på console.mistral.ai, hvis du ikke allerede har en, og generér en API-nøgle i sektionen API Keys i konsollen.

Tjek din Python-version

Start med den mest almindelige forhindring: fortolkerens version.

python --version
# Skal vise Python 3.12.x eller nyere

Hvis din version er lavere end 3.12, skal du opdatere Python, før 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]

Installér uv

Hvis du ikke har uv endnu, skal du installere det. Kommandoen varierer afhængigt af systemet:

# 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"

Verificér derefter, at binary-filen findes i din PATH. Hvis følgende kommando returnerer „ikke fundet”, så åbn en ny terminal. Installationsprogrammet modificerer din shell-profil:

uv --version

Opret et projekt

Opret et nyt Python-projekt med uv:

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

Dette opretter en pyproject.toml-fil og en standardprojektstruktur. Filen pyproject.toml lister dine afhængigheder og gør det muligt for en kollega at genskabe præcis samme miljø.

Installér Workflows SDK

Du har to installationsmuligheder, og valget betyder noget. Hvis du kun har brug for workflow-motoren – fordi dine aktiviteter kalder interne API’er, en database eller tredjepartstjenester – er basisversionen tilstrækkelig:

uv add mistralai-workflows

Hvis du ønsker at bruge holdbare agenter, værktøjskald og overdragelser mellem flere agenter direkte i dine workflows, skal du bruge varianten med extras:

uv add "mistralai-workflows[mistralai]"

Den anden mulighed installerer Mistral AI SDK som en afhængighed og aktiverer native integrationer med Mistral-modeller. Hvis du er usikker i starten af et projekt, er basisversionen lettere. Du kan tilføje extra-pakken senere uden at ødelægge noget.

Verificér installationen

En succesfuld import er bedre end en lang manuel kontrol:

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

Du bør se:

Workflows SDK installed successfully!

Hvis du får en ModuleNotFoundError, så geninstaller ikke med det samme. Tjek først, at du befinder dig i projektmappen, hvor du kørte uv add. Kommandoen uv run løser det virtuelle miljø ud fra den aktuelle mappe.

Konfigurér din API-nøgle

SDK’en godkender via miljøvariablen MISTRAL_API_KEY. Den læses automatisk; du behøver ikke at sende den som et argument. Sæt den i din terminal:

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

# For at gøre det permanent, tilføj det til din ~/.bashrc eller ~/.zshrc
echo export MISTRAL_API_KEY=votre_clé_api_ici >> ~/.bashrc

Denne metode fungerer til lokal udvikling. Til produktionsprojekter bør du foretrække en .env-fil, der indlæses via python-dotenv, eller din deploymentsplatforms hemmelighedsadministrator. En nøgle i en .bashrc-fil vil før eller siden ende i en backup eller en skærmdeling.

Hurtig stillads (valgfrit)

Mistral tilbyder et CLI-værktøj, der genererer et komplet workflow-projekt. Dette er nyttigt for at se den forventede struktur, før du skriver din egen:

uvx mistralai-workflows-cli setup

Kommandoen producerer en eksempel-workflow-fil, en aktivitetsfil, en arbejder, der er klar til start, og grundlæggende konfiguration. På få sekunder får du et kørende projekt. Du kan derefter skille det ad stykke for stykke for at forstå rollen for hver komponent, før du starter fra bunden.

Anbefalet projektstruktur

Til et produktions-workflow-projekt anbefaler vi denne struktur:

mon-workflow-mistral/
├── pyproject.toml          # Afhængigheder (mistralai-workflows)
├── .env                    # API-nøgle (commit ikke denne)
├── activities/
│   ├── __init__.py
│   ├── email.py            # Aktiviteter relateret til e-mail
│   └── data_processing.py  # Aktiviteter til databehandling
├── workflows/
│   ├── __init__.py
│   └── pipeline.py         # Workflow-definitioner
└── worker.py               # Indgangspunkt for worker

Adskillelse af aktiviteter fra workflows gør vedligeholdelse og unit-testning lettere. En aktivitet er en standard async-funktion, du kan kalde direkte i en test, mens et workflow kræver motoren for at køre. Denne adskillelse tager fem minutter i starten af et projekt og sparer dig for meget tid, når du har mere end ti aktiviteter.

Vigtige pointer

  • Python 3.12+ og uv er påkrævet til Workflows SDK
  • To installationstilstande: basis (mistralai-workflows) eller med AI-integration (mistralai-workflows[mistralai])
  • Konfigurér API-nøglen via miljøvariablen MISTRAL_API_KEY
  • Kommandoen uvx mistralai-workflows-cli setup genererer et komplet eksempelprojekt
  • Adskil dine aktiviteter, workflows og worker i separate filer for bedre vedligeholdelighed