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

Parhaat käytännöt ja yleisimmät virheet

Oppitunti 14 / 14 Päivitetty 3. marraskuuta 2026 Aloittelija
Tällä sivulla
  1. Yhteenveto ja suojakaiteet
  2. Parhaat käytännöt
  3. Yleisimmät virheet
  4. Kurssin yhteenveto
  5. Keskeiset asiat
  6. Testaa tietosi

Päivitetty 3. marraskuuta 2026. Perustuu xAI:n API-oppaaseen: max_completion_tokens rajoittaa vain näkyvää vastausta; päättelytokenit eivät sisälly tähän raja-arvoon, ja reasoning_effort ohjaa niiden määrää. Lähde: Chat Completions.

Yhteenveto ja suojakaiteet

Tämä viimeinen oppitunti käsittelee olennaisia parhaita käytäntöjä ja yleisimpiä virheitä kehotteita (prompts) laadittaessa Grokille. Käytä tätä tarkistuslistana aina, kun luot tai hienosäädät kehotetta.

Parhaat käytännöt

1. Jäsennä kehotteesi systemaattisesti

Erota aina konteksti, tehtävä ja rajoitteet toisistaan. Mallin on vaikeampi tulkita pelkkää tekstilohkoa kuin osioihin jaettua kehotetta.

2. Käytä järjestelmäviestiä pysyviin ohjeisiin

Sijoita kaikki jokaiseen vuorovaikutukseen sovellettavat asiat (kieli, muoto, sävy, rajoitteet) järjestelmäviestiin. Sijoita tilannesidonnaiset ohjeet käyttäjän viesteihin.

3. Anna esimerkkejä kuvausten sijaan

Kun tulosteen muoto on monimutkainen, yksi esimerkki on arvokkaampi kuin tuhat sanaa selitystä. Muutaman esimerkin sisältävä kehotus (few-shot prompting) on lähes aina tehokkaampi kuin odotetun muodon yksityiskohtainen selitys.

4. Valitse tehtävään sopiva malli

  • Yksinkertainen ja nopea tehtävä: grok-4.3 tai grok-build-0.1 (koodille)
  • Monimutkainen päättelytehtävä: grok-4.20-0309-reasoning korkealla ponnistelutasolla
  • Kuvien analyysi: grok-4.5 tarkkuusasetuksella (low/high)

5. Säädä lämpötila tavoitteen mukaan

  • Tiedon poiminta, luokittelu, faktat: lämpötila 0–0,3
  • Ammattimainen kirjoittaminen, yhteenveto: lämpötila 0,4–0,7
  • Ideointi, luovuus: lämpötila 0,8–1,5

6. Testaa seed-parametrilla

Kun haluat verrata objektiivisesti kahta kehotteen formulointia, käytä samaa seed-arvoa. Tämä poistaa satunnaisuudesta johtuvan vaihtelun ja antaa mitata muutoksesi vaikutuksen.

7. Rakenna kehotekirjasto

Säilytä parhaat kehotteesi käyttötapausten mukaan järjestetyssä kirjastossa. Hyvä kehotus on sijoitus: sen arvo kasvaa jokaisen uudelleenkäyttökerran myötä.

Yleisimmät virheet

Virhe 1: Epämääräiset kehotteet

Malli ei ole telepaattinen. Mitä tarkempi olet, sitä parempi tulos.

Virhe 2: Päättelymallien rajoitusten ignorointi

Grok-päättelymallit eivät tue tiettyjä parametreja: frequency_penalty, presence_penalty ja stop aiheuttavat virheen. Varaa monimutkaisille tehtäville 3 600 sekunnin aikakatkaisu.

Virhe 3: Historian muokkaaminen keskellä keskustelua

Grok-API on tilaton (stateless). Historian muokkaaminen rikkoo inferenssivälimuistin ja heikentää suorituskykyä.

Virhe 4: Lämpötilan ja top_p:n samanaikainen käyttö

Lämpötilan ja top_p:n muuttaminen yhtä aikaa tuottaa arvaamattomia tuloksia. Valitse jompikumpi.

Virhe 5: Päättelytokenien huomiotta jättäminen budjetissa

