Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Mistral Azure AI:ssa

Oppitunti 11 / 14 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Miksi käyttää Mistralia Azuren kautta?
  2. Palvelimetön vs. omistettu GPU
  3. Azuressa saatavilla olevat mallit
  4. Tunnistetietojen hankkiminen
  5. Mallin kutsuminen Pythonilla
  6. Sama kutsu TypeScriptillä
  7. Alustan muiden osien hyödyntäminen
  8. Keskeiset asiat

Päivitetty 3. marraskuuta 2026: Aiempi TypeScript-esimerkki välitti muuttujat process.env.AZUREAI_API_KEY ja process.env.AZUREAI_ENDPOINT suoraan funktiolle MistralAzure. Koska molemmat vaihtoehdot ovat pakollisia, TypeScript 7 tiukassa tilassa kieltäytyi kääntämästä koodia (varmistettu versiolla @mistralai/mistralai-azure 2.1.0). Ympäristömuuttujat validoidaan nyt ennen asiakasohjelman luomista. Lähde: @mistralai/mistralai-azure SDK.

Miksi käyttää Mistralia Azuren kautta?

Tämä kysymys nousee harvoin teknisistä syistä: suora Mistral API toimii moitteettomasti. Syynä ovat sopimukselliset ja organisaatioon liittyvät seikat. Yritys, joka on jo syvällä Microsoft-ekosysteemissä, hyödyntää neuvoteltua Azure-sitoumustaan, sillä on vakiintuneet hankintaprosessit, eikä se halua avata uutta toimittajasopimusta vain muutaman tuhannen euron arvoisten tokenien vuoksi.

Azure AI:n käyttö konsolidoi laskutuksen olemassa olevaan Azure-sopimukseesi, varmistaa GDPR-vaatimustenmukaisuuden eurooppalaisten alueiden kautta, tarjoaa natiivin integraation muihin Azure-palveluihin – kuten Azure Functions, Cosmos DB ja Azure ML – sekä antaa pääsyn Microsoftin yritystukeen siihen liittyvine palvelutasosopimuksineen. Lyhyesti sanottuna: sama malli, mutta jo IT-osastosi hyväksymän hallintakehyksen sisällä.

Palvelimetön vs. omistettu GPU

Azure tarjoaa kaksi lähestymistapaa, ja valinta riippuu kuormituksen säännöllisyydestä. Maksu käytön mukaan -tila, tunnetaan myös nimellä MaaS (Model as a Service), tarjoaa palvelimetön API:n: GPU-resursseja ei tarvitse varata, maksat vain kulutetuista tokeneista, ja Azure hoitaa skaalautuvuuden automaattisesti. Tämä on suositeltu tila useimpiin käyttötarkoituksiin, erityisesti kun liikenne on epäsäännöllistä tai arvaamatonta.

Reaaliaikaiset päätepisteet (Real-time endpoints) vastaavat päinvastaista tarvetta. Valitset GPU-tyypin ja määrän, infrastruktuuri on omistettu sinulle, ja laskutus tapahtuu laskenta tuntien perusteella – riippumatta siitä, työskenteleekö malli vai onko se jouten. Sisäinen API, jota useat tuhannet käyttäjät kuormittavat jatkuvasti, sopii tähän malliin; prototyyppi, jota käytetään kolme kertaa päivässä, tuhlaa tässä tilassa paljon rahaa. Muista sääntö: tämä tila on suositeltu ennustettaville, suuritehoisille kuormituksille.

Azuressa saatavilla olevat mallit

Mistralin dokumentaatio listaa seuraavat mallit Azuressa (lista haettu 2. marraskuuta 2026). Valikoima kehittyy jatkuvasti: tarkista ajantasainen lista viralliselta sivulta.

MalliSijoittelu
Mistral Medium 3.5Hyvä suorituskyvyn ja kustannusten suhde
Mistral Large 3 (25.12)Lippulaivamalli vaativiin tehtäviin
Mistral Small (25.06)Nopea ja taloudellinen
Codestral (25.01)Erikoistunut koodin generointiin
Ministral 3B (24.10)Kompakti malli kevyisiin tehtäviin
Document AI (OCR 4)Tekstin ja rakenteen erottelu dokumenteista

Tunnistetietojen hankkiminen

