Kehitysmallin kehottaminen
Tällä sivulla
Oppitunti kirjoitettu uudelleen 2. marraskuuta 2026. Tämä oppitunti käsitteli aiemmin Magistral-järjestelmäkehottetta, joka poistettiin käytöstä 31. heinäkuuta 2026. Nykyinen päättelydokumentaatio (Reasoning) ei enää vaadi erillistä järjestelmäkehottetta:
reasoning_effortriittää. Seuraavat osiot erottavat toisistaan sen, mitä Magistral-dokumentaatio väitti, mitä on muuttunut ja mitkä kehotesäännöt ovat edelleen hyödyllisiä.
Mikä on muuttunut Magistralin jälkeen
Magistral toimi parhaiten oletusarvoisella järjestelmäkehotteella, jonka dokumentaatio toisti (nykyisin arkistoitu sivulla Native reasoning (deprecated)). Pohjimmiltaan se ohjeisti mallia laatimaan päättelynsä ensin ikään kuin sisäisenä monologina, jota seurasi itsenäinen vastaus; kirjoittamaan Markdown-muodossa käyttäen LaTeXia yhtälöihin; ja vastaamaan kyselyn kielellä. Se sisälsi jopa päättelymallin thinking-fragmentin muodossa järjestelmäviestiin. Parametri prompt_mode mahdollisti tämän oletuskehotteen pakottamisen ("reasoning") tai sen poistamisen käytöstä (None).
Nykyisten mallien kanssa mikään tästä ei ole tarpeen: päättelysivu ei mainitse erillistä järjestelmäkehottetta eikä prompt_mode-parametria. Otat päättelyn käyttöön parametrilla reasoning_effort, ja järjestelmäkehotteesi palautuu standardiksi kehotteeksi, joka on omistettu roolille, menetelmälle ja odotetulle muodolle. Jos siirryt Magistralista, poista päättelymalli järjestelmäviesteistäsi ja prompt_mode kutsuistasi, ja vertaa sitten tuloksia (oppitunti 8).
Päättelyn ja vastauksen erottaminen
Mallilla on nyt kaksi erillistä tilaa: päättely, jota käyttäjä ei usein näe, ja lopullinen vastaus. Hyvä keote huomioi tämän. Se kuvailee odotettua menetelmää, sitä mitä alan asiantuntija tarkistaisi, ja se määrittää vastausmuodon: vastauksen on oltava ymmärrettävä ilman päättelyä, sillä päättely on yleensä piilotettu.
import os
from mistralai.client import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
system_prompt = """Olet kokenut Python-vianetsintäasiantuntija.
MENETELMÄ
- Lue kaikki koodi ennen diagnoosin muodostamista.
- Muodosta vähintään kaksi hypoteesia ennen johtopäätöstä.
- Varmista, ettei korjauksesi luo uutta ongelmaa.
LOPULLINEN VASTAUS
1. Tarkka diagnoosi
2. Perussyy
3. Korjattu koodi
4. Testi, joka todistaa korjauksen"""
response = client.chat.complete(
model="mistral-small-2603",
messages=[
{"role": "system", "content": system_prompt},
{"role": "user", "content": "My code crashes with a RecursionError: def fibonacci(n): return fibonacci(n-1) + fibonacci(n-2)"},
],
reasoning_effort="high",
)
Tässä fibonacci-funktiossa, jolta puuttuu perustapaus, vaatimus kahdesta hypoteesista estää refleksiomaisen diagnoosin “kasata rekursiorajaa” ja johtaa todelliseen syyhyn.
Soveltaminen toimialakohtaisesti
Sama runko, ensin menetelmä ja sitten vastausmuoto, mukautuu tiettyyn toimialaan. Matematiikassa menetelmä keskittyy hypoteeseihin ja todistustyyppiin:
math_prompt = """Olet rigorööri matemaatikko.
MENETELMÄ
- Ilmoita hypoteesit ennen jokaista todistusta.
- Valitse eksplisiittisesti induktion, ristiriidan tai suoran laskennan välillä.
- Varmista tulos tietyssä tapauksessa.
LOPULLINEN VASTAUS
Muodollinen todistus: hypoteesit, perustellut vaiheet, johtopäätös."""
Strategisessa analyysissä keskitytään sidosryhmiin ja kvantifiointiin, ja odotettu vastaus muuttuu suositukseksi, jonka liitteenä on suunnitelma:
strategy_prompt = """Olet strategiakonsultti.
MENETELMÄ
- Arvioi jokaista vaihtoehtoa toteutettavuuden, vaikutuksen ja riskin perusteella.
- Kvantifioi aina kun mahdollista, vaikka vain suuruusluokkana.
- Etsi vahvin vastaväite omalle suosituksellesi.
LOPULLINEN VASTAUS
Selkeä suositus, kunkin vaihtoehdon hyvät ja huonot puolet, toimintasuunnitelma päivämäärineen."""
Kolme yleistä virhettä
Kehote on liian epämääräinen. “Olet avulias avustaja” ei kerro mitään menetelmästä: malli päättelee tapojensa eikä sinun tapojesi mukaan. Kuvaile, mitä asiantuntija tarkistaisi.
Kehote on ristiriitainen. “Ole hyvin ytimekäs. Yksityiskohtaista jokaista vaihetta perusteellisesti” asettaa mallin mahdottoman käskyn eteen. Ratkaise ristiriita jakamalla roolit: yksityiskohdat kuuluvat päättelyyn, ytimekkyys lopulliseen vastaukseen.
good_prompt = """Ole ytimekäs lopullisessa vastauksessasi: vain johtopäätökset ja olennaiset luvut.
Tutki yksityiskohtia päättelyssäsi, älä vastauksessa."""
Prosessin pyytäminen vastaukseen. “Päättele vaihe vaiheelta” -pyytäminen näkyvässä vastauksessa saa mallin kirjoittamaan uudelleen sen, mitä se on jo tehnyt päättelyssään: vastaus pitenee, ja maksat kahdesti samoista vaiheista tulostokeneissä. Pyydä vaiheita vastaukseen vain, jos käyttäjän tarvitsee lukea ne, esimerkiksi opettavassa tutorissa.
Keskeiset asiat
- Oletusarvoinen järjestelmäkehotus ja
prompt_modeolivat ominaisia Magistralille: niitä ei enää tarvita - Ota päättely käyttöön parametrilla
reasoning_effortja pidä järjestelmäkehotus sen klassisessa roolissa - Kuvaile odotettu menetelmä ja sellaisen vastauksen muoto, joka on luettavissa ilman päättelyä
- Jaa roolit: yksityiskohdat päättelyyn, ytimekkyys vastaukseen
- Älä pakota mallia kirjoittamaan prosessia uudelleen vastaukseen, jos kenenkään ei tarvitse lukea sitä