Päättelymalleissa päättelytokenit lisääntyvät näkyvän vastauksen lisäksi ja niistä veloitetaan tulostehinnalla, mutta max_completion_tokens ei rajoita niitä: se rajoittaa vain näkyvää vastausta. Hallitaksesi tätä kustannusta, aseta päättelyponnistelu (reasoning_effort) ja seuraa reasoning_tokens-arvoa käytössä.

Virhe 6: Tulostemuodon määrittämättömyys

Ilman muoto-ohjeita malli valitsee itse sopivaksi katsomansa muodon. Määritä aina odotettu muoto.

Virhe 7: Liian paljon epäoleellista kontekstia

xAI:n dokumentaatio suosittaa nimenomaisesti epäoleellisen tiedon jättämistä pois kontekstista.

Virhe 8: Historian tallentaminen kuvien kanssa

Käytä arvoa store: false kuvia sisältävissä pyynnöissä virheiden välttämiseksi.

Kurssin yhteenveto

Näiden 14 oppitunnin aikana olet oppinut:

  • Jäsentämään kehotteesi selkeästi kontekstin ja muodon kera (oppitunnit 1–4)
  • Hyödyntämään edistyneitä tekniikoita: few-shot, ajatusketju, järjestelmäohjeet, iterointi, multimodaalisuus (oppitunnit 5–9)
  • Soveltamaan kehotteita todellisiin esimerkkeihin: kirjoittaminen, analyysi, koodi (oppitunnit 10–12)
  • Rakentamaan asiantuntijakehotteita noudattamalla metodista prosessia (oppitunti 13)

Kehotteiden laatiminen on taito, joka kehittyy harjoittelulla. Jokainen hienosäätemäsi kehotus rikastuttaa kokemustasi ja uudelleenkäytettävien malliesimerkkiesi kirjastoa.

Keskeiset asiat

  • Jäsennä kehotteesi aina erillisiin osioihin
  • Sovita malli ja parametrit kuhunkin tehtävään
  • Anna esimerkkejä pitkien kuvausten sijaan
  • Vältä klassisia virheitä: yhteensopimattomat parametrit, muokattu historia, liiallinen konteksti
  • Dokumentoi ja käytä uudelleen parhaita kehotteitasi
  • Kehotteiden laatiminen on iteratiivista: testaa, diagnosoi, säädä

Testaa tietosi

Asiantuntijatyöpajan jälkeen viimeinen tarkistus Grok-kehottamistekniikoista.

1. Mikä on järjestelmäroolin tarkoitus verrattuna käyttäjä- ja avustajaroleihin?

Vastaus: Järjestelmärooli määrittää keskustelulle pysyvän kehyksen – identiteetin, säännöt, muodon – kun taas käyttäjä esittää pyynnöt ja avustaja antaa vastaukset: sovellusohjeita ei sekoiteta itse vuoropuheluun.

2. Milloin lämpötilaa kannattaa laskea?

Vastaus: Faktatehtävissä, tiedon poiminnassa ja koodissa, joissa vaihtelu on virhe; nosta sitä luovuutta vaativissa tehtävissä – asetus riippuu siitä, kuinka kalliiksi eri vastaus tulee jokaisella ajokerralla.

3. Mitä hyötyä on ajatusketjusta (chain of thought)?

Vastaus: Päättelytehtävissä vaiheiden pyytäminen ennen johtopäätöstä vähentää virheitä merkittävästi – malli purkaa tehtävän auki sen sijaan, että hyppäisi suoraan uskottavalta näyttävään vastaukseen.

4. Miten kehotetaan multimodaalisesti (teksti + kuva)?

Vastaus: Kehystä analyysi kuten tekstiäkin: tarkka kysymys, kriteerit, tulostemuoto – kuva on dataa, kehotus on menetelmä.

5. Nimeä kaksi vältettävää yleistä virhettä.

Vastaus: Kaikenkattavat pyynnöt ilman rakennetta tai muotoa sekä iteroinnin puute – ensimmäisen tuloksen hyväksyminen sen sijaan, että sitä hienosäädettäisiin; kurssin parhaat käytännöt ovat täsmälleen päinvastaisia.

Selkeä kehys, sovitut asetukset, iterointi: tekniikat tiivistyvät kolmeen liikkeeseen – työpaja antoi sinulle mahdollisuuden harjoitella niitä, ja projektisi korjaavat niistä satoon.