Näin rakensimme staffbite.fi:n agenttien kanssa
staffbite.fi rakennettiin tekoälyagenteilla, ja jokainen ajo kirjattiin: agentit, tokenit, kestot ja löydökset. Mukana myös se, mitä kone ei huomannut.
Rakensimme staffbite.fi:n uudelleen Go:lla ja htmx:llä, ja useita työvaiheita tekivät tekoälyagentit. Kirjasimme jokaisesta ajosta agenttien määrän, tokenit, keston, arvioijakierrokset ja löydökset. Tässä ovat luvut ja se, mitä niistä opimme.
Lyhyesti: 126 agenttiajoa ja noin 11,6 miljoonaa tokenia 20.–21.11.2026. Ihminen huomasi asioita, joita kone ei huomannut, ja päinvastoin.
Miten työ tehtiin
Agentit ajettiin Claude Codella ja omalla lisäosalla, joka jakaa työn kolmella tavalla:
- Neuvosto: useampi agentti tekee ehdotuksen eri näkökulmista, ja tuomari-agentit pisteyttävät ne sokkona. Käytimme tätä päätöksiin, joille ei ole automaattista testiä, kuten navigaatioon ja URL-malliin.
- Rakenna, arvioi, korjaa: agentit rakentavat rinnakkain omilla kaistoillaan, arvioija-agentit tarkistavat työn, ja kaistat korjaavat, kunnes arvioijat hyväksyvät.
- Paras n:stä: sama tehtävä tehdään useaan kertaan erillisissä git-työkopioissa, ja automaattinen tarkistus sekä tuomari valitsevat parhaan.
Jokaisella rakentajalla on oma kaistansa, esimerkiksi käyttöliittymä, palvelin, dokumentaatio tai sisältö, eikä se saa muokata muiden tiedostoja. Rajat pitivät myös silloin, kun useita ajoja oli käynnissä yhtä aikaa.
Luvut
| Työ | Tapa | Agentit | Tokenit | Kesto |
|---|---|---|---|---|
| Navigaatio, sivukartta ja URL-malli | neuvosto | 7 | 574 537 | 10 min 6 s |
| Erä 1: URL-malli, reitit, ylä- ja alatunniste | rakenna, arvioi, korjaa | 23 + 2 arvioijaa | 1 197 337 | 19 min 47 s |
| Sisältöpaketti ja julkaisusäännöt | paras kolmesta | 4 | 446 729 | 10 min 0 s |
| Erä 2: sitemap, robots.txt, llms.txt, JSON-LD | rakenna, arvioi, korjaa | 11 | 733 106 | 14 min 48 s |
| Ilmeen mallikuvat A, B ja C | 3 rinnakkaista agenttia | 3 | noin 505 000 | 11–13 min |
| Tutkimus 113 palkitusta sivustosta, mallikuvat D ja E | 1 + 2 agenttia | 3 | 706 768 | 28 min + 19–23 min |
| Mallikuvat F ja G | 2 agenttia, 2 palautekierrosta | 2 | 672 817 | F 47 min, G 22 min |
| Erä 3: ilme F sivustoon | rakenna, arvioi, korjaa | 21 | 1 670 327 | 38 min 44 s |
| Faktapohjat sivujen teksteille | 2 tutkimusagenttia | 2 | 406 584 | noin 10 min |
| Erä 4: tekstit kahdeksalle sivulle, faktakorostukset, llms-full.txt | rakenna, arvioi, korjaa | 25 | 2 757 055 | 35 min 55 s |
| Ajankohtaista-osio, jossa luet tätä | rakenna, arvioi, korjaa | 23 | 1 881 915 | 30 min 51 s |
Suurin yksittäinen ajo oli sivujen tekstien ja sisältöpaketin kytkentä (erä 4): 25 agenttia, neljä kaistaa, seitsemän arvioijaa, kaksi arvioijakierrosta ja 2,76 miljoonaa tokenia. Ensimmäisellä kierroksella arvioijat löysivät 6 estävää ja 24 pientä huomiota, toisella 2 estävää ja 25 pientä. Ilmeen toteutuksessa (erä 3) jäljelle jääneet yhdeksän huomiota olivat kaikki aiheellisia, ja ne korjattiin käsin noin 15 minuutissa.
Mitä ihminen huomasi ja kone ei
Korostukset kirjainten päällä. Ilmeen version F (Faktaruudukko) ensimmäinen mallikuva pyöristi faktakorostukset ulospäin kokonaisiin ruutuihin, jolloin ne peittivät viereisiä kirjaimia. Sivuston omistaja huomasi sen selaimessa, automaattitarkistus ei. Palaute välitettiin käynnissä olevalle agentille, joka säilytti kontekstinsa, korjasi virheen ja ajoi lopuksi omat tarkistuksensa päällekkäisyydestä ja ruudukkoon osumisesta.
Vanhentunut sana. Erän 2 arvioijat eivät huomanneet, että yhteystietosivun kuvauksessa luki yhä ”ajanvaraus”, vaikka ajanvarausta ei ole. Se löytyi, kun palvelin käynnistettiin ja sivut käytiin läpi.
Kaksi virhettä voittajassa. Sisältöpaketin kolmesta toteutuksesta parhaaseen jäi kuvapolun tarkistukseen aukko ja virheellinen koodikommentti. Tuomari-agentti mainitsi molemmat, ja ne korjattiin käsin.
Mitä kone huomasi ja ihminen ei
Vanha bugi. Navigaatiota pohtinut neuvosto löysi silloisesta koodista virheen: kieliversioiden hreflang-linkit jäivät 404-sivulle. Havainto tarkistettiin koodista.
Vierityspalkki, jota kuvakaappaus ei näytä. Erän 3 arvioija löysi koodista virheen, joka näkyy vain Linuxin ja Windowsin hiirikäyttäjille. Automaattisissa kuvakaappauksissa sitä ei näkynyt.
Tyhjä sivu navigaatiossa. Erän 4 arvioija huomasi, että ensimmäisen kirjoituksen julkaisu olisi tuonut navigaatioon Ajankohtaista-linkin sivulle, jolla ei vielä ollut listaa. Ajankohtainen pidettiin piilossa, kunnes lista ja kirjoitussivut olivat valmiit.
Referenssi ilman lupaa. Sisältöarvioija huomautti, että referenssin teksti oli kirjoitettu ennen kuin sivuston omistajalta oli kysytty lupaa. Lupa kysyttiin ennen julkaisua.
Näppäimistön käyttäjä putosi sivun alkuun. Ajankohtaista-listan ensimmäisessä versiossa sivutus vaihtoi listan ilman sivulatausta, mutta näppäimistön fokus palasi sivun alkuun. UX-arvioija merkitsi sen estäväksi, ja se korjattiin ennen kuin työ hyväksyttiin.
Yleiset väärinkäsitykset. Faktapohjia kokoavat agentit löysivät väitteitä, jotka kiertävät yleisesti mutta eivät pidä enää paikkaansa. Esimerkiksi Italian tietosuojaviranomaisen OpenAI:lle määräämä sakko kumottiin 18.3.2026, ja tekoälysäädöksen suuririskisten järjestelmien velvoitteet siirtyivät 2.12.2027:een.
Mikä ei toiminut
- Erän 1 ajossa 8 agenttia 23:sta päättyi virheeseen, koska projektin omat arvioijat luotiin kesken istunnon eikä työnkulku löytänyt niitä. Ne ajettiin erikseen.
- Kolme rinnakkaista mallikuva-agenttia jakoi saman työkansion ja ylikirjoitti toistensa apuskriptejä. Vaikutusta repoon ei ollut, ja seuraavissa ajoissa jokainen agentti sai oman kansion.
- Erän 3 kahden kierroksen raja tuli vastaan, ja ajon tarkistuslista epäonnistui, koska suunnitelmaa muokattiin kesken ajon. Työ itse oli kunnossa.
- Osa lähteistä, kuten Gartner ja UpCloud, esti automaattisen haun. Niiden luvut on merkitty faktapohjaan heikommin varmistetuiksi, ja ne tarkistetaan ennen käyttöä.
Mitä emme vielä tiedä
Emme ole mitanneet, kuinka kauan sama työ olisi kestänyt ilman agentteja, joten emme väitä nopeudesta lukua. Tunne ei riitä: METRin kontrolloidussa kokeessa kokeneet kehittäjät olivat tekoälyn kanssa 19 % hitaampia, vaikka uskoivat olleensa 20 % nopeampia (METR, 10.7.2025).
Kirjaamme ajot jatkossakin, ja vertailuajot ilman lisäosaa merkitään erikseen.
Mitä tästä seuraa asiakkaalle
Sama tapa on käytössä asiakasprojekteissa: spesifikaatio, rinnakkaiset agentit, arvioija-agentit, ihmisen tarkistus ja mitatut luvut. Lue lisää: AI-natiivi kehitys.