Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Įdiekite „Mistral“ Python SDK

Paskaita 4 iš 14 Atnaujinta 2026 m. lapkričio 2 d. Kūrėjas
Šiame puslapyje
  1. Būtinos sąlygos
  2. Prieš diegdami ką nors, izoliuokite savo projektą
  3. Įdiekite oficialųjį SDK
  4. Patikrinkite diegimą atlikdami tikrą API užklausą
  5. Padarykite aplinką atkuriamą
  6. Keturios dažnos klaidos ir kaip jas diagnozuoti
  7. Svarbiausi punktai

Būtinos sąlygos

Atnaujinta 2026 m. lapkričio 2 d. — „Mistral“ SDK 3. Šioje pamokoje anksčiau buvo nagrinėjama SDK 2 versija ir „Python“ 3.9. Dabartinė versija yra 3.7.0 (išleista 2026 m. lapkričio 1 d.); jai reikia „Python“ 3.10 arba naujesnės, o klientas importuojamas kaip from mistralai.client import Mistral nuo 2.0 versijos (2026 m. kovas). Šaltiniai: mistralai PyPI svetainėje · v2.0.0 išleidimo pastabos · v3.0.0 išleidimo pastabos.

Diegiant SDK reikia trijų dalykų: „Python“ 3.10 arba naujesnės, ką galite patikrinti komanda python --version; atnaujinto pip, gaunamo vykdant pip install --upgrade pip; ir jūsų Mistral API rakto, jau nustatyto kaip aplinkos kintamojo, kaip buvo aptarta ankstesnėje pamokoje. Jei „Python“ jūsų kompiuteryje dar neįdiegta, atsisiųskite naujausią stabilią versiją iš python.org arba naudokite savo sistemos paketų tvarkyklę.

Prieš diegdami ką nors, izoliuokite savo projektą

Visada dirbkite virtualioje aplinkoje. Šis įprotis apsaugo jus nuo dažnos problemos: du projektai tame pačiame kompiuteryje, vienam reikia specifinės SDK versijos, kitam – kitos, o viena pip install komanda tyčia sugadina pirmąjį projektą atnaujindama antrąjį. Virtuali aplinka kiekvienam projektui suteikia savo izoliuotas priklausomybes, atskirtas nuo sistemos lygio paketų.

# Sukurkite virtualią aplinką
python -m venv mistral-env

# Aktyvuokite Linux / macOS sistemose
source mistral-env/bin/activate

# Aktyvuokite Windows sistemose
mistral-env\Scripts\activate

Kai aplinka aktyvuota, jūsų terminalo eilutės pradžioje atsiras aplinkos pavadinimas skliaustuose: (mistral-env). Šis mažas žymeklis garantuoja, kad tolesnės komandos bus taikomos tinkamoje vietoje – jei jo nematote, nieko nediegkite.

Įdiekite oficialųjį SDK

„Mistral“ SDK įdiegimas reikalauja tik vienos komandos:

pip install mistralai

Tai įdiegia naujausią SDK versiją: 3.7.0 (2026 m. lapkričio 1 d. duomenimis). Trečioji karta prasidėjo nuo 3.0 versijos, išleistos 2026 m. rugsėjo 28 d. Norėdami įsitikinti, kad viskas yra savo vietose, paleiskite pip show mistralai, kad pamatytumėte paketo pavadinimą, versiją ir priklausomybes.

Kartais projektui reikia specifinės versijos, pavyzdžiui, siekiant suderinti visą komandą migracijos metu. Apribojimus galite nurodyti dviem lygmenimis:

# Likti 3-osios kartos ribose
pip install "mistralai>=3,<4"

# Įdiegti tikslią versiją
pip install "mistralai==3.7.0"