Tunnistetietojen hakeminen tapahtuu Azure-käyttöliittymän kautta ja vie vain muutaman minuutin:

  1. Siirry osoitteeseen Microsoft Foundry
  2. Luo projekti tai valitse olemassa oleva
  3. Ota käyttöön Mistral-malli malliluettelosta
  4. Hae päätepisteesi (endpoint) ja API-avaimesi käyttöönotto-sivulta

Sijoita nämä kaksi arvoa ympäristömuuttujiin, aivan kuten suoran Mistral-avaimenkin. Ero on päätepisteessä: jokaisella Azure-käyttöönotolla on oma osoitteensa; yhteistä URL-osoitetta ei ole.

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

Mallin kutsuminen Pythonilla

Mistral SDK tarjoaa erillisen Azure-asiakasohjelman, MistralAzure, joka sisältyy mistralai-pakettiin: syötät sille käyttöönotto-URL-osoitteesi ja avaimesi, ja loput koodista ovat identtisiä suoralle API:lle kirjoitetun kanssa. SDK-version 2.0 (maaliskuu 2026) jälkeen se tuodaan moduulista 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-päätepisteiden odottama tunniste
    messages=[
        {"role": "user", "content": "What are the benefits of sovereign cloud in Europe?"}
    ]
)

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

Sekavin kohta on parametri model. Odotat kirjoittavasi mistral-large-latest; sen sijaan sinun on syötettävä azureai. Syy on yksinkertainen: malli on jo määritetty Azure-puolella luomassasi käyttöönotossa; päätepiste osoittaa nimenomaan siihen eikä mihinkään muuhun. Mallin vaihtaminen tarkoittaa siis päätepisteen vaihtamista, ei merkkijonon muuttamista koodissa.

Striimaus (streaming) ei kuitenkaan eroa tippaakaan suorasta API:sta – sama metodi, sama .data-taso palan sisällön saavuttamiseksi. Siinä piilee yhtenäisen SDK:n koko pointti: aiemmissa oppitunneissa kirjoittamasi koodi toimii sellaisenaan.

stream = client.chat.stream(
    model="azureai",
    messages=[
        {"role": "user", "content": "Describe the architecture of a data lake on Azure."}
    ]
)

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

Sama kutsu TypeScriptillä

TypeScript-puolella Azure-asiakasohjelma julkaistaan erillisessä paketissa @mistralai/mistralai-azure, joka asennetaan komennolla npm add @mistralai/mistralai-azure. Sen vaihtoehdot noudattavat JavaScript-käytäntöjä: apiKey ja endpoint, joista molemmat ovat pakollisia. Tästä johtuu ympäristömuuttujien validointi, ilman jota tiukka tila kieltäytyy kääntämästä koodia, sillä ympäristömuuttuja saattaa puuttua:

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);

Lähteet: Mistral Azurella (Mistralin dokumentaatio) · TypeScript SDK @mistralai/mistralai-azure

Alustan muiden osien hyödyntäminen

Kun kutsu toimii, hyödynnä palveluita, joista jo maksat. Tallenna avaimesi Azure Key Vaultiin ympäristömuuttujien sijaan: kierrätys muuttuu hallinnolliseksi toimeksi, ei uudelleenkäyttöönotoksi. Ota käyttöön diagnostiikkalokit päätepisteessäsi valvoaksesi viivettä ja virheitä; tämä on ainoa tapa erottaa mallin hitaus koodin hitaudesta. Valitse eurooppalainen alue, kuten West Europe tai France Central, pysyäksesi GDPR-vaatimusten mukaisena – tämä on usein juuri syy Azuren valitsemiseen. Lopuksi, määritä Azure Monitor -hälytykset tokenien kulutukselle: huonosti suljettu silmukka yöajossa näkyy laskulla paljon myöhemmin kuin hälytyksessä.

Keskeiset asiat

  • Azure AI tarjoaa Mistralin palvelimettömänä (MaaS) tai omistettuna GPU:na
  • Malli tunnistetaan API-kutsuissa merkkijonolla "azureai"
  • MistralAzure-asiakasohjelma vastaanottaa päätepisteen parametrilla server_url (Python, mistralai.azure.client) tai endpoint (TypeScript, @mistralai/mistralai-azure)
  • Integrointi Azure-ekosysteemiin (Key Vault, Monitor, Functions) on merkittävä etu yrityksille
  • Valitse eurooppalainen alue pysyäksesi GDPR-vaatimusten mukaisena