Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Mistral fuq Azure AI

Lezzjoni 11 / 14 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Għaliex tuża Mistral permezz ta’ Azure?
  2. L-għażla bejn serverless u GPU dedikat
  3. Mudelli disponibbli fuq Azure
  4. Kif tikseb il-kredenzjali tiegħek
  5. Sejħa tal-mudell f’Python
  6. L-istess sejħa f’TypeScript
  7. Sfruttar tal-bqija tal-pjattaforma
  8. Punti Ewlenin

Aġġornat fit-3 ta’ Novembru, 2026: L-eżempju TypeScript kien jgħaddi process.env.AZUREAI_API_KEY u process.env.AZUREAI_ENDPOINT direttament lil MistralAzure. Peress li ż-żewġ għażliet huma meħtieġa, TypeScript 7 f’mod strett irrifjuta li jikkompila (verifikat ma’ @mistralai/mistralai-azure 2.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.

MudellPożizzjonament
Mistral Medium 3.5Bilanċ 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:

  1. Mur fuq Microsoft Foundry
  2. Oħloq proġett jew agħżel wieħed eżistenti
  3. Iddeplowja mudell Mistral mill-katalgu tal-mudelli
  4. 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 MistralAzure jieħu l-endpoint permezz ta’ server_url (Python, mistralai.azure.client) jew endpoint (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