Jäsentele ohjeet

Johdanto

🎯 Oppimistavoitteet

• Ymmärtää, miksi jäsennellyt ohjeet tuottavat johdonmukaisempia tuloksia
• Osata käyttää erilaisia jäsentelytekniikoita (osiot, XML-tagit, hierarkiat)
• Tunnistaa yleiset rakennevirheet ja miten ne vältetään
• Soveltaa rakenneperiaatteita omaan järjestelmäpromptiin

Osiossa 2 opit viisi peruspilaria – MITÄ, MIKSI, MITEN, KUKA ja SÄVY. Nyt viedään se askel pidemmälle, sillä vaikka kaikki oikeat komponentit olisivat paikallaan, ne voivat helposti muuttua sekaviksi, jos niitä ei organisoida oikein. Rakenne ei ole esteettinen valinta – se on perustavanlaatuinen osa tekoälyn luotettavaa ja johdonmukaista toimintaa.

Tässä osiossa opit kolme konkreettista jäsentelytekniikkaa, yleisimmät vältettävät virheet ja tarkistuslistan, jonka voit käyttää suoraan omiin prompteihin.

Aloita ymmärtämällä, mitä rakenne todella tekee promptille – ja miksi sillä on merkitystä.

Mitä merkitystä rakenteella on promptauksessa?

Ajattele eroa hyvin pakatun matkalaukun ja sellaisen välillä, johon kaikki on vain heitetty sisään. Sisältö on sama, mutta rakenne ratkaisee, löydätkö nopeasti sen, mitä tarvitset – vai pitääkö kaivaa läpi kaikki.

Tekoälymalleille pätee täsmälleen sama periaate: hyvin jäsennelty prompt auttaa mallia nopeasti tunnistamaan, mikä on tärkeää, mitkä säännöt pätevät ja miten eri osat liittyvät toisiinsa. Jäsentämätön prompt jättää mallin arvailemaan – ja arvailut johtavat epäjohdonmukaisiin tuloksiin.

On kolme konkreettista syytä, miksi rakenne tekee eron käytännössä – ja ne vaikuttavat suoraan siihen, miten tekoäly tulkitsee ja noudattaa ohjeita.

Kolme syytä miksi rakenne on ratkaisevaa

1. Malli tietää, mistä etsiä

Kun tiedot on jaettu selkeisiin osioihin, mallin ei tarvitse arvata, mikä on ohje, esimerkki tai taustatietoa. Tämä vähentää väärinkäsityksiä huomattavasti.

2. Saat johdonmukaisia tuloksia

Kaoottinen prompt voi tuottaa erilaisia vastauksia joka kerta – jopa samalla syötteellä. Rakenne luo ennustettavuuden ja luotettavuuden, mikä on kriittistä, kun rakennat jotain käytännölliseen käyttöön.

3. Helpompi ylläpitää ja kehittää

Kun sinä tai joku muu tiimistä haluaa myöhemmin päivittää promptia, se on huomattavasti helpompaa, kun kaikella on paikkansa. Tiedät heti, mistä säätää sääntöjä, lisätä esimerkkejä tai muuttaa sävyä.

Nyt kun tiedät, miksi rakenne on ratkaisevaa, katsotaan kolmea konkreettista tekniikkaa, joita voit alkaa käyttää heti – riippumatta siitä, kuinka yksinkertainen tai monimutkainen promptisi on.

Jäsentelytekniikat, joita voit käyttää heti

Tekniikka 1: Selkeät osiot otsikoimalla

Yksinkertaisin jäsentelymenetelmä on jakaa promptisi nimettyihin osioihin. Se toimii erinomaisesti useimmissa käyttötapauksissa ja vastaa suoraan osion 2 viiteen perusteeseen.

## ROOLI
Olet kokenut ja pedagoginen IT-tukihenkilö, joka työskentelee
keskisuuressa yrityksessä.

## TEHTÄVÄ
Päätehtäväsi on vastata työntekijöiden IT-kysymyksiin ja opastaa
heitä askel askeleelta ratkaisujen löytämisessä.

## TARKOITUS
Tavoitteena on vähentää IT-tuen kuormitusta ja antaa työntekijöille
nopeaa apua toistuvissa ongelmissa.

## SÄÄNNÖT
- Vastaa aina suomeksi
- Käytä enintään 150 sanaa vastauksessasi
- Jos et tiedä vastausta, kirjoita: "Minulla ei ole tietoa tästä.
  Ota yhteyttä IT-tukeen osoitteessa support@yritys.fi"
- Sisällytä aina lähdeviite, kun viittaat sisäisiin ohjeisiin

## SÄVY
Ole ystävällinen, ammatillinen ja rohkaiseva. Vältä teknistä jargonia,
ellei se ole välttämätöntä.

Jokaisella osiolla on selkeä tarkoitus, ja malli voi helposti erottaa sen, mitä sen pitää tehdä (TEHTÄVÄ), ja miten sen pitää tehdä se (SÄÄNNÖT + SÄVY).

