Įdiekite „Workflows“ SDK
Šiame puslapyje
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_KEYaplinkos kintamąjį - Komanda
uvx mistralai-workflows-cli setupsugeneruoja visą pavyzdinį projektą - Atskirkite savo veiklas, darbo eigas ir darbuotoją į atskirus failus, kad būtų lengviau prižiūrėti