Oman botin rakentaminen houkuttelee aloittamaan järjestelmäpromptista: kirjoitetaan botille rooli, muutama sääntö ja kokeillaan, mitä tapahtuu. Silloin tärkeimmät päätökset jäävät helposti tekemättä. Kenelle botti on tarkoitettu? Mitä käyttäjä yrittää saada aikaan? Missä tilanteessa botti auttaa — ja missä sen pitää lopettaa?
Tällä tunnilla et rakenna bottia etkä kirjoita valmista järjestelmäpromptia. Laadit määrittelydokumentin, jonka perusteella botin voisi myöhemmin rakentaa myös joku toinen. Suunnittelu erotetaan toteutuksesta tarkoituksella: ensin päätetään, millainen työkalu tarvitaan, vasta sitten kirjoitetaan ohjeet ja valitaan alusta.
Määrittely on lupaus tulevasta toiminnasta. Se kertoo, ketä autetaan, missä tehtävässä ja millä rajoilla. Kun nämä päätökset ovat näkyvissä, myöhempää bottia voidaan arvioida muullakin kuin kysymyksellä ”vaikuttaako tämä hyvältä?”. Ilman määrittelyä jokainen sujuva vastaus voi näyttää onnistumiselta, vaikka botti ratkaisisi väärää ongelmaa.
Tunnin ydinkysymys: Mitä botin pitää auttaa tiettyä käyttäjää tekemään — ja mistä huomaat, että tehtävä onnistui?
Hyvä botti ratkaisee rajatun ongelman rajatussa tilanteessa. ”Opiskelubotti” on liian laaja lähtökohta. ”Kertauskaveri, joka auttaa ensimmäisen vuoden opiskelijaa tunnistamaan tietoverkkojen keskeiset käsitteet ennen koetta” kertoo jo käyttäjän, tilanteen ja tavoitteen.
Kuvaa käyttötapaus yhdellä virkkeellä:
[Käyttäjä] tarvitsee apua [tehtävässä], jotta hän voi [saavutettava lopputulos].
Esimerkiksi:
Kerhon uusi jäsen tarvitsee apua sääntöjen ja harjoitusaikojen löytämisessä, jotta hän osaa tulla ensimmäisiin harjoituksiinsa valmistautuneena.
Tämä virke toimii koko suunnitelman mittatikkuna. Jos myöhempi ominaisuus ei auta käyttäjää tässä tehtävässä, sitä ei ehkä tarvita.
Kerhon perehdytysbotissa tämä rajaus sulkee pois esimerkiksi yleisen harjoitusohjelman laatimisen ja henkilökohtaisen terveysneuvonnan. Ne voivat liittyä harrastukseen, mutta eivät uuden jäsenen tehtävään löytää säännöt, harjoitusaika ja ensimmäisen kerran valmistautumisohjeet. Rajaus pitää botin tietopohjan, keskustelun ja vastuun hallittavina.
”Botti auttaa hyvin” ei ole vielä arvioitava tavoite. Onnistuminen pitää kuvata niin, että sen voi myöhemmin testata.
Havaittava onnistuminen voi tarkoittaa esimerkiksi sitä, että:
Kun onnistuminen on havaittava, Oma botti II -tunnilla voidaan kirjoittaa sitä koskevat testit ja tunneilla 17–18 voidaan tarkistaa, toteutuuko se oikeassa botissa.
Havaittava tavoite muuttaa myös keskustelun suunnittelua. Jos onnistuminen tarkoittaa, että uusi jäsen löytää oikean harjoitusajan ja seuraavan askeleen, botin pitää joko antaa nämä tiedot hyväksytystä lähteestä tai kertoa avoimesti, ettei lähde kata kysymystä. Pelkkä ystävällinen keskustelu ei silloin vielä riitä onnistumiseksi.
Botin työnkulku tarkoittaa tässä keskustelun loogista etenemistä, ei vielä teknistä automaatiota. Kirjoita 4–6 vaihetta, jotka kuvaavat käyttäjän matkan alusta hyödylliseen lopputulokseen.
Kertauskaverin eteneminen voisi olla:
Vaiheet eivät vielä ole järjestelmäprompti. Ne ovat vaatimus sille, mitä myöhemmän järjestelmäpromptin ja käyttöliittymän pitää saada aikaan.
Järjestys kertoo myös, milloin botti ei vielä voi vastata. Kertauskaveri ei esimerkiksi voi valita sopivaa harjoituskysymystä ennen kuin aihe ja lähtötaso ovat selvillä. Työnkulun tehtävä ei siis ole vain järjestää tekstiä siistiksi, vaan tehdä tarvittavat päätökset näkyviksi ennen toteutusta.
Rooli kertoo, mistä näkökulmasta botti auttaa. Persoona ja äänensävy kertovat, miltä vuorovaikutus tuntuu.
”Olet ystävällinen apuri” kuvaa lähinnä sävyä. ”Olet uusien jäsenten perehdyttäjä, joka käyttää vain kerhon hyväksyttyjä sääntöjä ja harjoitusaikoja” kertoo tehtävän, tiedollisen perustan ja vastuun.
Valitse ensin asiallinen rooli. Lisää sen jälkeen tehtävään sopiva viestintätapa:
Persoona ei korvaa asiantuntemusta, lähteitä tai rajoja. Se auttaa tekemään botin toiminnasta johdonmukaista ja käyttäjälle sopivaa.
Kerhon botin rooli voi olla ”uuden jäsenen perehdyttäjä, joka käyttää hyväksyttyjä sääntöjä ja aikatauluja”. Sen sävy voi olla rauhallinen, lämmin ja tiivis. Jos sävy poistetaan, tehtävä säilyy. Jos rooli ja lähdepohja poistetaan, jäljelle jää vain miellyttävästi kirjoittava yleisbotti.
Rajaus ei ole luettelo kaikesta pahasta. Hyvä rajaus liittyy käyttötapaukseen ja kertoo myös, mitä botti tekee rajan tullessa vastaan.
Kirjoita rajat kolmesta suunnasta:
Pelkkä ”älä vastaa aiheen ulkopuolelle” jättää käyttäjän tyhjän päälle. Parempi ohje on: ”Jos kysymys ei koske kerhon toimintaa, kerro rajaus yhdellä lauseella ja ohjaa käyttäjä kerhon yhteyshenkilölle.”
Käyttäjän näkökulmasta raja on osa palvelua. Jos hän kysyy vamman hoitamisesta, botti ei vain vaikene tai toista kieltoa. Se kertoo, ettei anna terveysneuvontaa, ja ohjaa käyttäjän asianmukaiseen apuun. Hyvä raja siis yhdistää kolme asiaa: ehdon, botin toiminnan ja turvallisen seuraavan askeleen.
Määrittely paljastaa, mitä botin pitää tietää. Kerhon perehdytysbotti saattaa tarvita säännöt, harjoitusajat, varusteluettelon ja yhteystiedot. Se ei tarvitse koko kerhon vuosikertomusta vain siksi, että dokumentti liittyy samaan organisaatioon.
Kirjaa määrittelyyn alustava luettelo tietotarpeista. Oma botti II -tunnilla etsit niihin sopivat lähteet ja arvioit, mitä aineisto kattaa ja mitä ei.
Tietotarpeet seuraavat suoraan käyttäjän etenemisestä. Jos botin pitää kertoa harjoitusaika, varusteet ja yhteyshenkilö, jokaiselle tiedolle tarvitaan myöhemmin nimetty ja ajantasainen lähde. Jos määrittelyssä luvataan jotakin, jolle ei löydy luotettavaa tietopohjaa, lupausta pitää rajata ennen rakentamista.
Hyvä määrittely vastaa kuuteen kysymykseen:
| Päätös | Kysymys |
|---|---|
| Käyttäjä | Kuka tarvitsee apua ja missä tilanteessa? |
| Tehtävä | Mitä käyttäjä yrittää saada aikaan? |
| Onnistuminen | Mitä havaittavaa tapahtuu, kun botti auttaa oikein? |
| Eteneminen | Missä järjestyksessä botti ohjaa käyttäjää? |
| Rooli ja sävy | Millaisena asiantuntijana ja millä tavalla botti viestii? |
| Rajat | Mitä botti ei tee, ja miten se toimii rajan tullessa vastaan? |
Näiden päätösten jälkeen järjestelmäpromptin kirjoittaminen on myöhemmin muuntamista, ei arvailua. Apuri-botin rakennustunnilla kokoat määrittelyn, promptikortin toimivan rakenteen ja tietopohjan yhdeksi toteutukseksi.
Lue taulukkoa päätösketjuna, ei kuutena irrallisena kenttänä. Käyttäjän tilanne määrittää tehtävän, tehtävä määrittää onnistumisen, onnistuminen ohjaa keskustelun etenemistä ja rajat kertovat, milloin vastuu siirtyy botilta ihmiselle. Rooli ja sävy tukevat tätä kokonaisuutta, mutta eivät muuta sen tarkoitusta.
Tällä tunnilla suunnittelet ennen rakentamista. Rajaat käyttäjän, tehtävän, havaittavan onnistumisen, keskustelun etenemisen, roolin, äänensävyn ja toiminnan rajat. Et vielä kirjoita valmista järjestelmäpromptia tai testaa omaa bottia.
Tunnin tuotoksena syntyy rakennuspalikka 2: botin määrittelydokumentti. Se kertoo, mitä Apuri-botin rakennustunnilla rakennetaan ja millä perusteella toteutusta myöhemmin arvioidaan.
Lopuksi pohdittavaksi: Voisiko toinen ihminen rakentaa määrittelysi perusteella saman botin kuin sinä? Jos ei, mikä päätös on vielä vain omassa päässäsi?
Tarkistettu 20.7.2026.
Tämä on toinen kolmesta rakennuspalikasta. Keräät rakennuspalikat Tekoälyjen käyttö -osion aikana. Apuri-botin rakennustunnilla rakennat niiden avulla apuri-botin valitsemallasi alustalla, ja Apuri-botin viimeistelytunnilla korjaat sekä arvioit toteutuksen. Säilytä työ huolellisesti.
Suunnittelet bottisi määrittelydokumentin. Se on botin perustamisasiakirja, jossa kerrot, kenelle botti on tarkoitettu, mitä se tekee, miten se käyttäytyy ja mitä se ei tee.
Tämä on ensimmäinen rakennuspalikka, jossa suunnittelet suoraan tulevaa bottiasi. Aiemmin keräsit yleisiä promptirakenteita. Nyt suunnittelet juuri sitä bottia, jonka rakennat oppitunneilla 17–18.
Et vielä kirjoita järjestelmäpromptia, rakenna bottia tai testaa sitä. Tässä tehtävässä suunnittelet botin toiminnan etukäteen. Ajattele tätä pohjapiirroksena: hyvä suunnitelma helpottaa botin rakentamista myöhemmin.
Määrittelyn osat liittyvät toisiinsa. Käyttäjä ja hänen tilanteensa ratkaisevat tehtävän. Tehtävästä seuraa havaittava onnistuminen, ja onnistuminen määrää, millainen keskustelun eteneminen tarvitaan. Rajat puolestaan kertovat, milloin botti ei voi viedä käyttäjää turvallisesti eteenpäin omin voimin.
Tehtävän jälkeen sinulla on selkeä määrittelydokumentti, jonka avulla osaat myöhemmin rakentaa botin valitsemallasi alustalla. Dokumentti auttaa sinua päättämään:
Tavoitteena ei ole täyttää mahdollisimman monta kenttää, vaan muodostaa yksi johdonmukainen kuva tulevasta botista. Jos työnkulku lupaa jotakin, jota tarkoitus ei vaadi, tai rajat estävät ydintehtävän kokonaan, palaa aiempaan päätökseen ja korjaa ristiriita.
Tallenna lopuksi yksi dokumentti, jossa on:
Säilytä myös ensimmäinen versio tai merkitse muutokset näkyviin. Lopullinen määrittely kertoo, mitä aiot rakentaa. Muutosjälki kertoo, mitä palautteen avulla havaitsit ja minkä päätöksen teit itse.
Botti, jonka rakennat myöhemmin, on sinun itse valitsemasi apuri-botti: se auttaa sinua tai kavereitasi jossakin sinulle tutussa arjen aiheessa. Valitse ensin, mihin aiheeseen ja mitä tehtävää varten botti rakennetaan.
Valitse itseäsi kiinnostava, omasta arjestasi tuttu aihe. Esimerkkejä:
Rajaa aihe heti käyttäjän tilanteeksi. ”Opiskelubotti” voi muuttua esimerkiksi kertauskaveriksi, joka auttaa ensimmäisen vuoden opiskelijaa tunnistamaan yhden kurssin keskeiset käsitteet ennen koetta. Jälkimmäisestä voidaan jo päätellä, mitä botin pitää kysyä, millaista aineistoa se tarvitsee ja mistä onnistuminen näkyy.
Tallenna: Kirjoita valitsemasi aihe muistiin. Lisää myös yksi lause siitä, missä tilanteessa ja kenelle tällainen apuri-botti olisi hyödyllinen.
Täytä alla oleva taulukko. Kirjoita jokaiseen kohtaan lyhyt mutta selkeä vastaus. Tämä taulukko on bottisi suunnittelun perusta: sen myöhempi käyttäytyminen rakentuu näiden valintojen varaan.
Vinkki: Kirjoita mieluummin konkreettisesti kuin yleisesti. Esimerkiksi "auttaa kerhon uutta jäsentä löytämään vastaukset yleisimpiin kysymyksiin" on parempi kuin "auttaa harrastuksessa".
Täytä taulukko ylhäältä alas ja lue se sen jälkeen kokonaisena kertomuksena käyttäjän matkasta. Kohderyhmä perustelee tarkoituksen, tarkoitus ohjaa työnkulkua ja työnkulku tekee rajat näkyviksi. Jos yhteys katkeaa, älä paikkaa sitä uusilla ominaisuuksilla, vaan tarkenna aiempaa päätöstä.
| Osa | Mitä siihen kirjoitetaan? | Oma vastauksesi |
|---|---|---|
| Botin nimi | Anna botille nimi, joka kertoo selvästi, mitä botti tekee. Nimen ei tarvitse olla nokkela, vaan ymmärrettävä. Esimerkiksi "Kokeisiin valmistautumisen apuri" tai "Kerhon FAQ-botti". | |
| Kohderyhmä | Kenelle botti on tarkoitettu? Onko käyttäjä aloittelija vai kokeneempi? Onko hän opiskelija, harrastaja tai palvelun käyttäjä? Esimerkiksi: "Lukiolainen, joka tarvitsee tukea kokeisiin kertaamisessa." | |
| Tarkoitus | Mitä konkreettista botti auttaa käyttäjää tekemään? Kirjoita 1–2 lausetta. Esimerkiksi: "Botti auttaa käyttäjää valmistautumaan kokeeseen käymällä läpi keskeiset käsitteet, esittämällä harjoituskysymyksiä ja antamalla palautetta vastauksista." | |
| Persoona ja äänensävy | Millainen botti on luonteeltaan? Miten se puhuu käyttäjälle? Esimerkiksi: "Kannustava harjoittelukaveri, joka kysyy tarkentavia kysymyksiä. Puhuu rennosti mutta selkeästi. Ei käytä turhaa jargonia eikä ole liian leikkisä." | |
| Työnkulku | Missä järjestyksessä botti ohjaa käyttäjää? Kirjoita 5–7 vaiheen runko. Voit käyttää pohjana rakennetta: aiheen valinta → lähtötaso → keskeiset käsitteet → harjoituskysymykset → palaute → seuraava askel. Muokkaa rakennetta oman aiheesi mukaan. | |
| Rajat — mitä botti ei tee | Listaa 3–5 asiaa, joita botti ei saa tehdä. Esimerkiksi: "Botti ei tee tehtäviä käyttäjän puolesta. Botti ei anna lääketieteellisiä tai oikeudellisia neuvoja. Botti ei keksi faktoja, joita se ei tiedä. Botti ei käsittele oman aiheensa ulkopuolisia asioita." Rajat tekevät botista luotettavamman. |
Esimerkiksi kerhon perehdytysbotin kokonaisuus voi edetä näin: uusi jäsen kysyy ensimmäisestä harjoituksesta, botti tarkistaa aiheen ja tarvittavan lähtötiedon, hakee harjoitusajan hyväksytystä aineistosta ja kertoo varusteet sekä seuraavan askeleen. Jos ajantasainen aika puuttuu, botti kertoo puutteen ja ohjaa nimetylle yhteyshenkilölle. Tässä tarkoitus, työnkulku, tietotarve ja raja tukevat samaa käyttäjän tehtävää.
Avaa käytössäsi oleva hyväksytty tekoälypalvelu ja anna sille koko määrittelydokumenttisi. Pyydä tekoälyä haastamaan suunnitelmaasi. Tarkoitus ei ole, että tekoäly suunnittelee botin puolestasi, vaan että se auttaa huomaamaan puutteita ja epäselvyyksiä.
Voit käyttää esimerkiksi seuraavaa promptia:
"Toimit minulle sparrauskumppanina. Suunnittelen apuri-bottia, joka auttaa käyttäjää valitsemassani arjen aiheessa. Tässä bottini määrittelydokumentti: [liitä koko taulukkosi tähän] Haasta suunnitelmaani. Pohdi erityisesti: Onko botin tarkoitus tarpeeksi konkreettinen vai jääkö se liian yleiseksi? Onko kohderyhmä riittävän tarkasti rajattu? Puuttuuko työnkulusta jokin tyypillinen vaihe tässä aiheessa? Ovatko botin rajat realistisia vai liian tiukkoja tai liian löysiä? Mikä on yksi sokea piste, jota en ehkä vielä huomaa? Älä kirjoita uutta versiota puolestani. Anna 2–3 konkreettista parannusehdotusta, joiden pohjalta voin tehdä omat muutokseni."
Tämä on harjoitus siitä, miten tekoälyä käytetään suunnittelukumppanina. Et anna sen päättää puolestasi, mutta annat sen kyseenalaistaa suunnitelmasi.
Lue palaute kysymyksinä omalle suunnitelmallesi, älä korjauslistana. Tekoäly ei tunne yhteisösi käytäntöjä eikä käyttäjän todellista tilannetta. Hyvä muutos syntyy vasta, kun pystyt yhdistämään ehdotuksen määrittelyn ristiriitaan, puuttuvaan tietoon tai epäselvään rajaan.
Tee tekoälyn palautteen pohjalta tarvittavat korjaukset. Viimeistele määrittelydokumentti niin, että sen perusteella voisi rakentaa botin myös toinen henkilö, ei vain sinä itse.
Merkitse vähintään yksi muutos ja sen peruste. Jos et muuta mitään, kirjoita, minkä palautteen tarkistit ja miksi alkuperäinen ratkaisu säilyi. Myös ennallaan pitäminen on päätös, kun se perustuu määrittelyn tavoitteeseen eikä siihen, että palaute jätettiin lukematta.
Tarkista viimeistelyssä erityisesti nämä asiat:
Kirjoita lopuksi 2–3 lauseen pohdinta: "Mikä määrittelyssä muuttui sparrauksen jälkeen? Mikä on bottini ydin yhdellä lauseella?"
Ydinlauseessa ei tarvitse luetella kaikkia ominaisuuksia. Sen pitää kertoa käyttäjä, tehtävä ja hyödyllinen lopputulos niin selvästi, että voit käyttää lausetta seuraavilla tunneilla jokaisen lähteen, testin ja toteutusvalinnan mittatikkuna.
Miksi tämä on tärkeää: Apuri-botin rakennustunnilla aloitat botin rakentamisen valitsemallasi alustalla. Määrittely kertoo, mitä järjestelmäpromptiin pitää kirjoittaa, millaista tietopohjaa botti tarvitsee ja milloin se on valmis ensimmäiseen testiin.
Tarkista lopuksi: Olet valinnut apuri-bottisi aiheen, täyttänyt botin määrittelydokumentin, haastanut suunnitelmasi tekoälyn avulla, viimeistellyt dokumentin ja kirjoittanut 2–3 lauseen pohdinnan bottisi ytimestä.
2 / 3 rakennuspalikkaa kerätty
Harjoittelet tarvetta, käyttäjää, tehtävää ja rajoja. Et vielä kirjoita valmista järjestelmäpromptia tai testaa toteutusta.
| Käsite | Selitys |
|---|---|
| Apuri-botti | Rajattuun käyttäjän tehtävään määritelty tekoälyavustin. |
| Kohderyhmä | Käyttäjäryhmä, jonka tilanne, lähtötaso ja tarve ohjaavat suunnittelua. |
| Käyttötapaus | Konkreettinen tilanne, jossa käyttäjä yrittää saada tietyn asian tehdyksi. |
| Havaittava onnistuminen | Tulos tai toiminta, josta voidaan tarkistaa, että botti auttoi tehtävässä. |
| Työnkulku | Vaiheet, joiden kautta botti ohjaa käyttäjää lähtötilanteesta lopputulokseen. |
| Rooli | Botin tehtävään liittyvä näkökulma ja vastuu, ei pelkkä kuvitteellinen persoona. |
| Äänensävy | Tapa, jolla botti viestii kohderyhmälle. Sävy ei korvaa tehtävää, tietopohjaa tai rajoja. |
| Raja | Ehto, jossa botti kieltäytyy, pyytää lisätietoa tai siirtää vastuun ihmiselle. |
| Määrittelydokumentti | Ennen toteutusta laadittu kuvaus käyttäjästä, tehtävästä, onnistumisesta, työnkulusta ja rajoista. |
| Järjestelmäprompti | Toteutusvaiheessa kirjoitettava pysyvä ohje, joka muuntaa määrittelyn botin toimintasäännöiksi. |