Käytännön käyttötapaukset ennustetuille tulosteille
Tällä sivulla
Kolme käyttötapausperhettä
Näiden kolmen perheen yhteinen nimittäjä on yksinkertainen: Ennustetut tulosteet tuottavat suurimman hyödyn silloin, kun suurin osa tulosteesta on tiedossa etukäteen. Tehtävän luonteella – olipa kyseessä koodi, teksti tai mallipohja – on vähemmän väliä kuin sillä, kuinka suuren osan lopputuloksesta voit tarjota ennusteena. Kun 90 % sisällöstä pysyy muuttumattomana, hyöty on valtava; 30 %:n kohdalla se on merkityksetön, käyttötapauksesta riippumatta.
Pidä tämä suhdeluku mielessäsi tutkiessasi alla olevia kolmea perhettä. Ne edustavat skenaarioita, joissa tämä suhde on luonnostaan korkea. Tässä oppitunnissa näet konkreettisia esimerkkejä jokaisesta kategoriasta sekä kaavoja, joita voit soveltaa omissa sovelluksissasi.
Käyttötapaus 1: Koodin muokkaus
Tämä on luontevin käyttökohde, koska koodi maksimoi suhteen mekaanisesti: muuttujan nimen vaihtaminen 500 rivin tiedostossa jättää 498 riviä täysin identtisiksi. Lähdet liikkeelle olemassa olevasta lähdekooditiedostosta ja haluat tehdä kohdennetun muutoksen. Mallin tarvitsee vain uudelleentuottaa muutetut rivit.
Muuttujan nimen vaihtaminen
existing_code = """
def calculate_total(items):
tax_rate = 0.20
subtotal = sum(item.price for item in items)
tax = subtotal * tax_rate
total = subtotal + tax
return total
"""
prompt = (
"Rename the variable 'tax_rate' to 'vat_rate' throughout this code. "
"Reply with only the modified code."
)
response = client.chat.complete(
model="codestral-latest",
messages=[
{"role": "user", "content": prompt},
{"role": "user", "content": existing_code}
],
prediction={"type": "content", "content": existing_code}
)
Malli tietää, että koodin rakenne pysyy identtisenä. Se laskee uudelleen vain ne tokenit, joihin nimenmuutos vaikuttaa.
Tuonnin tai riippuvuuden vaihtaminen
existing_code = """
from flask import Flask, request, jsonify
from flask_cors import CORS
app = Flask(__name__)
CORS(app)
@app.route('/api/predict', methods=['POST'])
def predict():
data = request.get_json()
result = model.predict(data['input'])
return jsonify({'prediction': result})
"""
prompt = (
"Migrate this code from Flask to FastAPI. "
"Keep the same business logic. "
"Reply with only the code."
)
response = client.chat.complete(
model="codestral-latest",
messages=[
{"role": "user", "content": prompt},
{"role": "user", "content": existing_code}
],
prediction={"type": "content", "content": existing_code}
)
Käyttötapaus 2: Tekstin muokkaus
Teksti noudattaa samaa logiikkaa kuin koodi, mutta yhtä tärkeää vivahdetta ei saa unohtaa: tekstimuutokset ovat usein vähemmän paikallisia kuin luulisi. Luvun muuttaminen raportissa voi laukaista uudelleenkirjoituksen lauseessa, joka kommentoi lukua, yhteenvetokappaleessa ja johtopäätöksissä. Hyöty on todellinen, mutta mittaa se todellisilla dokumenteillasi äläkä oleta sen olevan yhtä suuri kuin koodin kohdalla havaittu hyöty.
Raportin osion päivittäminen
report = """
# Q4 2025 Quarterly Report
## Executive Summary
Revenue reached €2.3M in Q4 2025, up 15%
from Q3. Operating margin stands at 22%.
## Sales Performance
The sales team signed 47 new contracts, including 12 key accounts.
Average deal size grew 8% to €49,000.
## Q1 2026 Outlook
We anticipate 10% growth driven by the launch of the
Enterprise product and expansion into the German market.
"""
prompt = (
"Update this report for Q1 2026 with the following data: "
"Revenue = €2.7M (+17%), margin = 24%, 53 new contracts, "
"average deal size = €51,000 (+4%). "
"For the Q2 outlook, mention expansion into the Benelux region. "
"Keep the exact same structure."
)
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{"role": "user", "content": prompt},
{"role": "user", "content": report}
],
prediction={"type": "content", "content": report}
)
Käyttötapaus 3: Mallipohjan täyttäminen
Kun sinulla on kiinteä mallipohja, jossa vain harvat arvot muuttuvat, ennuste on lähes täydellinen:
email_template = """
Hello {name},
Following up on our conversation on {date}, I confirm the following points:
1. The {project} project will start on {start_date}
2. The team will consist of {num_people} people
3. The estimated budget is €{budget} (excl. tax)
I remain at your disposal for any questions.
Best regards,
{signatory}
"""
# Partially fill the template for prediction
prediction = email_template.replace("{name}", "Mr. Dupont")
prediction = prediction.replace("{signatory}", "Marie Martin")
prompt = (
"Complete this email with the following information: "
"date = March 28, 2026, project = Cloud Migration, "
"start_date = April 15, 2026, num_people = 5, "
"budget = 85,000."
)
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{"role": "user", "content": prompt},
{"role": "user", "content": prediction}
],
prediction={"type": "content", "content": prediction}
)
Todellisten hyötyjen mittaaminen
Arvioidaksesi ennustettujen tulosteiden tehokkuutta omassa käyttötapauksessasi, vertaa systemaattisesti ajoja ennusteen kanssa ja ilman sitä:
import time
# Without prediction
start = time.time()
resp_normal = client.chat.complete(
model="mistral-large-latest",
messages=messages
)
time_normal = time.time() - start
# With prediction
start = time.time()
resp_predicted = client.chat.complete(
model="mistral-large-latest",
messages=messages,
prediction={"type": "content", "content": predicted_content}
)
time_predicted = time.time() - start
gain = (1 - time_predicted / time_normal) * 100
print(f"Without prediction: {time_normal:.2f}s")
print(f"With prediction: {time_predicted:.2f}s")
print(f"Latency gain : {gain:.1f}%")
Hyöty vaihtelee sen mukaan, kuinka suuri prosenttiosuus sisällöstä ennustettiin oikein. Jos 500 rivin tiedostosta muuttuu 5 %, voit odottaa viiveen lyhenevän 60–80 %.
Keskeiset asiat
- Koodin muokkaus (nimenmuutokset, migraatiot, kevyt refaktorointi) on ensisijainen käyttötapaus
- Tekstin muokkaus (raportit, dokumentit) hyötyy vakaasta rakenteesta
- Mallipohjat, joissa on vain muutama dynaaminen arvo, tarjoavat parhaan hyötysuhteen vaivaan nähden
- Mittaa aina todellinen hyöty omassa kontekstissasi ennen tuotantoon käyttöönottoa