Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Aistriú idir Leaganacha SDK Mistral

Ceacht 10 as 14 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Cén fáth a bhfuil tábhacht ag baint leis an gceacht seo
  2. Ceithre ghlúin in dhá bhliain
  3. Ó 0.x go 1.x: an cliant Mistral agus modhanna slabhráilte
  4. Ó 1.x go 2.x: bogann gach rud faoi mistralai.client
  5. Ó 2.x go 3.x: httpx2 agus uirlisí ionsuite
  6. Cad faoi TypeScript?
  7. An t-aistriú a dhéanamh
  8. Mura féidir leat aistriú láithreach
  9. Príomhphointí

An ceacht athscríofa an 2 Samhain, 2026. Thagraigh an leagan roimhe seo do “bhogadh ó V1 go V2”, rud a bhí i ndáiríre an t-aistriú ón gcliant seanbhunaithe 0.x go dtí leagan 1.0 i mí Lúnasa 2024. Ó shin i leith, tá dhá scaoileadh mór eile tagtha ar an SDK Python: 2.0 i mí an Mhárta 2026 agus 3.0 i mí Mheán Fómhair 2026. Atógann an ceacht seo an stair iomlán bunaithe ar threoracha oifigiúla aistrithe agus nótaí scaoilte. Nuashonraithe an 3 Samhain, 2026: Deisíodh an lúb sruthaithe TypeScript, a rith string | ContentChunk[] ábhar go díreach chuig process.stdout.write roimhe seo, rud a d’fhág go raibh teip ann i mód dian.

Cén fáth a bhfuil tábhacht ag baint leis an gceacht seo

Tiocfaidh tú ar an ábhar seo i dhá chás: tá tú ag tosú ar thionscadal arís a scríobhadh tamall ó shin agus a dhiúltaíonn tosú tar éis nuashonraithe spleáchais, nó tá tú ag leanúint rang teagaisc ar líne nach n-oibríonn a shamplaí a thuilleadh. Sa dá chás, cuir an chéad cheist chéanna: cén ghlúin SDK ar scríobhadh an cód seo di? Beagnach i gcónaí, insíonn líne amháin duit é: an ráiteas allmhairithe.

Ceithre ghlúin in dhá bhliain

GlúinPython (mistralai)TypeScript (@mistralai/mistralai)Gné chód idirdhealaitheach
0.xsuas go 0.4.2 (Iúil 2024)suas go 0.5.0 (Meitheamh 2024)MistralClient, modhanna cothroma: client.chat(...)
1.x1.0.0 (7 Lúnasa, 2024) → 1.9.11 (Deireadh Fómhair 2025)ó Lúnasa 2024from mistralai import Mistral, modhanna slabhráilte: client.chat.complete(...)
2.x2.0.0 (10 Márta, 2026)2.0.0 (18 Márta, 2026)Python: from mistralai.client import Mistral; TypeScript: modúil ES amháin
3.x3.0.0 (28 Meán Fómhair, 2026), 3.7.0 ón 1 Samhain, 20263.0 (Deireadh Fómhair 2026), 3.5.0 inniuPython: cliant HTTP httpx2

I dTypeScript, níor athraigh an t-allmhairiú import { Mistral } from '@mistralai/mistralai' ó 1.x i leith. I bPython, d’athraigh sé faoi dhó: sin áit a dtarlaíonn an chuid is mó de na bristeacha.

Ó 0.x go 1.x: an cliant Mistral agus modhanna slabhráilte

Chuir leagan 1.0 an dá chlient, MistralClient (sioncronach) agus MistralAsyncClient (asioncronach), in ionad aon aicme amháin, Mistral. Chuir sé modhanna cothroma in ionad ainmneacha spásanna freisin: grúpálann chat oibríochtaí comhrá, agus téann tú leibhéal níos doimhne chun complete() a bhaint amach. Teachtaireachtaí, a scríobhadh roimhe seo ag baint úsáide as an aicme ChatMessage, scríobhtar mar fhocláir anois nó ag baint úsáide as na haicmí UserMessage, SystemMessage, AssistantMessage, agus ToolMessage.

# 0.x (seanbhunaithe)
from mistralai.client import MistralClient
from mistralai.models.chat_completion import ChatMessage

client = MistralClient(api_key="...")
response = client.chat(
    model="mistral-small-latest",
    messages=[ChatMessage(role="user", content="Hello")],
)

# 1.x
from mistralai import Mistral

client = Mistral(api_key="...")
response = client.chat.complete(
    model="mistral-small-latest",
    messages=[{"role": "user", "content": "Hello"}],
)

Leanann sruthú an loighic chéanna, le gaiste a chosnaíonn leathuair an chloig de dhibhugadh go minic: tá an blúire faighte fillte anois, agus léitear a ábhar trí leibhéal idirmheánach .data. Ardaíonn cód seanbhunaithe 0.x a chóipeáil mar atá sé AttributeError ar an gcéad bhlúire.

# 0.x
for chunk in client.chat_stream(model=..., messages=...):
    print(chunk.choices[0].delta.content)