Tekniikka 2: XML-tagit monimutkaiseen jäsentelyyn

Kun ohjeesi muuttuvat kehittyneemmiksi – erityisesti jos sinulla on paljon esimerkkejä, pitkiä listoja tai hierarkkista tietoa – XML-tagit voivat tehdä suuren eron. Anthropic suosittelee tätä erityisesti Claude-malleille.

Ajattele XML-tageja laatikoiden etiketteiksi. Aivan kuten kirjoitat “KEITTIÖLASIT – HAURAS” pahvilaatikkoon pakattaessa, XML-tagit nimeävät asiat niin, että sekä ihmiset että mallit tietävät, mitä sisällä on:

<reseptikirja>
  <resepti>
    <nimi>Pannukakut</nimi>
    <ainekset>
      <ainesosa>Vehnäjauhot</ainesosa>
      <ainesosa>Munat</ainesosa>
    </ainekset>
  </resepti>
</reseptikirja>

Jokainen <tagi> avaa laatikon ja </tagi> sulkee sen – voit rakentaa laatikoiden hierarkioita, aivan kuten sukupuussa.

XML:n edut

• Selkeämmät rajat eri osioiden välille
• Helpompi mallille erottaa ohjeet ja sisältö toisistaan
• Parempi pitkään kontekstiin ja monimutkaisiin tehtäviin

Esimerkki järjestelmäpromptiista XML-tageilla

<role>
Olet kokenut HR-asiantuntija, jolla on asiantuntemusta Suomen
työoikeudesta.
</role>

<task>
Vastaa kysymyksiin yrityksen HR-käytännöistä ja anna ohjeistusta
työoikeudellisissa asioissa.
</task>

<constraints>
- Älä koskaan anna juridisia neuvoja – ohjaa ammattiliittoon tai
  lakimiehelle monimutkaisissa tapauksissa
- Viittaa aina oikeaan käytäntödokumenttiin sivunumeroineen
- Vastaa enintään 200 sanalla
- Jos tietoa ei löydy: "Ota yhteyttä suoraan HR-osastoon tästä asiasta"
</constraints>

<examples>
<example>
Käyttäjä: "Kuinka monta lomapäivää minulla on oikeus?"
Assistentti: "Yrityksen lomakäytännön mukaan (s. 3) kokoaikaisilla
työntekijöillä on oikeus 25 lomapäivään vuodessa. Ota yhteyttä
HR:ään osoitteessa hr@yritys.fi tarkistaaksesi oman lomaoikeutesi."
</example>
</examples>

<tone>
Ammatillinen, ystävällinen ja tukeva. Käytä selkeää kieltä, joka
tekee työoikeudellisista asioista ymmärrettäviä.
</tone>

Milloin käyttää XML-tageja?

• Kun sinulla on enemmän kuin 3 esimerkkiä
• Kun käsittelet pitkää kontekstia (dokumentteja, datataulukoita jne.)
• Kun rakennat monimutkaisia assistentteja useilla työkaluilla
• Kun haluat olla erityisen selkeä siitä, mikä on ohjeita vs. dataa

Tekniikka 3: Hierarkkinen organisointi monimutkaisille assistenteille

Kehittyneemmissä käyttötapauksissa saatat tarvita hierarkioita, joissa jotkut ohjeet ovat tärkeämpiä kuin toiset.

Priorisointiperiaate (Google ja Anthropic)

• Sijoita kriittisimmät ohjeet myöhäiseen vaiheeseen promptissa
• Kielteiset rajoitukset (“älä TEE X”) pitää sijoittaa loppuun
• Tärkeät muotosäännöt pitää toistaa lähellä loppua

## YLEINEN ROOLI
Olet tekoälyassistentti asiakaspalveluun verkkokaupassa.

## ENSISIJAISET TEHTÄVÄT
1. Vastaa kysymyksiin tilauksen tilasta, toimituksista ja palautuksista
2. Auta asiakkaita tilitiedoissa
3. Eskaloi monimutkaiset tapaukset ihmistuelle

## TOISSIJAISET TEHTÄVÄT
- Anna tuotesuosituksia pyydettäessä
- Tiedota käynnissä olevista kampanjoista

## KRIITTISET TURVASÄÄNNÖT (noudata aina näitä)
❌ ÄLÄ KOSKAAN jaa täydellisiä korttinumeroita tai salasanoja
❌ ÄLÄ KOSKAAN muuta toimitusosoitteita ilman sähköpostivahvistusta
❌ ÄLÄ KOSKAAN tee palautuksia yli 500 € ilman hyväksyntää
✅ Epäilyttävän petoksen sattuessa → pysäytä heti ja eskaloi

## TÄRKEÄÄ: Prioriteettijärjestys konfliktitilanteessa
Jos olet epävarma, priorisoi turvasäännöt aina nopean palvelun edelle.

