Mistral fuq Azure AI
F'din il-paġna
Aġġornat fit-3 ta’ Novembru, 2026: L-eżempju TypeScript kien jgħaddi
process.env.AZUREAI_API_KEYuprocess.env.AZUREAI_ENDPOINTdirettament lilMistralAzure. Peress li ż-żewġ għażliet huma meħtieġa, TypeScript 7 f’mod strett irrifjuta li jikkompila (verifikat ma’@mistralai/mistralai-azure2.1.0). Il-varjabbli tal-ambjent issa jiġu vvalidati qabel ma tinbena l-klijent. Sors: SDK@mistralai/mistralai-azure.
Għaliex tuża Mistral permezz ta’ Azure?
Din il-mistoqsija rari tqum għal raġunijiet tekniċi: l-API diretta ta’ Mistral taħdem perfettament. Tinqala’ għal raġunijiet kuntrattwali u organizzattivi. Kumpanija diġà integrata fl-ekosistema ta’ Microsoft tikkonsma impenn negozjat ta’ Azure, għandha proċessi ta’ akkwist stabbiliti, u m’għandha l-ebda xewqa li tiftaħ kuntratt ġdid ma’ fornitur għal ftit eluf ta’ ewro ta’ tokens.
L-użu ta’ Azure AI jikkonsolida l-fatturazzjoni fuq il-kuntratt eżistenti ta’ Azure tiegħek, jiżgura l-konformità mal-GDPR permezz ta’ reġjuni Ewropej, jipprovdi integrazzjoni nativa ma’ servizzi oħra ta’ Azure—Azure Functions, Cosmos DB, Azure ML—u joffri appoġġ intrapriżali ta’ Microsoft bi ftehimiet ta’ livell ta’ servizz korrispondenti. Fi kliem ieħor: l-istess mudell, fi ħdan il-perimetru ta’ governanza li d-dipartiment IT tiegħek diġà approva.
L-għażla bejn serverless u GPU dedikat
Azure joffri żewġ approċċi, u l-għażla tiddependi mir-regolarità tal-piż tax-xogħol tiegħek. Il-modalità pay-as-you-go, magħrufa wkoll bħala MaaS (Model as a Service), tesponi API serverless: l-ebda GPU x’tipprovdi, tħallas biss għat-tokens ikkunsmati, u Azure jittratta l-iskalar waħdu. Din hija l-modalità rrakkomandata għall-biċċa l-kbira tal-każijiet ta’ użu, speċjalment waqt li t-traffiku tiegħek ikun irregolari jew imprevedibbli.
L-endpoints f’ħin reali jindirizzaw il-ħtieġa opposta. Inti tagħżel it-tip u n-numru ta’ GPU, l-infrastruttura hija dedikata għalik, u l-fatturazzjoni sseħħ għal kull siegħa ta’ komputazzjoni—kemm jekk il-mudell ikun qed jaħdem jew ikun idle. API interna milquta kontinwament minn diversi eluf ta’ utenti taqbel ma’ dan il-mudell; prototip aċċessat tliet darbiet kuljum iħela ħafna flus hawnhekk. Ftakar ir-regola: din il-modalità hija rrakkomandata għal piżijiet tax-xogħol prevedibbli u b’traffiku għoli.
Mudelli disponibbli fuq Azure
Id-dokumentazzjoni ta’ Mistral telenka l-mudelli li ġejjin fuq Azure (lista miksuba fit-2 ta’ Novembru, 2026). Il-katalgu jevolvi regolarment: ikkonsulta l-paġna uffiċjali għall-lista attwali.
| Mudell | Pożizzjonament |
|---|---|
| Mistral Medium 3.5 | Bilanċ tajjeb bejn prestazzjoni u kost |
| Mistral Large 3 (25.12) | Il-mudell ewlieni għal kompiti kumplessi |
| Mistral Small (25.06) | Mgħaġġel u ekonomiku |
| Codestral (25.01) | Speċjalizzat fil-ġenerazzjoni tal-kodiċi |
| Ministral 3B (24.10) | Mudell kompatt għal kompiti ħfief |
| Document AI (OCR 4) | Estrazzjoni ta’ test u struttura f’dokumenti |
Kif tikseb il-kredenzjali tiegħek
L-irkupru tal-kredenzjali jsir permezz tal-interfaċċa ta’ Azure u jieħu ftit minuti:
- Mur fuq Microsoft Foundry
- Oħloq proġett jew agħżel wieħed eżistenti
- Iddeplowja mudell Mistral mill-katalgu tal-mudelli
- Irkupra l-endpoint u l-API key tiegħek mill-paġna tad-deploy
Poġġi dawn iż-żewġ valuri f’varjabbli tal-ambjent, eżattament bħall-key diretta ta’ Mistral. Id-differenza tinsab fl-endpoint: kull deploy ta’ Azure għandu l-endpoint tiegħu stess; m’hemm l-ebda URL komuni.
export AZUREAI_ENDPOINT="https://your-endpoint.inference.ai.azure.com"
export AZUREAI_API_KEY="your-azure-secret-key"
Sejħa tal-mudell f’Python
L-SDK ta’ Mistral jipprovdi klijent dedikat ta’ Azure, MistralAzure, inkluż fil-pakkett mistralai: inti tgħaddilu l-URL tad-deploy u l-key tiegħek, u l-bqija tal-kodiċi huwa identiku għal dak li tikteb għall-API diretta. Mill-verżjoni 2.0 tal-SDK (Marzu 2026), dan jiġi importat minn mistralai.azure.client.
import os
from mistralai.azure.client import MistralAzure
client = MistralAzure(
server_url=os.environ["AZUREAI_ENDPOINT"],
api_key=os.environ["AZUREAI_API_KEY"],
)
response = client.chat.complete(
model="azureai", # Identifikatur mistenni mill-endpoints ta' Azure
messages=[
{"role": "user", "content": "X'inhuma l-benefiċċji tas-sħab sovran fl-Ewropa?"}
]
)
print(response.choices[0].message.content)
Il-punt l-aktar konfuż jinsab fil-parametru model. Tistenna li tikteb mistral-large-latest; minflok, trid tpoġġi azureai. Ir-raġuni hija sempliċi: il-mudell huwa diġà ddeterminat mid-deploy li ħloqt fuq in-naħa ta’ Azure; l-endpoint jipponta lejh u lejh biss. Għalhekk, il-bidla tal-mudelli tfisser il-bidla tal-endpoints, mhux il-bidla ta’ stringa fil-kodiċi.
L-istreaming, madankollu, ma jinbidilx iota meta mqabbel mal-API diretta—l-istess metodu, l-istess livell .data biex tilħaq il-kontenut tal-biċċa. Dan huwa l-għan kollu ta’ SDK unifikat: il-kodiċi li ktibt fil-lezzjonijiet preċedenti jaħdem kif inhu.
stream = client.chat.stream(
model="azureai",
messages=[
{"role": "user", "content": "Iddeskrivi l-arkitettura ta' data lake fuq Azure."}
]
)
for chunk in stream:
content = chunk.data.choices[0].delta.content
if content:
print(content, end="", flush=True)
L-istess sejħa f’TypeScript
Fuq in-naħa ta’ TypeScript, il-klijent ta’ Azure huwa ppubblikat f’pakkett separat, @mistralai/mistralai-azure, installat b’npm add @mistralai/mistralai-azure. L-għażliet tiegħu jsegwu l-konvenzjoni ta’ casing ta’ JavaScript: apiKey u endpoint, it-tnejn meħtieġa. Minn hawn il-validazzjoni tal-varjabbli tal-ambjent, mingħajrha l-modalità strett tirrifjuta li tikkompila, peress li varjabbli tal-ambent tista’ tkun nieqsa:
import { MistralAzure } from '@mistralai/mistralai-azure';
const apiKey = process.env.AZUREAI_API_KEY;
const endpoint = process.env.AZUREAI_ENDPOINT;
if (!apiKey || !endpoint) {
throw new Error('Set AZUREAI_API_KEY and AZUREAI_ENDPOINT.');
}
const client = new MistralAzure({ apiKey, endpoint });
const response = await client.chat.complete({
model: 'azureai',
messages: [
{ role: 'user', content: 'Kif tiżgura Azure Key Vault?' },
],
});
console.log(response.choices[0]?.message?.content);
Sorsi: Mistral fuq Azure (Dokumentazzjoni ta’ Mistral) · TypeScript SDK
@mistralai/mistralai-azure
Sfruttar tal-bqija tal-pjattaforma
Ladarba s-sejħa taħdem, sfrutta s-servizzi li diġà qed tħallas għalihom. Aħżen il-keys tiegħek f’Azure Key Vault minflok f’varjabbli tal-ambjent: ir-rotazzjoni ssir operazzjoni amministrattiva, mhux redeploy. Ippermetti logs dijanjostiċi fuq l-endpoint tiegħek biex timmonitorja l-latency u l-iżbalji, l-uniku mod biex tiddistingwi l-moderezza tal-mudell mill-moderezza tal-kodiċi. Agħżel reġjun Ewropew, West Europe jew France Central, biex tibqa’ konformi mal-GDPR—dan spiss huwa r-raġuni stess għaliex tagħżel Azure. Fl-aħħar nett, ikkonfigura avviżi ta’ Azure Monitor fuq il-konsum tat-tokens: loop magħluq ħażin f’xogħol ta’ bil-lejl jidher fil-kont ferm aktar tard milli f’avviż.
Punti Ewlenin
- Azure AI joffri Mistral f’modalitajiet serverless (MaaS) jew GPU dedikat
- Il-mudell huwa identifikat b’
"azureai"fis-sejħiet tal-API - Il-klijent
MistralAzurejieħu l-endpoint permezz ta’server_url(Python,mistralai.azure.client) jewendpoint(TypeScript,@mistralai/mistralai-azure) - L-integrazzjoni mal-ekosistema ta’ Azure (Key Vault, Monitor, Functions) hija assi kbir għall-intrapriżi
- Agħżel reġjun Ewropew biex tibqa’ konformi mal-GDPR