Olet oppinut, miten tällä kurssilla rajattu agentti toimii, miten sitä turvataan ja miten se eroaa tavallisesta työnkulusta. Olet myös kerännyt matkan varrella viisi pohjapiirrosta tunneilta 19, 21, 23, 24 ja 25. Tällä tunnilla kokoat ne yhteen ja teet ensimmäisen testattavan version. Voit rakentaa sen teknisenä n8n-toteutuksena tai dokumentoituna suunnitelmana. Molemmissa kielimallin on tehtävä vähintään yksi todellinen, tilanteen mukaan muuttuva valinta.
n8n lausutaan ”n-eight-n”. Se on visuaalinen automaatioympäristö, jota voi käyttää pilvipalveluna tai ylläpitää itse sen lisenssiehtojen mukaisesti. Työnkulku rakennetaan solmuista eli nodeista kankaalle. Jokainen solmu tekee yhden asian: vastaanottaa viestin, kutsuu kielimallia, lukee rajattua tietoa tai valmistelee toiminnon. Solmujen välille vedetään yhteys, ja tieto kulkee vaiheesta toiseen.
Miksi juuri n8n? Koska se poistaa yhden suurimmista esteistä agentin rakentamisessa: sinun ei tarvitse osata ohjelmoida kaikkea käsin. Kaikki, mitä olet oppinut agentin rakenteesta — syötekäsittelijä, päättelijä ja suunnittelija, työkalujen suorittaja, muisti ja konteksti, turvakerros sekä seuranta ja palautesilmukka — voidaan toteuttaa n8n:ssä visuaalisesti. Näet agentin arkkitehtuurin konkreettisesti solmuina ja yhteyksinä.
Agentin ohjauskehyksen näkökulma: n8n ei ole automaattisesti agentti. Se on ympäristö, jossa ohjauskehyksen vastuut voidaan toteuttaa näkyvänä työnkulkuna: yksi solmu kutsuu kielimallia, muut huolehtivat syötteistä, työkaluista, tilasta, turvarajoista ja toiminnan jatkumisesta. Dokumentoidussa suunnittelupolussa samat vastuut kuvataan kaaviona, sopimuksina ja suoritusjälkinä. Kuusi rakennusosaa toimii kummassakin polussa kattavuuden tarkistuslistana.
Pysähdy hetkeksi: Mieti jotakin toistuvaa tehtävää arjessasi tai koulussa. Voisiko kone hoitaa sen puolestasi, jos sillä olisi pääsy oikeisiin työkaluihin?
Tältä valmis n8n-työnkulku näyttää. Tämä on esimerkki siitä, millaisen yksinkertaisen agentin voit rakentaa:
Kun avaat n8n:n ensimmäistä kertaa, näet tyhjän kankaan. Kaikki alkaa triggeristä eli solmusta, joka käynnistää työnkulun. Triggeri voi olla esimerkiksi ajastin, kuten ”joka maanantai klo 8”, webhook, kuten ”kun joku lähettää viestin”, tai manuaalinen käynnistys, kuten ”kun painan käynnistä”. Ilman triggeriä työnkulku ei lähde liikkeelle.
Triggerin jälkeen lisäät toimintasolmuja. Jokainen solmu saa tietoa edelliseltä solmulta ja antaa sitä seuraavalle. Työnkulku voi esimerkiksi vastaanottaa viestin, pyytää kielimallia luokittelemaan sen ja ohjata tuloksen oikeaan käsittelyyn. Tämä on tekoälyavusteinen työnkulku, mutta ei vielä välttämättä agentti. Tällä kurssilla agentilta vaaditaan, että kielimalli valitsee seuraavan toiminnon tai työkalun tilanteen ja havaintojen perusteella — ohjauskehyksen asettamissa rajoissa.
n8n:ssä on valmiita solmuja esimerkiksi taulukoille, viesteille, tiedostoille, tietokannoille ja kielimalleille. Sinun ei tarvitse ohjelmoida yhteyksiä käsin. Sinun tehtäväsi on päättää, mitä tietoa saa käyttää, minkä valinnan kielimalli tekee ja mitä järjestelmä saa valinnan jälkeen tehdä.
Pysähdy hetkeksi: Miten agentin kaikki kuusi rakennusosaa toteutuvat suunnitelmassasi? Mieti vastuita ennen solmuja: yksi solmu, sääntö tai palvelu voi kattaa useita kohtia.
Palataan hetkeksi Boteista agentteihin -tunnin arkkitehtuuriin ja katsotaan, miten sen vastuut voidaan toteuttaa n8n:ssä tai kuvata dokumentoidussa suunnittelupolussa. Agentin viimeistelytunnilla dokumentoit ensin kielimallin ja agentin ohjauskehyksen rajan ja käytät kuutta rakennusosaa kattavuuden tarkistuslistana. Tarkoitus ei ole pakottaa jokaista vastuuta yhteen lokeroon.
Syötekäsittelijä on triggerisolmu ja mahdolliset validointisolmut sen jälkeen. Jos rakennat chatbotin, triggeri voi olla webhook, joka vastaanottaa käyttäjän viestin. Heti sen jälkeen voit lisätä IF-solmun, joka tarkistaa esimerkiksi, onko viesti liian pitkä tai tyhjä. Tämä on samaa syötevalidointia, josta puhuttiin teoriassa. n8n:ssä se näkyy konkreettisena solmuna kankaalla.
Päättelijä on tekoälysolmu, esimerkiksi kielimallisolmu. Siihen kirjoitat järjestelmäpromptin, joka ohjaa agentin toimintaa. Tässä solmussa agentti ”ajattelee”: se saa käyttäjän viestin, mahdollisesti kontekstitietoa edellisistä solmuista sekä ohjeet siitä, miten sen pitää vastata tai toimia.
Työkalujen suorittaja tarkoittaa solmuja tai kuvattuja toimintoja, joilla agentti lukee rajattua tietoa tai vaikuttaa ympäristöönsä. Työkalu voi hakea hyväksytystä tietolähteestä, kirjoittaa taulukkoon tai valmistella viestin. Sopimus määrää, mitä se saa tehdä ja miten virhe käsitellään.
Muisti ja konteksti voidaan toteuttaa usealla tavalla. Yksinkertaisimmillaan voit tallentaa keskusteluhistorian rajattuun taulukkoon ja hakea sen jokaisen uuden viestin yhteydessä. n8n:ssä voi olla myös muistisolmuja tai muita tapoja säilyttää keskustelun kontekstia ja prosessin tilaa.
Turvakerros toteutuu IF-solmuilla, ehdoilla, validoinneilla ja hyväksyntäkohdilla. Voit esimerkiksi lisätä ehdon: ”Jos vastaus sisältää henkilötietoja, älä lähetä sitä eteenpäin.” Tai: ”Jos käyttäjä pyytää jotakin, mikä ei kuulu agentin tehtävään, vastaa kohteliaasti kieltäytymällä.” n8n:ssä nämä ovat konkreettisia haarautumia työnkulussa.
Seuranta ja palautesilmukka tarkoittavat lokitusta ja palautteen keräämistä. Lisää työnkulkuun solmu, joka tallentaa jokaisen tärkeän toiminnon esimerkiksi rajattuun taulukkoon tai tiedostoon: mitä käyttäjä kysyi, mitä agentti vastasi, mitä työkaluja käytettiin ja kauanko suoritus kesti. Näin näet jälkikäteen, miten agentti toimii, ja voit parantaa sitä.
Tämän tunnin tärkein periaate on: aloita pienestä. Rakenna ensin yksinkertaisin mahdollinen versio, joka tekee yhden asian oikein. Testaa se. Lisää vasta sen jälkeen seuraava ominaisuus. Tätä kutsutaan iteratiiviseksi kehitykseksi. Kokeneet käyttäjätkään eivät rakenna valmista tuotetta yhdellä kertaa.
Käytännössä Agentin minimiversion rakennustunnin tavoite on toimiva minimiversio, jossa näkyy yksi aito agenttipäätös. Kielimalli saa esimerkiksi valita kahdesta rajatusta työkalusta, pyytää lisätietoa tai lopettaa tehtävän. Valinta ja sen tulos tallennetaan näkyvään suoritusjälkeen. Turvakerros, hyväksyntäportit ja viimeistely tehdään Agentin viimeistelytunnilla. Jos projektisi etenee aina samaa polkua, kutsu sitä tässä vaiheessa tekoälyavusteiseksi työnkuluksi ja lisää agenttipäätös vain, jos tehtävä todella tarvitsee sellaisen.
Esimerkki iteratiivisesta rakentamisesta:
hae_tietoa tai pyyda_lisatietoa.Testaa jokaisen lisäyksen jälkeen, että kaikki toimii. Jos jokin menee rikki, tiedät tarkalleen, mikä muutos aiheutti ongelman. Tämä on paljon helpompaa kuin rakentaa koko työnkulku kerralla ja etsiä sen jälkeen vikaa kymmenestä eri solmusta.
Pysähdy hetkeksi: Kun lisäät uuden solmun, säännön tai palvelun työnkulkuusi, mieti aina: mistä vastuusta se huolehtii? Voiko sama toteutusosa kattaa syötekäsittelijän, päättelijän ja suunnittelijan, työkalujen suorittajan, muistin ja kontekstin, turvakerroksen tai seurannan ja palautesilmukan vastuuta — ja jääkö jokin olennainen vastuu vielä puuttumaan?
Tällä tunnilla et aloita tyhjältä pöydältä. Sinulla on viisi pohjapiirrosta, jotka olet kerännyt edellisillä tunneilla. Niiden pohjalta tiedät jo:
Tunnin alussa kokoat nämä viisi pohjapiirrosta yhdeksi suunnitelmaksi ja tarkistat, että ne sopivat yhteen. Sen jälkeen rakennat minimiversion: triggeri + kielimallin tekemä rajattu valinta + vähintään yksi työkalu tai toiminto + näkyvä suoritusjälki. Pohjapiirrosten 4 ja 5 sisältämät turvakerros ja ihmisen rooli viimeistellään Agentin viimeistelytunnilla, kun testaat ja dokumentoit agentin.
Jos olet epävarma omasta projektistasi, voit arvioida vaikeustasoa seuraavien esimerkkien avulla:
Taso 1 — FAQ-botti
Yhteisö saa samoja kysymyksiä kymmeniä kertoja päivässä. Botti vastaa yleisimpiin kysymyksiin automaattisesti. Triggeri on viesti chat-kanavasta. Työnkulku lähettää viestin tekoälysolmulle, jolla on järjestelmäprompti ja FAQ-tietokanta kontekstina. Lopuksi vastaus lähetetään takaisin chattiin.
Taso 2 — Sähköpostiyhteenvetoagentti
Agentti lukee joka aamu klo 8 viimeisen 24 tunnin sähköpostit, tekee niistä yhteenvedon tekoälyllä ja lähettää yhteenvedon tiimikanavalle. Triggeri on ajastin. Työnkulku etenee näin: hae sähköpostit → kokoa yhteenveto → lähetä yhteenveto.
Taso 3 — Tikettiagentti
Asiakas lähettää viestin lomakkeella. Agentti luokittelee viestin, esimerkiksi tilaus, laskutus tai palaute. Sen jälkeen agentti luo tiketin rajattuun taulukkoon, vastaa asiakkaalle automaattisesti ja ilmoittaa oikealle tiimille. Jos viesti on kriittinen, se ohjataan ihmiselle hyväksyttäväksi. Tämä on esimerkki ihmisen osallistavasta rakenteesta.
Tunnin lopussa sinulla pitäisi olla testattava minimiversio agentistasi. Tekninen polku osoittaa n8n:n suoritusnäkymällä, että yhteydet ja reititys toimivat käytetyssä ympäristössä. Dokumentoitu suunnittelupolku osoittaa kaavion, työkalusopimusten ja simuloitujen suoritusjälkien avulla, että suunnitelma on johdonmukainen. Jälkimmäinen ei kuitenkaan todista testaamattomien liitäntöjen tai käyttöoikeuksien toimivuutta.
Minimiversiossa tulee olla vähintään:
Lisäksi sinun kannattaa tunnin aikana kirjata muistiin:
Tarkista lopuksi: Käynnistyykö työnkulku? Kulkeeko data solmulta toiselle? Tuottaako tekoälysolmu järkevän vastauksen? Tekeekö toimintasolmu sen, mitä sen pitää tehdä? Tiedätkö, mitä korjaat tai lisäät seuraavalla tunnilla?
Tämä tunti vie sinut suunnitelmasta testattavaan minimiversioon. Kokoat viisi pohjapiirrostasi yhteen, teet yhden tilanteen mukaan muuttuvan kielimallivalinnan ja näytät sen seuraukset suoritusjäljessä. Tekninen polku rakentaa tämän n8n:ssä. Dokumentoitu polku kuvaa rakenteen ja simuloi sen, mutta käyttää samassa kohdassa todellista kielimallipäätöstä.
Tunnin lopussa sinulla on toimiva perusversio, jonka päälle lisäät turvakerroksen, hyväksyntäportit, testauksen ja dokumentaation Agentin viimeistelytunnilla. Tärkeintä ei ole rakentaa kaikkea valmiiksi yhdellä kertaa. Tärkeintä on saada ensimmäinen versio toimimaan, ymmärtää sen rakenne ja tietää, miten jatkat siitä eteenpäin.
Erota nämä: Mitä kielimalli valitsee — ja mitkä solmut, säännöt, sopimukset tai palvelut muodostavat sitä ympäröivän agentin ohjauskehyksen?
Tarkistettu 15.7.2026.
Tämä on Agentit-osion ensimmäinen rakennustunti. Tänään kokoat viisi pohjapiirrostasi yhtenäiseksi suunnitelmaksi ja teet agentistasi ensimmäisen testattavan version. Voit edetä teknistä n8n-polkua tai dokumentoitua suunnittelupolkua. Molemmissa kielimallin on tehtävä vähintään yksi todellinen, tilanteen mukaan muuttuva valinta.
Lue viisi pohjapiirrostasi yhtenä kokonaisuutena. Korjaa ristiriidat ja varmista, että ratkaisu vastaa Automaatio vai autonomia -tunnilla valitsemaasi ongelmaan. Kirjoita sen jälkeen lyhyt arkkitehtuuriluonnos. Kuvaa ensin, mitä kielimalli tekee ja mistä agentin ohjauskehys vastaa. Esitä sitten ratkaisun tärkeimmät vaiheet, niiden syötteet ja tulokset. Vaiheiden määrää ei ole määrätty: mukana ovat vain tehtävän kannalta tarpeelliset vastuut.
Tarkista luonnoksesta kuusi rakennusosaa: syötekäsittelijä, päättelijä ja suunnittelija, työkalujen suorittaja, muisti ja konteksti, turvakerros sekä seuranta ja palautesilmukka. Merkitse jokaisesta, onko se mukana, lisätäänkö se Agentin viimeistelytunnilla vai eikö sitä tarvita tässä työssä. Perustele poisjättö lyhyesti.
Voit pyytää tekoälyä esittämään suunnitelmastasi kysymyksiä:
Olen koonnut viisi pohjapiirrosta agentistani. Lue ne ja kysy
minulta kysymyksiä, jotka paljastavat mahdolliset ristiriidat tai
aukot. Älä korjaa puolestani, vaan auta minua huomaamaan ongelmat.
Valitse polku, jolla pystyt osoittamaan ymmärryksesi luotettavimmin.
Tekninen n8n-polku. Rakenna n8n:ssä toimiva minimiversio. Tallenna suoritusnäkymästä syöte, kielimallin valinta, mahdollisen työkalun tulos ja seuraava vaihe. Tekninen näyttö osoittaa, että yhteydet, reititys ja rajaukset toimivat käytetyssä ympäristössä.
Dokumentoitu suunnittelupolku. Kuvaa sama kokonaisuus n8n-kaaviona tai selkeänä vaihekuvauksena. Tee työkalusopimukset, oikeusrajat ja kaksi käsin seurattavaa suoritusjälkeä. Tämä polku osoittaa suunnittelun johdonmukaisuuden, mutta ei väitä testaamattomien liitäntöjen tai käyttöoikeuksien toimivan.
Kumpikaan polku ei ole helpotettu versio. Näyttö on erilainen, mutta molemmissa tarvitaan oikea kielimallikutsu. Malli valitsee tilanteen perusteella vähintään kahdesta sallitusta vaihtoehdosta, esimerkiksi hae hyväksytystä lähteestä, pyydä lisätietoa tai ohjaa ihmiselle.
Anna järjestelmälle turvallinen esimerkkisyöte. Määritä kielimallille tehtävä ja vähintään kaksi sallittua vaihtoehtoa. Rajaa, milloin kukin vaihtoehto on käytettävissä, ja päätä, miten valinta näkyy suoritusjäljessä. Lisää ainakin yksi työkalu tai toimintopolku, jonka käyttöä agentin ohjauskehys rajaa.
Testaa kahdella erilaisella syötteellä. Valinnan pitää muuttua perustellusti tilanteen mukana. Kirjaa kummastakin testistä syöte, valittu vaihtoehto, perusteluna käytetty havaittava ehto, työkalun tai toimintopolun tulos ja seuraava vaihe. Jos järjestelmä kulkee aina samaa ennalta määrättyä reittiä, tarkista, onko kyse agentin sijasta työnkulusta.
Korjaa yksi testeissä löytynyt ongelma ja aja sitä koskeva testi uudelleen. Teknisen polun opiskelija tekee korjauksen työnkulkuun. Dokumentoidun polun opiskelija päivittää kaavion, sopimuksen tai rajauksen ja tuottaa uuden suoritusjäljen.
Kirjoita lyhyt tilannekuva: mihin pääsit, mikä jäi kesken ja mitä viimeistelet ensimmäisenä Agentin viimeistelytunnilla. Liitä mukaan toteutuspolkusi näyttö: teknisessä polussa kuva työnkulusta ja suoritusnäkymästä, dokumentoidussa polussa kaavio ja kaksi jäljitettävää suoritusjälkeä. Merkitse selvästi kohta, jossa kielimalli tekee tilanteen mukaan muuttuvan valinnan.
Lopputyön rakentaminen 1/2 — Agentin viimeistelytunnilla viimeistelet, testaat ja esittelet
| Termi | Selitys |
|---|---|
| Agentin ohjauskehys | Kielimallia ympäröivä järjestelmä, joka hoitaa työnkulun, työkalut, tilan, oikeudet, turvarajat, lokituksen ja palautumisen. |
| n8n | Visuaalinen automaatioalusta, jossa teknisen polun työnkulku rakennetaan solmuista ja yhteyksistä. |
| Solmu | Yksittäinen vaihe n8n-työnkulussa. Solmujen määrä ei määritä, onko järjestelmä agentti. |
| Triggeri | Tapahtuma, joka käynnistää työnkulun. |
| Kielimallivalinta | Tilanteen mukaan muuttuva valinta vähintään kahdesta agentin ohjauskehyksen sallimasta vaihtoehdosta. |
| Työkalusopimus | Kuvaus työkalun tarkoituksesta, syötteestä, tuloksesta, oikeuksista, kielloista ja virhepolusta. |
| Suoritusjälki | Tallennettu ketju, jossa näkyvät syöte, kielimallin valinta, työkalun tulos tai virhe ja seuraava vaihe. |
| Tekninen n8n-polku | Toteutuspolku, jossa työnkulun yhteydet, reititys ja oikeudet näytetään toimivassa n8n-toteutuksessa. |
| Dokumentoitu suunnittelupolku | Toteutuspolku, jossa rakenne kuvataan kaaviona ja työkalusopimuksina sekä testataan todellisella kielimallivalinnalla ja simuloidulla suoritusjäljellä. |
| Simulaatio | Kuvaus siitä, miten järjestelmä etenisi annettujen sääntöjen mukaan. Se ei yksin todista liitäntöjen tai käyttöoikeuksien teknistä toimivuutta. |
| Arkkitehtuuri | Kuvaus siitä, mitä kielimalli tekee, mistä agentin ohjauskehys vastaa ja miten tieto, päätökset sekä valvonta kulkevat järjestelmän läpi. |
| Iteratiivinen kehitys | Tapa tehdä pieni versio, testata se, korjata havaittu ongelma ja testata uudelleen. |