# 1.x agus ina dhiaidh sin
for chunk in client.chat.stream(model=..., messages=...):
    print(chunk.data.choices[0].delta.content)

Soláthraíonn an treoir oifigiúil 1.0 an tábla iomlán. Seo iad na mapálacha is minice:

0.x1.x agus ina dhiaidh sin
client.chat / client.chat_streamclient.chat.complete / client.chat.stream
client.completions (FIM)client.fim.complete
client.embeddings(model=..., input=[...])client.embeddings.create(model=..., inputs=[...])
client.list_models()client.models.list()
client.files.create(...)client.files.upload(...)
client.jobs.create(...)client.fine_tuning.jobs.create(...)
MistralAsyncClient agus a mhodhannaLeaganacha _async: client.chat.complete_async, client.chat.stream_async…

Ó 1.x go 2.x: bogann gach rud faoi mistralai.client

Níor bhrain leagan 2.0 ar ainmneacha modhanna: fanann client.chat.complete mar client.chat.complete. D’athraigh sé seoladh gach rud eile. Tháinig an SDK chun bheith ina phacáiste ainmneacha spásanna (PEP 420), agus d’aistrigh gach allmhairiú ó mistralai go mistralai.client:

# 1.x
from mistralai import Mistral
from mistralai.models import UserMessage, SDKError

# 2.x agus ina dhiaidh sin
from mistralai.client import Mistral
from mistralai.client.models import UserMessage
from mistralai.client.errors import SDKError

Tabhair faoi deara an tríú líne: ní mhaireann aicmí earráide i measc samhlacha a thuilleadh ach in mistralai.client.errors, le MistralError mar bhonn coiteann (a n-oibríonn SDKError agus HTTPValidationError faoi).

Tháinig cliaint soláthraithe scamaill isteach san ainmneach spásanna céanna. I 1.x, seachadadh iad leis an bpacáiste mistralai ach i modúil ar leith, mistralai_azure agus mistralai_gcp:

# 1.x
from mistralai_azure import MistralAzure
client = MistralAzure(azure_endpoint="https://your-endpoint.inference.ai.azure.com", azure_api_key="your-azure-key")

from mistralai_gcp import MistralGoogleCloud
client = MistralGoogleCloud(region="europe-west4", project_id="my-project")

# 2.x agus ina dhiaidh sin
from mistralai.azure.client import MistralAzure
client = MistralAzure(server_url="https://your-endpoint.inference.ai.azure.com", api_key="your-azure-key")

from mistralai.gcp.client import MistralGCP  # pip install "mistralai[gcp]"
client = MistralGCP(region="europe-west4", project_id="my-project")

D’fhéadfadh trí athrú eile i 2.0 difear a dhéanamh duitse. Is é Python 3.10 an leagan íosta anois (ghlac 1.9.11 le Python 3.9). Athainmníodh 42 chineál de réir coinbhinsiún rialta: {Verb}{Entity}Request d’iarratais agus {Verb}{Entity}Response do fhreagairtí. Is é an t-athainmniú amháin atá le feiceáil i gcód coiteann ná Tools, a d’éirigh ConversationRequestTool. Ar deireadh, glacann áireamh leis luachanna anaithnide anois, mar sin ní dhéanann luach nua a chuireann an API leis leagan níos sine den SDK a bhriseadh.

Ó 2.x go 3.x: httpx2 agus uirlisí ionsuite

Ní athraíonn leagan 3.0, a scaoileadh an 28 Meán Fómhair, 2026, allmhairithe ná modhanna coiteanna. Mar sin féin, is féidir le trí phointe tionscadal a bhriseadh:

  • Éiríonn an cliant HTTP ina httpx2. Má chuireann tú do chlient féin ar fáil don SDK (paraiméadair client= nó async_client=, mar shampla do sheachfhreastalaí nó ceanntáisc choiteanna), caithfidh sé a bheith ina chlient httpx2; tá iarratais iompair amh, freagairtí, agus earráidí ina gcineálacha httpx2 freisin.
  • Fágann uirlisí ionsuite críochnuithe comhrá. Ní ghlacann client.chat.complete agus client.agents.complete leis na huirlisí web_search, web_search_premium, agus code_interpreter a thuilleadh: úsáidtear iad tríd an API Comhráite (client.beta.conversations) nó gníomhaire. Míníonn doiciméadú Mistral cén fáth: ní féidir le freagairtí críochnaithe comhrá na tagairtí a thugann na huirlisí seo a iompar.
  • Braitheann na breiseáin mcp agus agents anois ar MCP 2.2.

Cuireann leagan 3.0 fíordheimhniú token cuntas seirbhíse leis freisin: léann Mistral() an token ón gcomhad a shonraítear leis an athróg timpeallachta MISTRAL_SA_TOKEN_PATH.

Cad faoi TypeScript?

Is cosúil go beacht an t-aistriú ón gcliant seanbhunaithe JavaScript 0.x go dtí an SDK TypeScript 1.x leis an aistriú Python. Athraíonn an t-allmhairiú ó easpórtáil réamhshocraithe go heaspórtáil ainmnithe, glacann an tógálaí le réad cumraíochta, agus éiríonn na modhanna slabhráilte:

