Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Įdiekite „Workflows“ SDK

Paskaita 3 iš 14 Atnaujinta 2026 m. liepos 29 d. Pažengusiems
Šiame puslapyje
  1. Techniniai reikalavimai
  2. Patikrinkite savo Python versiją
  3. Įdiekite uv
  4. Sukurkite projektą
  5. Įdiekite „Workflows“ SDK
  6. Patikrinkite diegimą
  7. Sukonfigūruokite savo API raktą
  8. Greitas struktūros kūrimas (neprivaloma)
  9. Rekomenduojama projekto struktūra
  10. Svarbiausi punktai

Techniniai reikalavimai

Prieš rašydami pirmąją darbo eigos kodo eilutę, turite paruošti keturis dalykus. Pirma, jums reikia Python 3.12 arba naujesnės versijos, nes darbo eigos remiasi šioje versijoje įdiegtomis moderniomis asinchroninėmis funkcijomis. Python 3.11 versija nepavyks importavimo metu, o ne vykdymo metu, kas bent jau leidžia iškart pamatyti klaidą. Antra, jums reikia uv – paketų tvarkyklės, kurią „Mistral“ rekomenduoja Python projektams. Ji tvarko tiek virtualias aplinkas, tiek priklausomybes. Galiausiai jums reikia „Mistral AI“ paskyros. Jei jos dar neturite, susikurkite ją adresu console.mistral.ai ir konsolės skiltyje „API Keys“ sugeneruokite API raktą.

Patikrinkite savo Python versiją

Pradėkite nuo dažniausiai pasitaikančios kliūties – interpretatoriaus versijos.

python --version
# Turi rodyti Python 3.12.x arba naujesnę

Jei jūsų versija senesnė nei 3.12, prieš tęsdami atnaujinkite Python. „Ubuntu/Debian“ sistemose:

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

„macOS“ sistemose naudojant „Homebrew“:

brew install [email protected]

Įdiekite uv

Jei dar neturite uv, įdiekite jį. Komanda skiriasi priklausomai nuo sistemos:

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

Tada patikrinkite, ar vykdomasis failas yra jūsų PATH aplanke. Jei ši komanda grąžina „not found“, atidarykite naują terminalą. Diegyklė modifikuoja jūsų apvalkalo profilį:

uv --version

Sukurkite projektą

Sukurkite naują Python projektą naudodami uv:

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

Tai sukuria pyproject.toml failą ir standartinę projekto struktūrą. pyproject.toml faile išvardijamos jūsų priklausomybės ir leidžiama kolegai atkurti tikslią tokią pačią aplinką.

Įdiekite „Workflows“ SDK

Turite du diegimo būdus, ir pasirinkimas yra svarbus. Jei jums reikia tik darbo eigos variklio – nes jūsų veiklos kviečia vidinius API, duomenų bazes arba trečiųjų šalių tarnybas – pakanka bazinės versijos:

uv add mistralai-workflows

Jei norite savo darbo eigose naudoti patvarius agentus, įrankių kvietimus ir kelių agentų perdavimus tiesiogiai, naudokite variantą su papildiniais:

uv add "mistralai-workflows[mistralai]"

Antrasis variantas įdiegia „Mistral AI“ SDK kaip priklausomybę ir įgalina vietines integracijas su „Mistral“ modeliais. Jei projekto pradžioje nesate tikri, bazinė versija yra lengvesnė. Papildinį galite pridėti vėliau nieko nesugadinę.

Patikrinkite diegimą

Sėkmingas importavimas yra geriau nei ilgas rankinis tikrinimas:

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

Turėtumėte pamatyti:

Workflows SDK installed successfully!

Jei gaunate ModuleNotFoundError, nediegkite iš naujo iškart. Pirmiausia patikrinkite, ar esate projekto aplanke, kuriame vykdėte uv add. Komanda uv run išsprendžia virtualią aplinką iš dabartinio katalogo.

Sukonfigūruokite savo API raktą

SDK autentifikuoja naudodamas MISTRAL_API_KEY aplinkos kintamąjį. Jis jį nuskaitys automatiškai; jums nereikia jo perduoti kaip argumento. Nustatykite jį savo terminale:

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

# Kad būtų nuolatinis, pridėkite jį į savo ~/.bashrc arba ~/.zshrc
echo export MISTRAL_API_KEY=votre_clé_api_ici >> ~/.bashrc

Šis metodas tinka vietinei plėtrai. Gamybiniams projektams geriau naudoti .env failą, įkeliamą per python-dotenv, arba jūsų diegimo platformos paslapčių tvarkyklę. Raktas .bashrc faile anksčiau ar vėliau atsidurs atsarginėje kopijoje arba ekrano kopijoje.

Greitas struktūros kūrimas (neprivaloma)

„Mistral“ pateikia CLI įrankį, kuris sugeneruoja visą darbo eigos projektą. Tai naudinga norint pamatyti numatomą struktūrą prieš rašant savo kodą:

uvx mistralai-workflows-cli setup

Komanda sukuria pavyzdinį darbo eigos failą, veiklos failą, paruoštą paleisti darbuotoją ir pagrindinę konfigūraciją. Per kelias sekundes gaunate veikiantį projektą. Tada galite jį išardyti dalimis, kad suprastumėte kiekvieno komponento vaidmenį prieš pradėdami nuo nulio.

Rekomenduojama projekto struktūra

Gamybiniam darbo eigos projektui rekomenduojame šią struktūrą:

mon-workflow-mistral/
├── pyproject.toml          # Priklausomybės (mistralai-workflows)
├── .env                    # API raktas (neįtraukti į versijų kontrolę)
├── activities/
│   ├── __init__.py
│   ├── email.py            # Su el. paštu susijusios veiklos
│   └── data_processing.py  # Duomenų apdorojimo veiklos
├── workflows/
│   ├── __init__.py
│   └── pipeline.py         # Darbo eigos apibrėžimai
└── worker.py               # Darbuotojo įvesties taškas

Veiklų atskyrimas nuo darbo eigų palengvina priežiūrą ir vienetinį testavimą. Veikla yra standartinė asinchroninė funkcija, kurią galite tiesiogiai iškviesti teste, tuo tarpu darbo eigai vykdyti reikia variklio. Šis atskyrimas projekto pradžioje trunka penkias minutes, tačiau sutaupo daug laiko, kai turite daugiau nei dešimt veiklų.

Svarbiausi punktai

  • „Workflows“ SDK reikia Python 3.12+ ir uv
  • Du diegimo režimai: bazinis (mistralai-workflows) arba su DI integracija (mistralai-workflows[mistralai])
  • API raktą konfigūruokite naudodami MISTRAL_API_KEY aplinkos kintamąjį
  • Komanda uvx mistralai-workflows-cli setup sugeneruoja visą pavyzdinį projektą
  • Atskirkite savo veiklas, darbo eigas ir darbuotoją į atskirus failus, kad būtų lengviau prižiūrėti