Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Installi Workflows SDK

Õppetund 3 / 14 Värskendatud 29. juuli 2026 Edasijõudnutele
Sellel lehel
  1. Tehnilised eeldused
  2. Kontrolli Pythoni versiooni
  3. Installi uv
  4. Loo projekt
  5. Installi Workflows SDK
  6. Kontrolli installimist
  7. Konfigureeri oma API võti
  8. Kiire struktuuri loomine (valikuline)
  9. Soovitatud projekti struktuur
  10. Peamised punktid

Tehnilised eeldused

Enne esimese töövoo koodirea kirjutamist pead ette valmistama neli asja. Esiteks vajad Pythoni versiooni 3.12 või uuemat, kuna töövood tuginevad selles versioonis kasutusele võetud kaasaegsetele asünkroonsetele funktsioonidele. Python 3.11 puhul nurjub importimine juba laadimisetapis, mitte käivitamisel, mis teeb vea vähemalt koheselt nähtavaks. Teiseks vajad uv-d, paketihaldurit, mida Mistral soovitab Pythoni projektide jaoks. See haldab nii virtuaalseid keskkondi kui ka sõltuvusi. Lõpuks vajad Mistral AI kontot. Kui sul seda veel pole, loo konto aadressil console.mistral.ai ja genereeri konsooli API võtmete sektsioonis API võti.

Kontrolli Pythoni versiooni

Alusta kõige levinumast takistusest: interpretaatori versioonist.

python --version
# Peab näitama Python 3.12.x või uuemat

Kui sinu versioon on vanem kui 3.12, uuenda Pythonit enne jätkamist. Ubuntu/Debiani süsteemis:

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

macOS-is Homebrew’ga:

brew install [email protected]

Installi uv

Kui sul pole veel uv-d, installi see. Käsk erineb sõltuvalt süsteemist:

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

Seejärel veendu, et binaarfail on sinu PATH-is. Kui järgmine käsk tagastab „not found“, ava uus terminal. Installija muudab sinu kesta profiili:

uv --version

Loo projekt

Loo uus Pythoni projekt käsuga uv:

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

See loob faili pyproject.toml ja standardse projekti struktuuri. Fail pyproject.toml loetleb sinu sõltuvused ja võimaldab kolleegil luua täpselt sama keskkonna.

Installi Workflows SDK

Sul on kaks installimisvõimalust ja valik loeb. Kui vajad ainult töövoo mootorit – sest sinu tegevused kutsuvad sisemisi API-sid, andmebaasi või kolmandate osapoolte teenuseid – piisab põhiversioonist:

uv add mistralai-workflows

Kui soovid kasutada kestvaid agente, tööriistade kutsumist ja mitme agendi vahelist üleminekut otse oma töövoodes, kasuta varianti lisadega:

uv add "mistralai-workflows[mistralai]"

Teine valik installib Mistral AI SDK sõltuvusena ja võimaldab native integratsiooni Mistrali mudelitega. Kui oled projekti alguses unsure, on põhiversioon kergem. Saad lisad hiljem lisada ilma midagi katki tegemata.

Kontrolli installimist

Edukas import on parem kui pikk manuaalne kontroll:

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

Sa peaksid nägema:

Workflows SDK installed successfully!

Kui saad vea ModuleNotFoundError, ära hakka kohe uuesti installima. Kontrolli esmalt, et oled selles projektikaustas, kus käivitasid uv add. Käsk uv run lahendab virtuaalse keskkonna praeguse kataloogi põhjal.

Konfigureeri oma API võti

SDK autentib ennast keskkonnamuutuja MISTRAL_API_KEY kaudu. See loeb selle automaatselt; sa ei pea seda argumendina edastama. Määra see oma terminalis:

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

# Püsivaks muutmiseks lisa see faili ~/.bashrc või ~/.zshrc
echo export MISTRAL_API_KEY=votre_clé_api_ici >> ~/.bashrc

See meetod sobib kohalikuks arenduseks. Tootmisprojektide eelista .env faili, mida laaditakse python-dotenv kaudu, või sinu deploomeerimisplatvormi saladuste haldurit. Võti .bashrc failis satub lõpuks varukoopiasse või ekraanijagamisele.

Kiire struktuuri loomine (valikuline)

Mistral pakub CLI tööriista, mis genereerib täieliku töövoo projekti. See on kasulik, et näha oodatavat struktuuri enne oma koodi kirjutamist:

uvx mistralai-workflows-cli setup

Käsk loob näidise töövoo faili, tegevuste faili, valmis töötaja ja põhikonfiguratsiooni. Sekunditega on sul jooksev projekt. Saad selle seejärel tükkhaaval lahti võtta, et mõista iga komponendi rolli enne nullist alustamist.

Soovitatud projekti struktuur

Tootmiseks mõeldud töövoo projekti soovitame järgmist struktuuri:

mon-workflow-mistral/
├── pyproject.toml          # Sõltuvused (mistralai-workflows)
├── .env                    # API võti (ära kommiidi)
├── activities/
│   ├── __init__.py
│   ├── email.py            # E-postiga seotud tegevused
│   └── data_processing.py  # Andmetöötluse tegevused
├── workflows/
│   ├── __init__.py
│   └── pipeline.py         # Töövoogude definitsioonid
└── worker.py               # Töötaja sisendpunkt

Tegevuste ja töövoogude eraldamine muudab hoolduse ja unit-testimise lihtsamaks. Tegevus on tavaline asünkroonne funktsioon, mida saad testis otse kutsuda, samas kui töövoo käivitamiseks on vaja mootorit. See eraldamine võtab projekti alguses viis minutit, kuid säästab palju aega, kui sul on rohkem kui kümme tegevust.

Peamised punktid

  • Workflows SDK jaoks on vajalikud Python 3.12+ ja uv
  • Kaks installimisrežiimi: põhiline (mistralai-workflows) või AI-integratsiooniga (mistralai-workflows[mistralai])
  • Konfigureeri API võti keskkonnamuutuja MISTRAL_API_KEY kaudu
  • Käsk uvx mistralai-workflows-cli setup genereerib täieliku näidisprojekti
  • Eralda oma tegevused, töövood ja töötaja erinevatesse failidesse parema hooldatavuse huvides