Asenna Workflows SDK
Tällä sivulla
Tekniset edellytykset
Ennen ensimmäisen työkalukoodirivin kirjoittamista tarvitset neljä asiaa. Ensinnäkin tarvitset Python-version 3.12 tai uudemman, koska työkalut nojaavat tässä versiossa esiteltyihin moderneihin async-ominaisuuksiin. Python 3.11 epäonnistuu tuontivaiheessa, ei ajon aikana, mikä tekee virheestä ainakin välittömän. Toiseksi tarvitset uv:n, paketinhallinnan, jonka Mistral suosittelee Python-projekteihin. Se hallitsee sekä virtuaaliympäristöjä että riippuvuuksia. Lopuksi tarvitset Mistral AI -tilin. Luo sellainen osoitteessa console.mistral.ai, jos sinulla ei vielä ole, ja luo API-avain konsolin API Keys -osiossa.
Tarkista Python-versiosi
Aloita yleisimmestä esteestä: tulkin versiosta.
python --version
# Näyttää Python 3.12.x tai uudempi
Jos versiosi on alempi kuin 3.12, päivitä Python ennen jatkamista. Ubuntulla/Debianilla:
sudo apt update
sudo apt install python3.12 python3.12-venv
macOS:lla Homebrew’n kanssa:
brew install [email protected]
Asenna uv
Jos sinulla ei vielä ole uv:tä, asenna se. Komento vaihtelee käyttöjärjestelmän mukaan:
# 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"
Varmista sen jälkeen, että binääri on PATH-polussasi. Jos seuraava komento palauttaa “not found”, avaa uusi pääteikkuna. Asennusohjelma muokkaa shell-profiiliasi:
uv --version
Luo projekti
Luo uusi Python-projekti uv:llä:
mkdir mon-workflow-mistral
cd mon-workflow-mistral
uv init
Tämä luo pyproject.toml-tiedoston ja standardin projektirakenteen. pyproject.toml-tiedosto luettelee riippuvuutesi ja antaa kollegan luoda täsmälleen saman ympäristön.
Asenna Workflows SDK
Sinulla on kaksi asennusvaihtoehtoa, ja valinnalla on väliä. Jos tarvitset vain työkalumoottoria – koska aktiviteettisi kutsuvat sisäisiä API-rajapintoja, tietokantaa tai kolmansien osapuolten palveluita – perusversio riittää:
uv add mistralai-workflows
Jos haluat käyttää kestäviä agentteja, työkalukutsuja ja moniagenttisia luovutuksia suoraan työkaluissasi, käytä versiota, jossa on lisäosat:
uv add "mistralai-workflows[mistralai]"
Toinen vaihtoehto asentaa Mistral AI SDK:n riippuvuutena ja mahdollistaa natiivit integraatiot Mistral-malleihin. Jos olet epävarma projektin alussa, perusversio on kevyempi. Voit lisätä lisäosan myöhemmin rikkomatta mitään.
Varmenna asennus
Onnistunut tuonti voittaa pitkän manuaalisen tarkistuksen:
uv run python -c "import mistralai.workflows; print('Workflows SDK installed successfully!')"
Sinun pitäisi nähdä:
Workflows SDK installed successfully!
Jos saat ModuleNotFoundError, älä asenna uudelleen heti. Tarkista ensin, että olet projektikansiossa, jossa ajoit uv add -komennon. uv run -komento ratkaisee virtuaaliympäristön nykyisestä hakemistosta.
Määritä API-avaimesi
SDK todentaa itsensä MISTRAL_API_KEY-ympäristömuuttujan kautta. Se lukee tämän automaattisesti; sinun ei tarvitse välittää sitä argumenttina. Aseta se päätteesi:
# Linux / macOS
export MISTRAL_API_KEY="votre_clé_api_ici"
# Tehdäksesi siitä pysyvän, lisää se tiedostoon ~/.bashrc tai ~/.zshrc
echo export MISTRAL_API_KEY=votre_clé_api_ici >> ~/.bashrc
Tämä menetelmä toimii paikallisessa kehityksessä. Tuotantoprojekteissa suosittelen .env-tiedostoa, joka ladataan python-dotenv:llä, tai käyttöönottoalustasi salaisuuksien hallintaa. .bashrc-tiedostoon tallennettu avain päätyy ennemmin tai myöhemmin varmuuskopioon tai ruudunjakoistuntoon.
Nopea runko (valinnainen)
Mistral tarjoaa CLI-työkalun, joka generoi完整的n työkaluprojektin. Tämä on hyödyllistä nähdäksesi odotetun rakenteen ennen oman kirjoittamista:
uvx mistralai-workflows-cli setup
Komento tuottaa esimerkkityökalutiedoston, aktiviteettitiedoston, valmiin workerin ja perusmääritykset. Muutamassa sekunnissa saat toimivan projektin. Voit sitten purkaa sen osiin ymmärtääksesi kunkin komponentin roolin ennen alusta aloittamista.
Suositeltu projektirakenne
Tuotantokäyttöön tarkoitetussa työkaluprojektissa suosittelemme tätä rakennetta:
mon-workflow-mistral/
├── pyproject.toml # Riippuvuudet (mistralai-workflows)
├── .env # API-avain (älä commitoi)
├── activities/
│ ├── __init__.py
│ ├── email.py # Sähköpostiin liittyvät aktiviteetit
│ └── data_processing.py # Datan käsittelyn aktiviteetit
├── workflows/
│ ├── __init__.py
│ └── pipeline.py # Työkalumääritykset
└── worker.py # Workerin sisäänmenopiste
Aktiviteettien erottaminen työkaluista helpottaa ylläpitoa ja yksikkötestausta. Aktiviteetti on tavallinen async-funktio, jonka voit kutsua suoraan testissä, kun taas työkalu vaatii moottorin suorittamiseen. Tämä erottelu vie viisi minuuttia projektin alussa ja säästää paljon aikaa, kun sinulla on yli kymmenen aktiviteettia.
Keskeiset asiat
- Python 3.12+ ja uv ovat pakollisia Workflows SDK:lle
- Kaksi asennustilaa: perus (
mistralai-workflows) tai tekoälyintegraatiolla (mistralai-workflows[mistralai]) - Määritä API-avain
MISTRAL_API_KEY-ympäristömuuttujan kautta uvx mistralai-workflows-cli setup-komento generoi完整的n esimerkkiprojektin- Erota aktiviteetit, työkalut ja worker erillisiin tiedostoihin paremman ylläpidettävyyden vuoksi