Agentin minimiversion rakennustunnilla teit teknisen n8n-minimiversion tai dokumentoidun suunnitelman. Tällä tunnilla viet valitsemasi polun loppuun, testaat sen, korjaat yhden havaitun puutteen, ajat saman testin uudelleen ja puolustat ratkaisuasi lyhyesti. Koko pakollinen suoritus tehdään yhden 90 minuutin oppitunnin aikana.
| Aika | Mitä teet? |
|---|---|
| 0–8 min | Avaa työ ja rajaa tämän tunnin näyttö |
| 8–30 min | Viimeistele toteutus tai dokumentoitu suunnitelma |
| 30–48 min | Aja yksi normaali, yksi reuna- ja yksi turvallisuustesti |
| 48–63 min | Tee yksi perusteltu korjaus ja aja sama testi uudelleen |
| 63–75 min | Kokoa tiivis näyttöpaketti |
| 75–88 min | Pidä 2–3 minuutin puolustus pienryhmässä, tallenteena tai opettajan valitsemassa otoksessa |
| 88–90 min | Palauta tai tallenna näyttöpaketti |
Pakollista työtä ei jätetä kotiin. Jos jokin tekninen liitäntä ei valmistu ajassa, rajaa näyttöä ja kuvaa rajoitus rehellisesti. Lisätestit, laajemmat integraatiot ja pidempi dokumentaatio ovat vapaaehtoista syventämistä.
Agentin ohjauskehyksen näkökulma: Kummassakin toteutuspolussa osoitat, missä kielimalli tekee aidon rajatun valinnan ja miten agentin ohjauskehys rajaa sallitut vaihtoehdot, työkalut, oikeudet, tilan, turvallisuuden ja lokituksen.
Teknisessä polussa viimeistelet rajatun n8n-työnkulun ja näytät sen suoritusnäkymästä syötteen, kielimallin valinnan, seuraavan haaran tai toiminnon sekä tuloksen. Jos jokin ulkoinen liitäntä ei toimi, voit käyttää turvallista testiympäristöä tai rajattua korviketta, kunhan kerrot sen näkyvästi.
Dokumentoidussa polussa viimeistelet kaavion, työkalusopimukset ja vaihe vaiheelta seurattavan suoritusjäljen. Teet vähintään yhden todellisen kielimallikutsun, jossa malli valitsee vähintään kahdesta sallitusta vaihtoehdosta. Sen jälkeen seuraat kaavion ennalta määriteltyjä vaiheita ja erotat toteutetun mallikutsun simuloiduista toiminnoista.
Polkuja arvioidaan samalla kysymyksellä: osoittaako esitetty todistusaineisto järjestelmän rakenteen, aidon rajatun mallivalinnan, testituloksen, korjauksen, uudelleentestin ja turvallisuusratkaisun? Teknistä polkua ei palkita pelkästä toimivasta liitännästä, eikä dokumentoitua polkua rangaista siitä, ettei se väitä simuloitua toimintoa toteutetuksi.
Tarkista kuusi rakennusosaa niiden kanonisilla nimillä: syötekäsittelijä, päättelijä ja suunnittelija, työkalujen suorittaja, muisti ja konteksti, turvakerros sekä seuranta ja palautesilmukka. Niitä ei tarvitse toteuttaa kuutena solmuna. Merkitse kustakin lyhyesti, missä vastuu näkyy tai miksi sitä ei tarvita tässä rajatussa agentissa.
Varmista erityisesti neljä asiaa. Syöte on näkyvissä. Kielimalli tekee aidon rajatun valinnan vähintään kahdesta sallitusta vaihtoehdosta. Valintaa seuraava toiminto tai simuloitu vaihe on jäljitettävissä. Turvakerros pysäyttää tai eskaloi tilanteen havaittavan ehdon perusteella.
Havaittava eskalointiehto voi olla esimerkiksi hyväksytyn lähteen puuttuminen, lähteiden ristiriita, pakollisen tiedon puuttuminen, validoinnin epäonnistuminen, työkalun virhe tai ennalta määritelty riskiluokka. Mallin itse ilmoittama varmuusprosentti ei ole hyväksyntäraja.
Aja kolme testiä:
Kirjaa jokaisesta testistä syöte, odotettu tulos, todellinen tulos ja johtopäätös. Tekninen polku ottaa todellisen tuloksen suoritusnäkymästä. Dokumentoitu polku kirjaa todellisen kielimallivalinnan ja sitä seuraavan käsin kuljetun suoritusjäljen. Kummassakin polussa pitää näkyä, mikä osa on toteutettu ja mikä simuloitu.
Testin ei tarvitse onnistua ensimmäisellä kerralla. Epäonnistunut testi on hyödyllinen, jos se paljastaa korjattavan puutteen.
Valitse testeistä yksi havaittu puute. Tee yksi rajattu muutos esimerkiksi järjestelmäohjeeseen, sallittujen vaihtoehtojen kuvaukseen, validointiin, työkalusopimukseen, turvarajaan, kaavioon tai virhepolkuun. Aja sama testi uudelleen samalla syötteellä.
Kirjaa neljä kohtaa: alkuperäinen tulos, tehty muutos, uudelleentestin tulos ja johtopäätös. Näin osoitat iteratiivisen kehityksen. Pelkkä väite ”korjasin sen” ei riitä, mutta suuren ominaisuuden rakentamista ei vaadita.
Näyttöpaketti voi olla yksi sivu, yksi dia tai vastaava tiivis näkymä, jonka liitteenä ovat tarvittavat kuvat tai linkit. Siinä näkyvät:
Näyttöpaketti ei ole kolme erillistä pitkää dokumenttia. Tavoite on tehdä ajattelu ja todistusaineisto nopeasti arvioitaviksi.
Puolustuksessa vastaat neljään kysymykseen:
Puolustus voidaan järjestää pienryhmissä, lyhyenä tallenteena tai opettajan valitsemana otoksena. Näin kaikkien ei tarvitse esiintyä peräkkäin koko luokalle. Itsenäisessä verkko-opiskelussa voit tallentaa 2–3 minuutin puheenvuoron tai kirjoittaa vastaavan lyhyen puolustuksen saman 90 minuutin aikana.
Molemmat toteutuspolut arvioidaan samoilla kriteereillä ja samalla painolla.
| Kriteeri | Paino | Mitä todistusaineistosta etsitään? |
|---|---|---|
| Rakenne ja toteutuspolun näyttö | 20 % | Työnkulku tai kaavio on seurattava ja kuusi rakennusosaa on käsitelty perustellusti. |
| Aito rajattu mallivalinta | 25 % | Syöte, vähintään kaksi sallittua vaihtoehtoa, mallin valinta ja seuraava vaihe näkyvät. |
| Testi, korjaus ja uudelleentesti | 25 % | Kolme testitulosta sekä yhden puutteen ennen–jälkeen-näyttö ovat jäljitettävissä. |
| Turvallisuus ja rajat | 20 % | Oikeudet, havaittava eskalointiehto ja tärkein rajoitus on kuvattu tai toteutettu. |
| Puolustus | 10 % | Opiskelija perustelee ratkaisunsa ja erottaa toteutetun simuloidusta. |
Arvioinnissa tarkastellaan todistusaineiston laatua, ei teknisten solmujen määrää. Teknisen polun suoritusnäkymä ja dokumentoidun polun todellinen mallikutsu sekä simuloitu suoritusjälki ovat erilaisia mutta samanarvoisia tapoja osoittaa osaamista.
Tallenna tiivis näyttöpaketti ja 2–3 minuutin tallenne tai kirjallinen puolustus omaan portfolioosi. Rajaa työ 90 minuuttiin. Jos jokin jäi kesken, nimeä se rajoitukseksi sen sijaan, että laajentaisit pakollista suoritusta.
Olet vienyt rajatun agentin suunnitelmasta arvioitavaksi näytöksi. Tekninen ja dokumentoitu polku osoittavat osaamista eri todistusaineistolla, mutta molemmissa kielimalli tekee aidon rajatun valinnan ja agentin ohjauskehys pitää toiminnan hallittuna. Kolme testiä, yksi korjaus ja uudelleentesti osoittavat, että et vain kuvannut ideaa vaan arvioit ja paransit sitä.
Erota nämä: Mitä todistusaineistosi osoittaa varmasti — ja mikä jäi oletukseksi, simulaatioksi tai jatkokehitykseksi?
Tarkistettu 15.7.2026.
Todistusaineisto, jolla opiskelija osoittaa työn rakenteen ja toiminnan. Tekninen polku käyttää työnkulkua ja suoritusnäkymää. Dokumentoitu polku käyttää kaaviota, todellista mallikutsua ja simuloitua suoritusjälkeä.
Kielimallin syötteen perusteella tekemä valinta vähintään kahdesta agentin ohjauskehyksen sallimasta vaihtoehdosta. Syöte, vaihtoehdot, valinta ja seuraava vaihe tehdään näkyviksi.
Tiivis sivu, dia tai vastaava näkymä, joka kokoaa rakenteen, mallivalinnan, testit, korjauksen, turvallisuusrajan ja toteutuksen rajoituksen.
Testi tilanteella, jota varten agentti on suunniteltu.
Mahdollinen mutta tavallisesta poikkeava tilanne, kuten puuttuva pakollinen tieto tai ristiriitaiset lähteet.
Testi, joka yrittää ohittaa toimintorajan, oikeuden tai hyväksyntäportin.
Saman testin ajaminen samalla syötteellä rajatun korjauksen jälkeen. Tuloksia verrataan keskenään.
Asia, jota valittu näyttö ei todista. Dokumentoitu suunnitelma ei esimerkiksi osoita testaamattoman liitännän toimivuutta.
2–3 minuutin perusteltu esitys, jossa opiskelija näyttää mallivalinnan, testin, korjauksen, turvallisuusrajan ja työn rajoituksen.