Installi Workflows SDK
Sellel lehel
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_KEYkaudu - Käsk
uvx mistralai-workflows-cli setupgenereerib täieliku näidisprojekti - Eralda oma tegevused, töövood ja töötaja erinevatesse failidesse parema hooldatavuse huvides