Promptauksen peruskurssi · 4 min lukuaika

Jäsentele ohjeet

Opi järjestämään promptit osioilla, XML-tageilla ja hierarkkisella priorisoinnilla johdonmukaisempien ja luotettavampien tulosten saamiseksi.

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ä.

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

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.

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ä.

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.

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

Kysymys 1/5

Miksi rakenne on tärkeää järjestelmäprompteissa?

Se saa promptin näyttämään ammattimaiselta
Se auttaa mallia nopeasti tunnistamaan, mikä on ohjeita, esimerkkejä ja rajoituksia
Se vaaditaan teknisesti, jotta tekoäly toimii
Se tekee promptista pidemmän ja yksityiskohtaisemman

Jäsentele ohjeet

Johdanto

1. Malli tietää, mistä etsiä

2. Saat johdonmukaisia tuloksia

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