Namestitev SDK za delovne tokove
Na tej strani
Tehnične predpostavke
Preden napišeš prvo vrstico kode za delovni tok, moraš imeti pripravljene štiri stvari. Prvič, potrebuješ Python 3.12 ali novejši, saj delovni tokovi temeljijo na sodobnih asinhronih funkcijah, uvedenih v tej različici. Python 3.11 bo odpovedal že ob uvozu, ne ob izvajanju, kar vsaj pomeni, da bo napaka takoj očitna. Drugič, potrebuješ uv, upravitelja paketov, ki ga Mistral priporoča za projekte v Pythonu. Upravlja tako virtualna okolja kot odvisnosti. Nazadnje, potrebuješ račun Mistral AI. Ustvari ga na console.mistral.ai, če ga še nimaš, in v razdelku API Keys konzole ustvari ključ API.
Preveri različico Pythona
Začni z najpogostejšo oviro: različico interpreterja.
python --version
# Mora prikazati Python 3.12.x ali novejši
Če je tvoja različica nižja od 3.12, posodobi Python, preden nadaljuješ. Na Ubuntu/Debian:
sudo apt update
sudo apt install python3.12 python3.12-venv
Na macOS z Homebrew:
brew install [email protected]
Namesti uv
Če še nimaš uv, ga namesti. Ukaz se razlikuje glede na sistem:
# 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"
Nato preveri, ali je binarna datoteka v tvoji poti PATH. Če naslednji ukaz vrne „not found”, odpri nov terminal. Namestitveni program spremeni profil tvoje lupine:
uv --version
Ustvari projekt
Ustvari nov projekt v Pythonu z uv:
mkdir mon-workflow-mistral
cd mon-workflow-mistral
uv init
To ustvari datoteko pyproject.toml in standardno strukturo projekta. Datoteka pyproject.toml navaja tvoje odvisnosti in omogoča kolegu, da ustvari popolnoma enako okolje.
Namesti SDK za delovne tokove
Imaš dve možnosti namestitve in izbira je pomembna. Če potrebuješ le pogon za delovne tokove – ker tvoje aktivnosti kličejo interne API-je, bazo podatkov ali storitve tretjih strani – zadostuje osnovna različica:
uv add mistralai-workflows
Če želiš v svojih delovnih tokovih neposredno uporabljati trajne agente, klicanje orodij in predaje med več agenti, uporabi različico z dodatki:
uv add "mistralai-workflows[mistralai]"
Druga možnost namesti SDK Mistral AI kot odvisnost in omogoča izvorne integracije z modeli Mistral. Če si na začetku projekta negotov, je osnovna različica lažja. Dodatek lahko kasneje dodaš, ne da bi kaj pokvaril.
Preveri namestitev
Uspešen uvoz je boljši od dolgega ročnega preverjanja:
uv run python -c "import mistralai.workflows; print('Workflows SDK installed successfully!')"
Videti bi moral:
Workflows SDK installed successfully!
Če dobiš ModuleNotFoundError, ne nameščaj takoj znova. Najprej preveri, ali si v mapi projekta, kjer si zagnal uv add. Ukaz uv run razreši virtualno okolje iz trenutnega imenika.
Konfiguriraj svoj ključ API
SDK se avtentificira prek spremenljivke okolja MISTRAL_API_KEY. To prebere samodejno; ni treba, da jo podaš kot argument. Nastavi jo v svojem terminalu:
# Linux / macOS
export MISTRAL_API_KEY="votre_clé_api_ici"
# Da bo trajno, jo dodaj v ~/.bashrc ali ~/.zshrc
echo export MISTRAL_API_KEY=votre_clé_api_ici >> ~/.bashrc
Ta metoda deluje za lokalni razvoj. Za produkcijske projekte raje uporabi datoteko .env, ki jo naložiš prek python-dotenv, ali upravitelja skrivnosti svoje platforme za uvajanje. Ključ v datoteki .bashrc se bo sčasoma znašel v varnostni kopiji ali na posnetku zaslona med souporabo.
Hitra ogrodja (izbirno)
Mistral ponuja orodje CLI, ki ustvari celoten projekt delovnega toka. To je koristno, da vidiš pričakovano strukturo, preden napišeš svojo:
uvx mistralai-workflows-cli setup
Ukaz ustvari vzorčno datoteko delovnega toka, datoteko z aktivnostmi, delavca, pripravljenega za zagon, in osnovno konfiguracijo. V nekaj sekundah dobiš delujoč projekt. Nato ga lahko kos za kosom razstaviš, da razumeš vlogo vsake komponente, preden začneš znova.
Priporočena struktura projekta
Za produkcijski projekt delovnega toka priporočamo to strukturo:
mon-workflow-mistral/
├── pyproject.toml # Odvisnosti (mistralai-workflows)
├── .env # Ključ API (ne commitaj)
├── activities/
│ ├── __init__.py
│ ├── email.py # Aktivnosti, povezane z e-pošto
│ └── data_processing.py # Aktivnosti obdelave podatkov
├── workflows/
│ ├── __init__.py
│ └── pipeline.py # Definicije delovnih tokov
└── worker.py # Vstopna točka delavca
Ločevanje aktivnosti od delovnih tokov olajša vzdrževanje in enotsko testiranje. Aktivnost je standardna asinhrona funkcija, ki jo lahko neposredno pokličeš v testu, medtem ko delovni tok za zagon potrebuje pogon. Ta ločitev na začetku projekta vzame pet minut, prihrani pa ti veliko časa, ko imaš več kot deset aktivnosti.
Ključne ugotovitve
- Za SDK za delovne tokove sta obvezna Python 3.12+ in uv
- Dva načina namestitve: osnovni (
mistralai-workflows) ali z integracijo AI (mistralai-workflows[mistralai]) - Ključ API konfiguriraj prek spremenljivke okolja
MISTRAL_API_KEY - Ukaz
uvx mistralai-workflows-cli setupustvari celoten vzorčni projekt - Za boljšo vzdrževnost loči svoje aktivnosti, delovne tokove in delavca v ločene datoteke