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