Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Asenna Workflows SDK

Oppitunti 3 / 14 Päivitetty 29. heinäkuuta 2026 Edistynyt
Tällä sivulla
  1. Tekniset edellytykset
  2. Tarkista Python-versiosi
  3. Asenna uv
  4. Luo projekti
  5. Asenna Workflows SDK
  6. Varmenna asennus
  7. Määritä API-avaimesi
  8. Nopea runko (valinnainen)
  9. Suositeltu projektirakenne
  10. Keskeiset asiat

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