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

Johdatus funktiokutsuihin

Oppitunti 1 / 14 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Miksi funktiokutsut muuttavat kaiken
  2. LLM + Työkalut -arkkitehtuuri
  3. Mitkä Mistral-mallit tukevat funktiokutsuja?
  4. Tyypilliset käyttötapaukset
  5. Mitä opit tällä kurssilla
  6. Keskeiset asiat

Päivitys 2. marraskuuta 2026 — Mallit. Mistral Large 3 (mistral-large-2512) ja Mistral Medium 3.5 poistettiin käytöstä 31. lokakuuta 2026, ja ne poistetaan kokonaan 30. huhtikuuta 2027. Niiden nimetty seuraaja, Mistral Large 4 (mistral-large-4), on ollut julkisessa esiversiossa 6. lokakuuta lähtien. Tämän kurssin esimerkeissä käytetään aliasta mistral-large-latest, joka osoittaa tällä hetkellä Mistral Large 3 -malliin sen virallisen määritelmän mukaisesti (varmistettu 3. marraskuuta 2026). Vastaavasti mistral-medium-latest osoittaa Mistral Medium 3.5 -malliin. Nämä aliakset pysyvät voimassa 30. huhtikuuta 2027 saakka. Uusia projekteja varten testaa mistral-large-4:ää, niiden nimettyä seuraajaa.

Miksi funktiokutsut muuttavat kaiken

Suuret kielimallit, kuten Mistral AI:n mallit, ovat erinomaisia ymmärtämään ja tuottamaan tekstiä. Todellisessa maailmassa tämä harvoin riittää. Kysymykseen “Missä tilaukseni on?” vastaaminen vaatii tietokannan kyselyä. Maksun vahvistaminen tarkoittaa transaktion tarkistamista tai jopa käynnistämistä. Ajan varaaminen edellyttää kalenterin lukemista. Funktiokutsut ovat mekanismi, jonka avulla suuri kielimalli (LLM) voi ylittää rajan tekstin ja toiminnan välillä.

Prosessi koostuu kolmesta vaiheesta. Malli päättää, että sen on kutsuttava ulkoista funktiota, luo vaaditut argumentit JSON-muodossa ja antaa sitten sinun koodisi suorittaa funktion ja palauttaa tuloksen. Malli ei missään vaiheessa koske järjestelmiäsi suoraan: säilytät täyden hallinnan.

LLM + Työkalut -arkkitehtuuri

Kaikki perustuu tehtävien tiukkaan erotteluun. Tämä kannattaa todeta tarkasti, sillä koko kurssi rakentuu tämän varaan. Malli ymmärtää käyttäjän pyynnön, valitsee oikean funktion ja laatii argumentit. Vain sinun koodisi suorittaa kyseisen funktion, käyttää dataa ja palauttaa tuloksen. Tämän jälkeen malli ottaa taas ohjat muuntaakseen raakatuloksen luontevaksi vastaukseksi.

Etuna on merkittävä turvallisuus: mallilla ei ole suoraa pääsyä järjestelmiisi, eikä se voi suorittaa mielivaltaista koodia. Se ilmaisee ainoastaan aikomuksen – “Haluaisin kutsua tätä funktiota näillä parametreilla” – ja sovelluksesi päättää, mitä asialle tehdään. Tilin poistopyyntö voidaan näin ollen hylätä, kirjata lokitiedostoon tai vaatia vahvistus ennen kuin mitään suoritetaan.

# Yksinkertaistettu näkymä kulusta
user = "Mikä on tilauksen #4521 status?"

# 1. Malli analysoi ja päättää
# → "Minun on kutsuttava get_order_status arvollaan order_id=4521"

# 2. Sinun koodisi suorittaa
result = get_order_status(order_id=4521)
# → {"status": "shipped", "tracking": "FR123456789"}

# 3. Malli muotoilee vastauksen
# → "Tilauksesi #4521 on lähetetty. Tässä on seurantanumerosi: FR123456789."

Huomaa datan kulku tässä esimerkissä: seurantanumero FR123456789 ei ole missään vaiheessa mallin tiedossa. Se tulee järjestelmästäsi, kulkee vastausviestin läpi ja päätyy lauseeseen, jonka käyttäjä voi lukea. Juuri tämän funktiokutsut mahdollistavat.