Proceso metu „pip“ atsisiunčia kelias priklausomybes, kurios atsiranda sąraše. Pravartu jas atpažinti, ypač httpx2 – HTTP klientą, tvarkantį tinklo užklausas (SDK nuo 3.0 versijos vietoj httpx naudoja būtent šį), ir pydantic, kuris tikrina ir serializuoja keičiamus duomenis. Jūs su jais tiesiogiai nesidirbsite, tačiau jų buvimas paaiškina, kodėl diegimas, atrodo, mažas, vis tiek užima kelis megabaitus.

Patikrinkite diegimą atlikdami tikrą API užklausą

pip show vykdymas įrodo tik tai, kad paketas egzistuoja, bet ne tai, kad jūsų konfigūracija veikia. Tikras testas – užklausa API. Sukurkite failą pavadinimu test_mistral.py:

import os
from mistralai.client import Mistral

api_key = os.environ.get("MISTRAL_API_KEY")

if not api_key:
    print("Error: MISTRAL_API_KEY environment variable is not set.")
else:
    client = Mistral(api_key=api_key)
    print("Mistral client initialized successfully!")

    # Išvardykite galimus modelius
    models = client.models.list()
    print(f"Available models: {len(models.data)}")
    for model in models.data[:5]:
        print(f"  - {model.id}")

Tada jį paleiskite:

python test_mistral.py

Šis scenarijus vienu metu patikrina du dalykus. api_key patikrinimas iškart atskiria trūkstamą aplinkos kintamąjį nuo tikros tinklo problemos – be jo galite dešimt minučių įtarti savo užkardą (firewall), kai terminalas tiesiog buvo atidarytas iš naujo be to kintamojo. Jei modelių sąrašas atsiranda, vadinasi, SDK įdiegtas teisingai, o jūsų raktas yra priimamas API.

Padarykite aplinką atkuriamą

Dirbant komandiniame projekte, diegimas turi būti atkuriamas. Užfiksuokite savo priklausomybes:

pip freeze > requirements.txt

Jūsų kolegos tada galės atkurti tikslią tokią pačią aplinką viena komanda:

pip install -r requirements.txt

Šį failą skaitys ir jūsų diegimo serveris. Įpraskite jį regeneruoti kiekvieną kartą, kai pridedate biblioteką; kitaip kodas veiks tik jūsų kompiuteryje ir niekur kitur.

Keturios dažnos klaidos ir kaip jas diagnozuoti

Klaida ModuleNotFoundError: No module named mistralai beveik visada reiškia, kad terminalas nenaudoja tinkamos virtualios aplinkos. Patikrinkite tai komanda which python, kuri turėtų rodyti jūsų venv kelią, ir tada pip list | grep mistralai.

Klaida ImportError: cannot import name 'Mistral' from 'mistralai' rodo, kad kodas parašytas SDK 1 versijai. Nuo 2.0 versijos visi importai vykdomi per mistralai.client: rašykite from mistralai.client import Mistral. Pamoka apie SDK versijas detaliau aprašo kitus pakeitimus.

SSL arba tinklo klaida dažnai atskleidžia įmonės proxy serverį, esantį tarp jūsų ir išorinio pasaulio. Aiškiai nurodykite jį „pip“:

pip install mistralai --proxy http://proxy.entreprise.com:8080

Galiausiai, jei diegimas atmeta jūsų „Python“ versiją, prisiminkite, kad SDK nuo 2.0 versijos reikalauja bent „Python“ 3.10. Atnaujinkite „Python“ arba įdiekite pyenv, kad galėtumėte lygiagrečiai naudoti kelias versijas neliesdami sistemos interpretatoriaus.

Svarbiausi punktai

  • Įdiekite SDK komanda pip install mistralai virtualioje aplinkoje
  • Dabartinė versija yra 3.7.0 (2026 m. lapkričio 1 d.); klientą importuokite kaip from mistralai.client import Mistral
  • Patikrinkite diegimą išvardydami galimus modelius
  • Užfiksuokite priklausomybes faile requirements.txt, kad užtikrintumėte atkuriamumą
  • Reikalinga „Python“ 3.10 arba naujesnė versija