// 0.x (seanbhunaithe)
import MistralClient from '@mistralai/mistralai';
const client = new MistralClient(process.env.MISTRAL_API_KEY);
const response = await client.chat({
  model: 'mistral-small-latest',
  messages: [{ role: 'user', content: 'Hello' }],
});

// 1.x agus ina dhiaidh sin
import { Mistral } from '@mistralai/mistralai';
const client = new Mistral({ apiKey: process.env.MISTRAL_API_KEY });
const response = await client.chat.complete({
  model: 'mistral-small-latest',
  messages: [{ role: 'user', content: 'Hello' }],
});

Bogann sruthú ó client.chatStream(...) go client.chat.stream(...), agus, mar i bPython, léitear ábhar trí chunk.data:

const stream = await client.chat.stream({
  model: 'mistral-small-latest',
  messages: [{ role: 'user', content: 'Hello' }],
});

for await (const chunk of stream) {
  const content = chunk.data.choices[0]?.delta.content;
  // is féidir leis an ábhar a bheith ina liosta blúirí freisin: ní scríobhaimid ach téacs
  if (typeof content === 'string') process.stdout.write(content);
}

Choinnigh TypeScript 2.0 (18 Márta, 2026) na hallmhairithe seo, ach foilsítear an SDK anois mar mhodúil ES amháin: ní oibríonn require('@mistralai/mistralai') i gCommonJS a thuilleadh. Bogann bailíochtú rúnaime go Zod v4, rud a mbíonn tionchar aige ar thionscadail a allmhairíonn scéimí go díreach ón SDK. Agus maireann cliaint scamaill i bpacáistí ar leith: @mistralai/mistralai-azure (MistralAzure) agus @mistralai/mistralai-gcp (MistralGCP, MistralGoogleCloud roimhe seo).

An t-aistriú a dhéanamh

Ar thionscadal fíor, téigh ar aghaidh in ord sainithe seachas earráidí a dheisiú de réir mar a thagann siad chun cinn. Tosaigh trí shainaithint ghiniúint an chóid trína allmhairithe, ansin nuashonraigh an pacáiste (pip install --upgrade mistralai nó npm install @mistralai/mistralai@latest): fad is atá an seanleagan suiteáilte, tá tú ag deisiú go dall. Ansin téigh ar aghaidh mar a leanas:

  1. Cuardaigh sean-allmhairithe: MistralClient, from mistralai import, from mistralai.models import, mistralai_azure, mistralai_gcp, require('@mistralai/mistralai')
  2. Cuir in ionad iad de réir na mapálacha sa cheacht seo, ná déan dearmad d’earráidí, a bhogann go mistralai.client.errors
  3. Nuashonraigh glaonna: modhanna slabhráilte, inputs iolra d’leabaithe, .data i lúba sruthaithe
  4. Bog uirlisí ionsuite (web_search, code_interpreter) ó chríochnuithe comhrá go dtí an API Comhráite

Ar deireadh, déan tástáil ar gach críochphointe a úsáideann tú, ceann ar cheann: tá athruithe dá gcuid féin ag comhrá, leabaithe, agus sruthú, agus ní ghlaoíonn tionscadal a thosaíonn ar an trí cinn go ceart konas bealach ar bith.

Mura féidir leat aistriú láithreach

Ní thairgeann aon cheann de na leaganacha seo mód aistrithe ná ailiasanna comhoiriúnachta. Má chuireann reo táirgeachta cosc ort aistriú, pin an leagan go sainráite i do spleáchais; murach sin, faighidh an chéad shuiteáil eile an leagan is déanaí agus brisfidh sé an feidhmchlár:

# Python: fan ar 1.x
pip install "mistralai<2"

# Python: fan ar 2.x
pip install "mistralai>=2,<3"

# npm: fan ar 1.x
npm install @mistralai/mistralai@1

Déileáil leis an bpinning seo mar mhaolú: ní thagann gnéithe nua ach sa leagan reatha.

Foinsí oifigiúla: Treoir aistrithe 0.x → 1.0 · Nótaí scaoilte Python 2.0.0 · Nótaí scaoilte Python 3.0.0 · Nótaí scaoilte TypeScript 2.0.0 · Stair leaganacha ar PyPI · Websearch — uirlisí ionsuite

Príomhphointí

  • Sainaithin giniúint cóide trína allmhairiú: MistralClient (0.x), from mistralai import Mistral (1.x), from mistralai.client import Mistral (2.x agus 3.x)
  • Thug 1.0 (Lúnasa 2024) isteach an cliant Mistral, modhanna slabhráilte, agus an leibhéal .data sruthaithe
  • Bhog 2.0 (Márta 2026) gach allmhairiú Python faoi mistralai.client, earráidí faoi mistralai.client.errors, agus ardaigh sé an t-íosleibhéal go Python 3.10
  • Aistríonn 3.0 (Meán Fómhair 2026) go httpx2 agus coimeádann sé web_search agus code_interpreter don API Comhráite agus do ghníomhairí
  • I dTypeScript, níor athraigh an t-allmhairiú ó 1.x i leith, ach ní ghlacann 2.0 ach le modúil ES