Turvasäännöt on merkitty kriittisiksi, sijoitettu myöhäiseen vaiheeseen promptissa, ja visuaaliset symbolit (❌ ✅) tekevät rajoituksista erityisen selkeitä.

Oikeiden tekniikoiden tunteminen on yksi asia – yleisimpien sudenkuoppien välttäminen on toinen. Tässä kolme yleisintä virhettä.

Yleiset rakennevirheet – ja miten välttää ne

Virhe 1: Kaikki yhdessä tekstimöykyssä

❌ Vältä:

Olet asiakastukiassistentti, jonka pitää auttaa käyttäjiä tuotteisiin liittyvissä
kysymyksissä ja sinun pitää olla ystävällinen ja vastata lyhyesti ja jos et tiedä
vastausta sinun pitää sanoa se ja sinun pitää aina kysyä, tarvitseeko käyttäjä
lisää apua...

✅ Parempi: Jaa selkeisiin osioihin (ROOLI, TEHTÄVÄ, SÄÄNNÖT, SÄVY) yllä olevan Tekniikan 1 mukaisesti.

Virhe 2: Ohjeet sekoitettuna esimerkkeihin

❌ Vältä:

Sinun pitää luokitella asiakassähköpostit. Esimerkiksi "Haluaisin palauttaa
tilaukseni" pitää luokitella Palautukseksi ja sinun pitää olla tiivis ja jos
kyseessä on toimitus pitää luokitella Toimitus ja vastaa aina vain kategorialla.

✅ Parempi:

## TEHTÄVÄ
Luokittele saapuvat asiakassähköpostit oikeaan kategoriaan.

## KATEGORIAT
- Palautus
- Toimitus
- Tuotekysymykset
- Tekninen tuki
- Muu

## ESIMERKIT
Sähköposti: "Haluaisin palauttaa tilaukseni"
Kategoria: Palautus

Sähköposti: "Milloin pakettini tulee?"
Kategoria: Toimitus

## MUOTO
Vastaa vain kategorian nimellä, ei mitään muuta.

Virhe 3: Tärkeät rajoitukset varhaisessa vaiheessa promptissa

Mallit voivat “unohtaa” tärkeät rajoitukset, jos ne sijoitetaan liian varhain – erityisesti kielteiset ohjeet.

❌ Vältä (huono sijoittelu):

ÄLÄ KOSKAAN muuta käyttäjätietoja ilman hyväksyntää.

[... 300 sanaa muita ohjeita ...]

Auta nyt käyttäjää hänen pyynnöllään.

✅ Parempi (kriittiset säännöt lopussa):

[... muut ohjeet ...]

## KRIITTISTÄ: Turvasäännöt (noudata aina)
- ÄLÄ KOSKAAN muuta käyttäjätietoja ilman nimenomaista hyväksyntää
- ÄLÄ KOSKAAN jaa arkaluonteisia tietoja luvattomille

Käy aina järjestelmäprompisi läpi tämän tarkistuslistan avulla ennen kuin otat sen käyttöön – se auttaa sinua arvioimaan, pitääkö rakenne todella.

Tarkistuslista: onko promptissasi hyvä rakenne?

Käytä tätä tarkistuslistaa sitä mukaa kuin rakennat ja parannat järjestelmäpromptia:

✅ Onko minulla selkeät osiot? (Rooli, Tehtävä, Säännöt jne.)

✅ Ovatko esimerkit erillään ohjeista?

✅ Ovatko tärkeimmät rajoitukseni sijoitettu myöhäiseen vaiheeseen promptissa?

✅ Pystyykö joku muu lukemaan ja ymmärtämään promptini 30 sekunnissa?

✅ Ovatko kielteiset ohjeet (“älä TEE”) selkeästi merkitty?

✅ Käytänkö XML-tageja, jos minulla on monimutkainen konteksti tai paljon esimerkkejä?

Jos voit vastata kyllä vähintään 4:ään 6:sta kohdasta, olet oikealla tiellä!

Yhteenveto

Rakenne ei ole vain “siistejä muotoiluja” – se on perustavanlaatuinen osa tekoälyn luotettavaa toimintaa. Tässä neljä tärkeintä oivallusta, jotka otat mukanasi.

• Selkeät osiot tekevät mallille helpoksi löytää oikea tieto ja vähentävät väärinkäsitysten riskiä huomattavasti.
• XML-tagit auttavat monimutkaisessa kontekstissa ja monissa esimerkeissä – ne luovat selkeät rajat, joissa malli voi navigoida turvallisesti.
• Hierarkkinen priorisointi varmistaa, että tärkeät säännöt noudatetaan ja ensisijaiset tehtävät eivät huku kriittisten rajoitusten alle.
• Kriittiset ohjeet lopussa estävät mallia “unohtamasta” niitä – sijoita aina kielteiset rajoitukset ja turvasäännöt myöhäiseen vaiheeseen promptissa.

Testaa tietosi

5 kysymystä · 100 % oikein läpäistäksesi · Tarkista vastaukset lopussa

Aloita tietovisa →