Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Mistral Azure AI-s

Õppetund 11 / 14 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Miks kasutada Mistrali Azure’i kaudu?
  2. Serverita ja pühendatud GPU vahel valimine
  3. Azure’is saadaval olevad mudelid
  4. Volituste hankimine
  5. Mudeli kutsumine Pythonis
  6. Sama väljakutse TypeScriptis
  7. Platvormi ülejäänud osa ärakasutamine
  8. Peamised punktid

Uuendatud 3. novembril 2026: Varasem TypeScripti näide edastas process.env.AZUREAI_API_KEY ja process.env.AZUREAI_ENDPOINT otse objektile MistralAzure. Kuna mõlemad valikud on kohustuslikud, keeldus TypeScript 7 rangest režiimist kompileerimast (kontrollitud versiooniga @mistralai/mistralai-azure 2.1.0). Keskkonnamuutujaid valideeritakse nüüd enne kliendi loomist. Allikas: @mistralai/mistralai-azure SDK.

Miks kasutada Mistrali Azure’i kaudu?

See küsimus tekib harva tehnilistel põhjustel: otsene Mistrali API töötab laitmatult. Põhjused on lepingulised ja organisatoorsed. Ettevõte, mis on juba Microsofti ökosüsteemi sügavalt integreeritud, tarbib läbiräägitud Azure’i kohustust, omab väljakujunenud hankeprotsesse ja ei soovi avada uut müüjalepingut vaid mõne tuhande euro väärtuses tokenite jaoks.

Azure AI kasutamine koondab arvelduse olemasolevale Azure’i lepingule, tagab GDPR-i nõuetele vastavuse Euroopa piirkondade kaudu, pakub loomulikku integratsiooni teiste Azure’i teenustega – Azure Functions, Cosmos DB, Azure ML – ning pakub Microsofti ettevõtte tuge koos vastavate teenindustaseme lepingutega. Lühidalt: sama mudel, kuid sinu IT-osakonna juba heaks kiidetud haldusperimeetri sees.

Serverita ja pühendatud GPU vahel valimine

Azure pakub kahte lähenemist ning valik sõltub töökoormuse regulaarsusest. Maksa-kasutuse-eest režiim, tuntud ka kui MaaS (Mudel teenusena), paljastab serverita API: GPU-sid pole vaja ette valmistada, maksad ainult tarbitud tokenite eest ja Azure haldab skaleerimist ise. See on soovitatav režiim enamiku kasutusjuhtude jaoks, eriti kui sinu liiklus on ebaregulaarne või ettearvamatu.

Reaalaja lõpp-punktid (real-time endpoints) vastavad vastupidisele vajadusele. Valid GPU tüübi ja arvu, taristu on pühendatud ainult sulle ja arveldus toimub arvutustunni põhjal – sõltumata sellest, kas mudel töötab või seisab. Sisemine API, mida tabab pidevalt mitu tuhat kasutajat, sobib selle mudeliga; prototüüp, mida kasutatakse kolm korda päevas, raiskab siin palju raha. Pea meeles reeglit: see režiim on soovitatav etteaimatavate ja suure läbilaskevõimega töökoormuste jaoks.

Azure’is saadaval olevad mudelid

Mistrali dokumentatsioon loetleb Azure’is järgmised mudelid (loend hangitud 2. novembril 2026). Kataloog muutub regulaarselt: praeguse loendi jaoks vaata ametlikku lehte.

MudelPositsioneerimine
Mistral Medium 3.5Hea jõudluse ja hinna suhe
Mistral Large 3 (25.12)Lipulaevamudel keerukate ülesannete jaoks
Mistral Small (25.06)Kiire ja ökonoomne
Codestral (25.01)Spetsialiseerunud koodi genereerimisele
Ministral 3B (24.10)Kompaktne mudel kergete ülesannete jaoks
Document AI (OCR 4)Teksti ja struktuuri ekstraheerimine dokumentidest

Volituste hankimine

Volituste hankimine toimub Azure’i liidese kaudu ja võtab aega paar minutit:

  1. Mine aadressile Microsoft Foundry
  2. Loo projekt või vali olemasolev
  3. Paigalda Mistrali mudel mudelikataloogist
  4. Hangi oma lõpp-punkt (endpoint) ja API võti paigalduslehelt

