Suiteáil an Mistral Python SDK
Ar an leathanach seo
Réamhriachtanais
Nuashonraithe an 2 Samhain, 2026 — Mistral SDK 3. Chumhdaigh an ceacht seo leagan 2 den SDK agus Python 3.9 roimhe seo. Is é 3.7.0 an leagan reatha (a eisíodh an 1 Samhain, 2026); éilíonn sé Python 3.10 nó níos airde, agus allmhairítear an cliant trí
from mistralai.client import Mistraló leagan 2.0 (Márta 2026) i leith. Foinse: mistralai ar PyPI · Nótaí eisiúna v2.0.0 · Nótaí eisiúna v3.0.0.
Teastaíonn trí rud chun an SDK a shuiteáil: Python 3.10 nó níos airde, is féidir leat é a fhíorú le python --version; pip atá cothrom le dáta, faightear é trí pip install --upgrade pip; agus do eochair API Mistral socraithe cheana féin mar athróg timpeallachta, mar a pléadh sa cheacht roimhe seo. Mura bhfuil Python suiteáilte ar do mheaisín fós, faigh an t-eisiúint chobhsaí is déanaí ó python.org nó bain úsáid as bainisteoir pacáistí do chórais.
Do thionscadal a leithlisiú sula suiteálann tú aon rud
Oibrigh i gcónaí laistigh de timpeallacht fhíorúil. Sábhálfaidh an nós seo ceannphian choitianta ort: dhá thionscadal ar an meaisín céanna, ceann amháin ag teastáil leagan sonrach den SDK agus ceann eile ag teastáil leagan difriúil, áit a mbriseann pip install amháin an chéad tionscadal go ciúin trí dhara ceann a nuashonrú. Tugann timpeallacht fhíorúil a spleáchais féin leithlisithe do gach tionscadal, ar leithligh ó do phacáistí ar fud an chórais.
# Cruthaigh an timpeallacht fhíorúil
python -m venv mistral-env
# Gníomhachtaigh ar Linux / macOS
source mistral-env/bin/activate
# Gníomhachtaigh ar Windows
mistral-env\Scripts\activate
Nuair a bheidh sé gníomhachtaithe, beidh réimíg do theirminéil réamhcheangailte le hainm na timpeallachta idir lúibíní: (mistral-env). Ráthaíonn an marcóir beag seo go mbaineann orduithe ina dhiaidh sin leis an suíomh ceart—mura dtagann sé le feiceáil, ná suiteáil aon rud.
Suiteáil an SDK oifigiúil
Ní theastaíonn ach ordú amháin chun an Mistral SDK a shuiteáil:
pip install mistralai
Suiteálann sé seo an leagan is déanaí den SDK: 3.7.0 ón 1 Samhain, 2026. Thosaigh Glúin 3 le leagan 3.0, a eisíodh an 28 Meán Fómhair, 2026. Chun a dheimhniú go bhfuil gach rud ina áit, rith pip show mistralai chun ainm an phacáiste, an leagan, agus na spleáchais a thaispeáint.
Uaireanta, éilíonn tionscadal leagan sonrach, mar shampla, chun foireann iomlán a choinneáil ar an mbóthar ceart le linn imirce. Is féidir leat srianta a shonrú ar dhá leibhéal:
# Fan laistigh de ghlúin 3
pip install "mistralai>=3,<4"
# Suiteáil leagan cruinn
pip install "mistralai==3.7.0"
Ar an mbealach, tarraingíonn pip isteach roinnt spleáchais a fheictear sa liosta. Cabhraíonn sé iad a aithint, go háirithe httpx2, an cliant HTTP a láimhseálann glaonna líonra (úsáideann an SDK é seo in ionad httpx ó leagan 3.0 i leith), agus pydantic, a dhéanann bailíochtú agus sraitheáil ar na sonraí a mhalartaítear. Ní dhéanfaidh tú idirghníomhú leo seo go díreach, ach míníonn a láithreacht cén fáth a n-áitíonn suiteáil a bhfuil cuma bheag uirthi cúpla meigibheart fós.
Fíoraigh an tsuiteáil le glaonna API fíor
Cruthaíonn pip show go bhfuil an pacáiste ann, ní go n-oibríonn do chumraíocht. Is é an fíor-thástáil ná ceist a chur ar an API. Cruthaigh comhad darbh ainm 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!")
# Liostaigh na samhlacha atá ar fáil
models = client.models.list()
print(f"Available models: {len(models.data)}")
for model in models.data[:5]:
print(f" - {model.id}")
Ansin rith é:
python test_mistral.py
Seiceálann an script seo dhá rud ag an am céanna. Déanann an seiceáil ar api_key idirdhealú láithreach idir athróg timpeallachta atá in easnamh agus fadhb líonra fíor—gan é, d’fhéadfadh tú deich nóiméad a chaitheamh ag amhras faoi do bhalla tine nuair nach raibh sa teirminéal ach oscailte arís gan an athróg. Má thaispeántar liosta na samhlacha, tá an SDK suiteáilte i gceart agus glacadh le d’eochair ag an API.
Déan an timpeallacht in-atáirgthe
Ar thionscadal foirne, caithfidh an tsuiteáil a bheith in-atáirgthe. Reoigh do chuid spleáchais:
pip freeze > requirements.txt
Is féidir le do chomhghleacaithe ansin an timpeallacht chruinn chéanna a athchruthú le hordú amháin:
pip install -r requirements.txt
Léifidh do fhreastalaí imlonnaithe an comhad seo freisin. Bíodh an nós agat é a athghiniúint gach uair a chuireann tú leabharlann leis; murach sin, oibreoidh an cód ar do mheaisín féin agus ar áit ar bith eile.
Ceithre theip choitianta agus conas iad a dhiagnóisiú
Ciallaíonn an earráid ModuleNotFoundError: No module named mistralai beagnach i gcónaí nach bhfuil an teirminéal ag úsáid na timpeallachta fíorúla cearta. Fíoraigh é seo le which python, ar chóir dó pointeáil chuig do venv, agus ansin le pip list | grep mistralai.
Léiríonn an earráid ImportError: cannot import name 'Mistral' from 'mistralai' cód a scríobhadh do leagan 1 den SDK. Ó leagan 2.0 i leith, téann gach allmhairiú trí mistralai.client: scríobh from mistralai.client import Mistral. Mionsonraíonn an ceacht ar leaganacha SDK athruithe eile.
Nochtann earráid SSL nó líonra go minic seachfhreastalaí corparáideach atá suite idir tú agus an saol lasmuigh. Inis do pip go sonrach faoi:
pip install mistralai --proxy http://proxy.entreprise.com:8080
Ar deireadh, má dhiúltaíonn an tsuiteáil do leagan Python, cuimhnigh go n-éilíonn an SDK Python 3.10 ar a laghad ó leagan 2.0. Nuashonraigh Python, nó suiteáil pyenv chun leaganacha iolracha a rith taobh le taobh gan an t-aisteoir córais a shárú.
Príomhphointí
- Suiteáil an SDK le
pip install mistralailaistigh de thimpeallacht fhíorúil - Is é 3.7.0 an leagan reatha (1 Samhain, 2026); allmhairigh an cliant trí
from mistralai.client import Mistral - Fíoraigh an tsuiteáil trí na samhlacha atá ar fáil a liostú
- Reoigh spleáchais i
requirements.txtle haghaidh in-atáirgtheachta - Éilítear Python 3.10 nó níos airde