Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Instalē Workflows SDK

Nodarbība 3 no 14 Atjaunota 2026. gada 29. jūlijs Augstākais
Šajā lapā
  1. Tehniskās priekšprasības
  2. Pārbaudi savu Python versiju
  3. Instalē uv
  4. Izveido projektu
  5. Instalē Workflows SDK
  6. Pārbaudi instalāciju
  7. Konfigurē savu API atslēgu
  8. Ātra struktūras ģenerēšana (pēc izvēles)
  9. Ieteicamā projekta struktūra
  10. Galvenās atziņas

Tehniskās priekšprasības

Pirms uzraksti savu pirmo darba plūsmas koda rindiņu, tev ir jānodrošina četras lietas. Pirmkārt, tev ir nepieciešams Python 3.12 vai jaunāka versija, jo darba plūsmas paļaujas uz mūsdienu asinhronajām funkcijām, kas ieviestas šajā versijā. Python 3.11 neizdosies importēšanas brīdī, nevis izpildes laikā, kas vismaz padara kļūdu tūlītēju. Otrkārt, tev ir nepieciešams uv, pakotņu pārvaldnieks, ko Mistral iesaka Python projektiem. Tas pārvalda gan virtuālās vides, gan atkarības. Visbeidzot, tev ir nepieciešams Mistral AI konts. Izveido to vietnē console.mistral.ai, ja tas vēl nav izdarīts, un ģenerē API atslēgu konsoles sadaļā “API Keys”.

Pārbaudi savu Python versiju

Sāc ar visbiežāk sastopamo šķērsli: interpretatora versiju.

python --version
# Jāparāda Python 3.12.x vai jaunāka

Ja tava versija ir zemāka par 3.12, atjaunini Python, pirms turpini. Sistēmā Ubuntu/Debian:

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

Sistēmā macOS ar Homebrew:

brew install [email protected]

Instalē uv

Ja tev vēl nav uv, instalē to. Komanda atšķiras atkarībā no sistēmas:

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

Tad pārbaudi, vai binārais fails ir tavā PATH. Ja šī komanda atgriež “not found”, atver jaunu termināli. Instalētājs modificē tava čaulas profilu:

uv --version

Izveido projektu

Izveido jaunu Python projektu, izmantojot uv:

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

Tas izveido pyproject.toml failu un standarta projekta struktūru. Fails pyproject.toml uzskaita tavas atkarības un ļauj kolēģim atveidot tieši tādu pašu vidi.

Instalē Workflows SDK

Tev ir divas instalēšanas iespējas, un izvēlei ir nozīme. Ja tev ir nepieciešams tikai darba plūsmas dzinējs – jo tavas aktivitātes izsauc iekšējās API, datubāzi vai trešo pušu pakalpojumus –, pietiek ar pamata versiju:

uv add mistralai-workflows

Ja vēlies izmantot noturīgos aģentus, rīku izsaukumus un vairāku aģentu nodošanu tieši savās darba plūsmās, izmanto variantu ar papildinājumiem:

uv add "mistralai-workflows[mistralai]"

Otrā opcija instalē Mistral AI SDK kā atkarību un iespējo natīvo integrāciju ar Mistral modeļiem. Ja projekta sākumā neesi pārliecināts, pamata versija ir vieglāka. Papildinājumu vari pievienot vēlāk, neko nesabojājot.

Pārbaudi instalāciju

Veiksmīga importēšana ir labāka par garu manuālu pārbaudi:

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

Tev vajadzētu redzēt:

Workflows SDK installed successfully!

Ja saņem kļūdu ModuleNotFoundError, neinstalē uzreiz no jauna. Vispirms pārbaudi, vai atrodies projekta mapē, kurā palaidi uv add. Komanda uv run atrisina virtuālo vidi no pašreizējā direktorija.

Konfigurē savu API atslēgu

SDK autentificējas, izmantojot vides mainīgo MISTRAL_API_KEY. Tas to nolasa automātiski; tev nav jānodod tas kā arguments. Iestati to savā terminālī:

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

# Lai padarītu to pastāvīgu, pievieno to savam ~/.bashrc vai ~/.zshrc
echo export MISTRAL_API_KEY=votre_clé_api_ici >> ~/.bashrc

Šī metode darbojas lokālai izstrādei. Ražošanas projektiem dod priekšroku .env failam, ko ielādē, izmantojot python-dotenv, vai savas izvietošanas platformas noslēpumu pārvaldniekam. Atslēga .bashrc failā galu galā nonāks dublējumkopijā vai ekrāna koplietošanas sesijā.

Ātra struktūras ģenerēšana (pēc izvēles)

Mistral nodrošina CLI rīku, kas ģenerē pilnu darba plūsmas projektu. Tas ir noderīgi, lai redzētu paredzēto struktūru, pirms raksti savu:

uvx mistralai-workflows-cli setup

Komanda ģenerē parauga darba plūsmas failu, aktivitātes failu, gatavu darbinieku un pamata konfigurāciju. Dažās sekundēs iegūsti funkcionējošu projektu. Pēc tam vari to izjaukt pa daļām, lai saprastu katra komponenta lomu, pirms sāc no nulles.

Ieteicamā projekta struktūra

Ražošanas darba plūsmas projektam mēs iesakām šādu struktūru:

mon-workflow-mistral/
├── pyproject.toml          # Atkarības (mistralai-workflows)
├── .env                    # API atslēga (neiekļaut versiju kontrolē)
├── activities/
│   ├── __init__.py
│   ├── email.py            # Ar e-pastu saistītas aktivitātes
│   └── data_processing.py  # Datu apstrādes aktivitātes
├── workflows/
│   ├── __init__.py
│   └── pipeline.py         # Darba plūsmu definīcijas
└── worker.py               # Darbinieka ieejas punkts

Aktivitāšu atdalīšana no darba plūsmām atvieglo uzturēšanu un vienību testēšanu. Aktivitāte ir standarta asinhrona funkcija, ko vari izsaukt tieši testā, savukārt darba plūsmai darbībai ir nepieciešams dzinējs. Šī atdalīšana projekta sākumā aizņem piecas minūtes un ietaupa daudz laika, kad tev būs vairāk nekā desmit aktivitātes.

Galvenās atziņas

  • Darba plūsmu SDK ir nepieciešams Python 3.12+ un uv
  • Divi instalēšanas režīmi: pamata (mistralai-workflows) vai ar AI integrāciju (mistralai-workflows[mistralai])
  • Konfigurē API atslēgu, izmantojot vides mainīgo MISTRAL_API_KEY
  • Komanda uvx mistralai-workflows-cli setup ģenerē pilnu parauga projektu
  • Atdali savas aktivitātes, darba plūsmas un darbinieku atsevišķos failos, lai uzlabotu uzturamību