Salvesta need kaks väärtust keskkonnamuutujatesse, täpselt nagu otsese Mistrali võtmega. Erinevus seisneb lõpp-punktis: igal Azure’i paigaldusel on oma; ühist URL-i ei eksisteeri.

export AZUREAI_ENDPOINT="https://your-endpoint.inference.ai.azure.com"
export AZUREAI_API_KEY="your-azure-secret-key"

Mudeli kutsumine Pythonis

Mistrali SDK pakub spetsiaalset Azure’i klienti MistralAzure, mis sisaldub paketis mistralai: edastad sellele oma paigalduse URL-i ja võtme, ning ülejäänud kood on identne sellega, mida kirjutad otsese API jaoks. Alates SDK versioonist 2.0 (märts 2026) imporditakse see moodulist 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",  # Azure'i lõpp-punktide oodatav identifikaator
    messages=[
        {"role": "user", "content": "Millised on suveräänse pilve eelised Euroopas?"}
    ]
)

print(response.choices[0].message.content)

Kõige segasem punkt peitub parameetris model. Ootad, et kirjutad mistral-large-latest; selle asemel pead panema azureai. Põhjus on lihtne: mudeli on juba määranud Azure’i poolel loodud paigaldus; lõpp-punkt osutab just sellele ja mitte millelegi muule. Mudeli muutmine tähendab seega lõpp-punkti vahetamist, mitte stringi muutmist koodis.

Voogedastus (streaming) ei erine aga otsesest API-st mitte ühegi detaili võrra – sama meetod, sama .data tase tüki sisuni jõudmiseks. Selles seisnebki ühtse SDK mõte: kood, mille kirjutasid eelmistes tundides, töötab muutumatult.

stream = client.chat.stream(
    model="azureai",
    messages=[
        {"role": "user", "content": "Kirjelda andmejärve arhitektuuri Azure'is."}
    ]
)

for chunk in stream:
    content = chunk.data.choices[0].delta.content
    if content:
        print(content, end="", flush=True)

Sama väljakutse TypeScriptis

TypeScripti poolel avaldatakse Azure’i klient eraldi paketis @mistralai/mistralai-azure, mis installitakse käsuga npm add @mistralai/mistralai-azure. Selle valikud järgivad JavaScripti tähistust: apiKey ja endpoint, mõlemad kohustuslikud. Seetõttu on vajalik keskkonnamuutujate valideerimine, ilma milleta rangest režiimist kompileerimine ebaõnnestub, kuna keskkonnamuutuja võib puududa:

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: 'How to secure an Azure Key Vault?' },
  ],
});

console.log(response.choices[0]?.message?.content);

Allikad: Mistral Azure’is (Mistrali dokumentatsioon) · TypeScript SDK @mistralai/mistralai-azure

Platvormi ülejäänud osa ärakasutamine

Kui väljakutse töötab, kasuta ära teenuseid, mille eest juba maksad. Salvesta oma võtmed Azure Key Vaulti keskkonnamuutujate asemel: võtmete vahetamine muutub haldustoiminguks, mitte ümberpaigaldamiseks. Luba oma lõpp-punktil diagnostikalogid, et jälgida latentsust ja vigu; see on ainus viis eristada mudeli aeglust koodi aeglusest. Vali Euroopa piirkond, näiteks Lääne-Euroopa või Prantsusmaa Keskpiirkond, et jääda GDPR-iga kooskõlla – see on sageli Azure’i valimise peamine põhjus. Lõpuks konfigureeri Azure Monitori hoiatused tokenite tarbimise kohta: öises töös halvasti suletud tsükkel ilmneb arvele palju hiljem kui hoiatuses.

Peamised punktid

  • Azure AI pakub Mistrali serverita (MaaS) või pühendatud GPU režiimis
  • Mudelit identifitseeritakse API väljakutsetes stringiga "azureai"
  • Klient MistralAzure võtab lõpp-punkti vastu parameetri server_url kaudu (Python, mistralai.azure.client) või endpoint kaudu (TypeScript, @mistralai/mistralai-azure)
  • Integratsioon Azure’i ökosüsteemiga (Key Vault, Monitor, Functions) on ettevõtete jaoks suur eelis
  • GDPR-iga kooskõlas püsimiseks vali Euroopa piirkond