Mitkä Mistral-mallit tukevat funktiokutsuja?

Kaikki tärkeimmät Mistral-mallit tukevat tätä ominaisuutta. Yleiskäyttöisistä malleista mukana ovat Mistral Large 3, Medium 3.5, Small 4 ja Ministral 3 sen kolmessa koossa (14B, 8B, 3B). Erikoismalleista Devstral 2.0, Devstral Small 2 ja Codestral tarjoavat myös tämän ominaisuuden. Magistral Medium ja Small tarjosivat sitä myös, mutta tämä perhe on nyt poistettu käytöstä: päättelykyvyt on nyt integroitu Mistral Small 4- ja Medium 3.5 -malleihin.

Valintasi riippuu käyttötarkoituksestasi. Monimutkaisiin funktiokutsuihin, joissa on paljon parametreja ja hienovaraisia kompromisseja useiden työkalujen välillä, Mistral Large 3 on edelleen luotettavin. Yksinkertaisiin, suurta läpimenoa vaativiin tuotantotilanteisiin – jossa avustaja kysyy kahta tai kolmea hyvin määriteltyä funktiota tuhansia kertoja päivässä – Mistral Small 4 tarjoaa erinomaisen hinta-laatusuhteen.

Tyypilliset käyttötapaukset

Sovellukset ovat moninaisempia kuin ensisilmäyksellä näyttää. CRM-, ERP- tai tukipyyntötietokantaan kytketty keskusteluavustaja vastaa kyselyihin: malli lukee dataa mutta ei muuta sitä. Automaatio menee pidemmälle käynnistämällä työnkulkuja – sähköpostin lähettäminen, tehtävän luominen, tilan päivittäminen – mikä tarkoittaa paljon suurempaa vastuuta koodin puolella. Laajennetussa haussa (RAG) funktiokutsut siirtävät päätöksenteon: vektoritietokantaa ei kysellä järjestelmällisesti, vaan annat mallin päättää, milloin ja miten se tehdään, välttäen tarpeettoman kontekstin syöttämisen.

Kaksi kunnianhimoisempaa käyttötapausta täydentävät kuvaa. Autonomiset agentit ketjuttavat useita funktiokutsuja monimutkaisen tehtävän suorittamiseksi, jolloin jokainen tulos ohjaa seuraavaa kutsua. Lopuksi luontevat käyttöliittymät mahdollistavat sen, että käyttäjä voi ohjata koko sovellusta keskustelun avulla ilman, että hänen tarvitsee koskaan oppia, mistä tietty painike löytyy.

Mitä opit tällä kurssilla

Kurssi koostuu neljästätoista oppitunnista ja noudattaa tarkoituksellisen lineaarista etenemistä. Aloitat peruskäsitteistä: viisivaiheisesta prosessista ja JSON-skeemoista, jotka kuvaavat funktioitasi. Siirryt sitten Python-toteutukseen – funktioiden kirjoittamiseen, kutsumiseen, suorittamiseen ja ketjuttamiseen Mistral SDK:n avulla. Kolmas osio kattaa edistyneet ominaisuudet: rinnakkaiskutsut, tool_choice-valinnat, virheenkäsittelyn ja turvallisuuden. Kurssi päättyy todellisiin käyttötapauksiin – maksunseuranta, automatisoitu CRM – ja tuotannon best practice -ohjeisiin.

Tämän kurssin päätteeksi osaat suunnitella, toteuttaa ja ottaa käyttöön vankan funktiokutsujärjestelmän Mistral API:n avulla.

Keskeiset asiat

  • Funktiokutsut mahdollistavat sen, että malli voi pyytää funktion suorittamista suorittamatta sitä itse
  • Arkkitehtuuri perustuu tiukkaan erotteluun: malli luo argumentit, sinun koodisi suorittaa
  • Kaikki tärkeimmät Mistral-mallit tukevat tätä ominaisuutta
  • Funktiokutsut ovat tekoälyagenttien ja keskusteluautomaation perusrakennuspalikka