Tämän oppitunnin tavoitteena on siirtyä agenttien teoriasta testattavaan minimiversioon. Opiskelija voi valita teknisen n8n-polun tai dokumentoidun suunnittelupolun. Molemmissa hän tekee todellisen kielimallikutsun, jossa malli valitsee tilanteen perusteella vähintään kahdesta sallitusta vaihtoehdosta.
Opettajan painotus: Korosta, että tämän oppitunnin tärkein tavoite ei ole rakentaa mahdollisimman monimutkaista työnkulkua, vaan osoittaa kielimallin ja agentin ohjauskehyksen vastuunjako. Tekninen ja dokumentoitu polku tuottavat erilaista näyttöä, eikä suunnitelmaa saa esittää todisteena testaamattoman liitännän toimivuudesta.
Aloita oppitunti sanomalla opiskelijoille:
Tähän mennessä olemme puhuneet agentin arkkitehtuurista teoriassa. Nyt teemme siitä testattavan kokonaisuuden. Tekninen polku näyttää vastuut n8n:n solmuina, sääntöinä ja yhteyksinä. Dokumentoitu polku näyttää ne kaaviona, sopimuksina ja suoritusjälkinä. Kuusi rakennusosaa auttaa tarkistamaan kattavuuden, mutta ne eivät määrää vaiheiden määrää.
Tämä auttaa erityisesti niitä opiskelijoita, joille ohjelmointi tuntuu vaikealta tai pelottavalta. Samalla on tärkeää korostaa, että visuaalinen työkalu ei poista suunnittelun ja loogisen ajattelun tarvetta.
Vertaus: n8n on kuin reseptin rakentamista näkyvistä osista: asetat vaiheet kankaalle, yhdistät ne viivoilla ja tieto kulkee vaiheesta toiseen. Dokumentoidussa polussa sama rakenne piirretään kaavioksi. Olennaista ei ole ohjelmointikielen tunteminen vaan se, että jokaisen vaiheen tehtävä, oikeudet ja virhepolku ovat ymmärrettäviä.
Esimerkki opetukseen
Pyydä opiskelijoita katsomaan n8n-työnkulkua kuin karttaa. Jokainen solmu vastaa kysymykseen: “Mitä tapahtuu seuraavaksi?” Jokainen viiva vastaa kysymykseen: “Mihin data kulkee tämän jälkeen?”
Opeta n8n:n solmujen pääkategoriat lyhyesti noin 10 minuutissa. Tavoitteena ei ole käydä läpi kaikkia mahdollisia solmuja, vaan antaa opiskelijoille käsitteellinen malli, jonka avulla he osaavat lukea työnkulkuja.
| Solmutyyppi | Mitä se tekee? | Esimerkki |
|---|---|---|
| Trigger | Käynnistää työnkulun. | Webhook vastaanottaa lomakevastauksen. |
| Päätössolmu | Valitsee suunnan ehdon perusteella. | IF-solmu tarkistaa, onko viesti kiireellinen. |
| Toimintasolmu | Tekee varsinaisen toiminnon. | kielimallisolmu laatii vastausehdotuksen. |
Korjaava näkökulma: n8n on helppokäyttöinen käyttöliittymän tasolla, mutta sen taustalla on silti vaativia käsitteitä, kuten datanmuunnos, turvakerrokset, muistin hallinta, hyväksyntäportit ja virheiden käsittely.
Kerro opiskelijoille:
Vaikka rajapinta näyttää yksinkertaiselta, logiikka voi olla vaativaa. Jokainen solmu tekee jotain merkityksellistä, ja jokaisen solmun paikka työnkulussa pitää perustella.
Korjaava näkökulma: Hyvä työnkulku suunnitellaan ennen rakentamista. Jos opiskelija aloittaa suoraan rakentamisen, hän päätyy helposti korjaamaan samaa ongelmaa monta kertaa.
Opettajan huomio: Pysäytä liian nopeasti rakentamaan lähtevät opiskelijat ystävällisesti mutta selkeästi. Pyydä heitä kirjoittamaan ensin työnkulun vaiheet numeroituna ja merkitsemään, missä kohtaa tarvitaan syöte, päätös, toiminto, turvakerros ja palaute.
Voit sanoa:
Hyvä insinööri piirtää suunnitelman ennen rakentamista. Huono insinööri rakentaa ensin ja yrittää sitten selvittää, miksi kokonaisuus ei toimi.
Korjaava näkökulma: Kaavio ja simuloitu suoritusjälki voivat osoittaa johdonmukaisen suunnittelun. Ne eivät osoita, että liitäntä, tunnistetieto tai käyttöoikeus toimii oikeassa ympäristössä. Opiskelijan pitää nimetä tämä rajoitus, ei peittää sitä.
Korjaava näkökulma: Turvakerros on pakollinen osa agentin rakentamista. Jos agentti voi lähettää viestejä, muuttaa tietoja tai kutsua ulkoisia palveluita, sen toimintaa pitää rajoittaa ja valvoa.
Esimerkki opetukseen
Jos agentti voi lähettää sähköpostia ilman tarkistusta, se voi vahingossa lähettää arkaluonteisia tietoja väärälle vastaanottajalle. Turvakerros voi estää tämän esimerkiksi tarkistamalla vastaanottajan, sisällön ja riskitason ennen lähetystä.
Korjaava näkökulma: Kuusi rakennusosaa toimii suunnittelun tarkistuslistana, ei pakollisena teknisenä topologiana. Yksi solmu, sääntö tai ulkoinen palvelu voi hoitaa useita vastuita, ja jokin vastuu voi jakautua useaan vaiheeseen. Opiskelijan tehtävä on perustella vastuunjako.
Tavoite: Opiskelija tekee valitun toteutuspolun mukaisen minimiversion ja ymmärtää, miten tieto kulkee vaiheesta toiseen.
Ohje opiskelijalle:
Yleisiä ongelmia ja ratkaisuja:
| Ongelma | Opettajan ohjaava ratkaisu |
|---|---|
| Opiskelija ei yhdistä solmuja oikein viivalla. | Näytä, miten viiva vedetään solmun outputista seuraavan solmun inputiin. |
| Opiskelija painaa Execute väärässä solmussa. | Selitä, että Execute testaa työnkulkua kyseiseen solmuun asti tai kyseisen solmun toimintaa. |
| Opiskelija ei näe, miten data muuttuu. | Avaa solmun Output-välilehti ja pyydä opiskelijaa vertaamaan syötettä ja tulosta. |
Aika-arvio: 15–20 minuuttia
Tavoite: Opiskelija tekee realistisen projektisuunnitelman, joka voidaan toteuttaa n8n:ssä tai osoittaa dokumentoidulla suunnittelupolulla.
Ohje opiskelijalle:
Vinkki arviointiin: Hyvä suunnitelma on toteutettavissa. Se ei ole vain idea, vaan siinä näkyvät vaiheet, solmut, datan kulku, turvakerros ja palaute.
Yleisiä ongelmia ja ratkaisuja:
| Ongelma | Opettajan ohjaava ratkaisu |
|---|---|
| Suunnitelma on liian monimutkainen ensimmäiseksi projektiksi. | Suosittele Taso 1 -lähtökohtaa: yksi syöte, yksi päätös, yksi toiminto ja yksi palautevaihe. |
| Vaiheiden riippuvuudet ovat epäselvät. | Pyydä opiskelijaa kirjoittamaan vaiheet numeroituna ja tarkistamaan, syntyykö jokaisessa vaiheessa tieto, jota seuraava vaihe tarvitsee. |
| Hyväksyntäportit puuttuvat. | Kysy: “Missä kohtaa ihmisen pitää hyväksyä päätös ennen kuin agentti toimii?” |
Aika-arvio: 20–25 minuuttia
Tavoite: Opiskelija oppii arvioimaan suunnitelmaa kriittisesti ja löytämään ongelmia ennen rakentamista.
Opettajan rooli: Varmista, että tiimityö on rakentavaa, ei henkilökohtaista tai loukkaavaa.
Punainen tiimi etsii ongelmia suunnitelmasta, ei ihmisestä. Palautteen tarkoitus on parantaa projektia.
Ohje opiskelijalle:
Punaisen tiimin tarkistuskysymyksiä:
Aika-arvio: 15–20 minuuttia
Tavoite: Opiskelija erottaa kielimallin ja agentin ohjauskehyksen vastuut ja käyttää kuutta rakennusosaa työnkulun kattavuuden tarkistamiseen.
Ohje opiskelijalle:
| Tarkistuslistan kohta | Mahdollinen n8n-vastine | Miten vastuu toteutuu? |
|---|---|---|
| Syötekäsittelijä | Webhook tai lomakesolmu | Vastaanottaa käyttäjän viestin tai datan. |
| Päättelijä | kielimallisolmu tai IF-solmu | Tulkitsee tilanteen tai tekee päätöksen. |
| Työkalut | haku-, viesti- ja taulukkosolmut | Tekee toiminnon tai kutsuu ulkoista palvelua. |
| Muisti | Tietokanta, Sheets tai aiempi loki | Säilyttää ja hakee aiempaa tietoa. |
| Turvakerros | IF-solmu, hyväksyntäportti tai validointivaihe | Estää vaaralliset tai epävarmat toiminnot. |
| Palaute | Lokitus, Sheets, palauteviesti tai seurantavaihe | Tallentaa tulokset ja mahdollistaa toiminnan parantamisen. |
Aika-arvio: 15–20 minuuttia
Kerro opiskelijoille: “Olemme oppineet agentin teoriaa. Nyt teemme siitä testattavan minimiversion kahdella tasavertaisella toteutuspolulla.”
2. Yhteinen malliesimerkki noin 12 minuuttia
Arkkitehtuurin selitys noin 10 minuuttia
Näytä, miten kielimallin ja agentin ohjauskehyksen vastuut jakautuvat ja miten kaikki kuusi rakennusosaa tulevat kokonaisuutena katetuiksi.
Trigger → Validointi → Päättely → Turva → Toiminta → PalauteOpiskelijoiden työskentely noin 15 minuuttia
Tekninen polku rakentaa yksinkertaisen n8n-työnkulun ja tallentaa suoritusnäkymän.
Kerro opiskelijoille: “Seuraavalla tunnilla viimeistelemme, testaamme ja dokumentoimme kummankin toteutuspolun.”
Oppitunti 27 on rakentamisen, testaamisen ja dokumentoinnin tunti. Varmista, että opiskelijat palauttavat suunnitelmansa ennen seuraavaa oppituntia, jotta:
Opettajan tarkistuskysymys: Jos opiskelijan suunnitelma kuulostaa liian laajalta, kysy: “Mikä tästä olisi pienin toimiva versio?” Tämä auttaa rajaamaan projektin toteutettavaksi.
Anna heille lisähaaste:
Rajaa tehtävää:
Käytä varasuunnitelmaa:
Oppitunnin lopussa opiskelijoiden tulisi ymmärtää, että agentin arkkitehtuuri voidaan tehdä näkyväksi n8n-työnkulkuna tai dokumentoituna suunnitelmana. Hyvä kokonaisuus suunnitellaan, rajataan, testataan ja parannetaan. Tekninen polku osoittaa toteutuksen toimivuutta käytetyssä ympäristössä. Dokumentoitu polku osoittaa suunnittelun johdonmukaisuutta, mutta ei testaamattomien liitäntöjen toimivuutta.
Hyvä päätöskysymys tunnin loppuun:
Pohdi: Mikä oman agenttisi pienin testattava versio olisi? Mitkä vastuut siihen tarvitaan, millä näytöllä osoitat ne ja missä kohdassa tarvitset turvakerroksen?
Tallennettava tuotos on minimiagentti v1 tai alustariippumaton suoritusjälki. Pakollinen ydintuotos pidetään samana kaikilla reiteillä.
| Aika | Vaihe | Opettajan tehtävä |
|---|---|---|
| 0–10 min | Virittäytyminen | Kytke ydinkysymys tuttuun tilanteeseen ja tarkista lähtötaso. |
| 10–25 min | Ydinkäsite | Mallinna tunnin keskeinen ero yhdellä vastaesimerkillä. |
| 25–65 min | Perustuotos | Oppija rakentaa triggerin, rajatun agenttipäätöksen, vähintään yhden työkalun ja suoritusjäljen tai simuloi saman alustariippumattomasti. |
| 65–80 min | Testaus ja purku | Testauta kahdella erilaisella syötteellä, muuttuuko valittu toiminto perustellusti. Oppija tekee yhden korjauksen ja testaa sen uudelleen. |
| 80–90 min | Tallennus ja lopputehtävä | Varmista tiedoston nimi, tallennuspaikka ja yhden lauseen johtopäätös. |
Oppija käyttää valmista solmurunkoa ja annettuja syötteitä. Tuki vähentää valintojen määrää, mutta säilyttää saman ydintuotoksen ja perustelun.
Kun perustuotos on valmis, oppija lisää yhden hallitun virhepolun. Syventävä työ ei kasvata pakollista ydintuotosta.
Näytä luokalle kaksi turvallista esimerkkiviestiä. Toisesta puuttuu pakollinen tieto, toisessa tieto on mukana. Tee kielimallikutsu, jonka sallitut tulokset ovat pyyda_lisatietoa ja jatka. Näytä, että sama malli valitsee eri tilanteissa eri vaihtoehdon.
Esitä tulos ensin teknisenä n8n-suoritusjälkenä ja sitten dokumentoituna suoritusjälkenä. Tekninen näyttö kertoo, että reititys toimii käytetyssä ympäristössä. Dokumentoitu näyttö kertoo, miten suunniteltu reitti etenee, mutta simuloituja liitäntöjä ei väitetä toimiviksi.
Piirrä taululle kielimalli ja sitä ympäröivä agentin ohjauskehys. Pyydä opiskelijoita sijoittamaan syötekäsittelijä, päättelijä ja suunnittelija, työkalujen suorittaja, muisti ja konteksti, turvakerros sekä seuranta ja palautesilmukka oikeaan vastuualueeseen. Korosta, että kuusi rakennusosaa ovat kattavuuden tarkistuslista. Ne eivät määrää solmujen tai vaiheiden määrää.
Kysy jokaisesta kohdasta, mitä tietoa se saa, mitä se tuottaa ja miten virhe näkyy. Kielimallin tehtävä on tehdä rajattu tilannearvio. Ohjauskehys tarkistaa syötteen, rajaa vaihtoehdot ja oikeudet, suorittaa työkalut sekä kirjaa tuloksen.
Opiskelija perustelee, valitseeko hän teknisen n8n-polun vai dokumentoidun suunnittelupolun. Perustelussa pitää nimetä, millä näytöllä hän osoittaa todellisen mallivalinnan, agentin ohjauskehyksen rajat ja yhden korjatun ongelman.
Muistuta, että dokumentoitu polku ei ole kevyt versio. Siinä tarvitaan todellinen kielimallikutsu, kaavio, työkalusopimukset, simuloidut suoritusjäljet ja teknisten rajoitusten arvio. Tekninen polku puolestaan tarvitsee toimivan työnkulun, suoritusnäkymän ja virhepolun.
Opiskelija tekee turvallisella aineistolla kaksi testiä, joiden pitäisi johtaa eri sallittuun valintaan. Pari tarkistaa suoritusjäljestä syötteen, mallin valinnan, työkalun tuloksen tai simuloidun vastineen ja seuraavan vaiheen.
Jos molemmat tapaukset kulkevat aina samaa reittiä, kysy, tarvitaanko tehtävässä kielimallin tilannearviota vai riittäisikö tavallinen työnkulku. Jos valinta on perusteltu mutta suoritusjälki epäselvä, opiskelija korjaa dokumentointia. Jos valinta on väärä, hän tarkentaa järjestelmäpromptia tai sallittujen vaihtoehtojen ehtoja ja testaa uudelleen.
Jokainen opiskelija näyttää yhden alkuperäisen testin, tehdyn korjauksen ja uudelleentestin. Tekninen polku näyttää tämän n8n:n suoritusnäkymästä. Dokumentoitu polku näyttää todellisen mallivalinnan ja sitä seuraavan päivitetyn simulaation.
Hyväksyttävä välituotos sisältää kootun suunnitelman, toteutuspolun valinnan, vähintään kaksi sallittua mallivaihtoehtoa, kaksi testijälkeä ja yhden korjatun ongelman. Lisäksi opiskelija nimeää yhden asian, jota hänen näyttönsä ei vielä todista.