Tekoälyagenttien yhteydessä harness (valjaat) on ohjelmistoinfrastruktuuri, joka ympäröi kielimallia ja tekee siitä toimivan agentin. Harness ei ole malli, vaan kaikki, mikä mallin ympärillä on: silmukka, joka päättää, milloin mallia kutsutaan uudelleen, työkalut, joita malli voi käyttää, jokaisessa vaiheessa saatava konteksti, oikeudet, jotka rajoittavat mallia, sekä jäljet, joihin kirjataan, mitä malli teki.
Vuonna 2026 yleistynyt kaava tiivistää asian hyvin: agentti = malli + harness. Raakamalli ei ole agentti. Siitä tulee agentti, kun harness antaa sille tilan, työkalujen suorittamisen, palautteen ja rajoitukset, joita voidaan valvoa. Tavallinen vertaus kuuluu näin: malli on moottori ja harness on loppu auto.
Kaksi merkitystä, joita ei kannata sekoittaa
- Suoritusharness (agent harness): ympäristö, joka pitää agentin toiminnassa tuotannossa. Tämä on hallitseva merkitys. Sitä käyttävät sekä mallien valmistajat että Microsoftin tuotedokumentaatio, joka määrittelee sen »suoritusrakenteeksi, joka muuntaa kielimallin agentiksi, kykeneväksi työskentelemään».
- Arviointiharness (evaluation harness, test harness): rakenne, joka ajaa testiakkua mallia vastaan ja mittaa sen tulokset toistettavasti. Se on klassisen ohjelmistotestauksen test harness -työkalun perillinen.
Molemmissa on sama ajatus: ulkoinen rakenne, joka pitää mallin kiinni, syöttää sille aineistoa ja tarkkailee, mitä se tekee.
Mistä nimi tulee
Harness tarkoittaa valjaita: remmejä, joilla vetoeläin kiinnitetään kuormaan, tai varusteita, jotka estävät korkealla työskentelevää putoamasta. Tekniikan alat olivat käyttäneet sanaa jo kahdesti ennen kuin se tuli tekoälyn kieleen.
- Autoteollisuudessa ja ilmailussa johtosarja (wiring harness) on kaapelikimppu, joka yhdistää ajoneuvon komponentit toisiinsa. Se yleistyi autoteollisuudessa 1920-luvulla. Se ei tee itse mitään: se yhdistää, järjestää ja suojaa.
- Ohjelmistoissa test harness on joukko stub-tynkiä ja driver-ajureita, jotka ympäröivät ohjelman osaa ja suorittavat sen hallitusti: ne syöttävät sille syötteitä, keräävät tulokset ja vertaavat niitä odotettuihin.
Vuonna 2026 syntyi siis ennen kaikkea kurinalaisuus. Harness engineering -termistö vakiintui kyseisen vuoden alussa, ja sen isyydestä kiistellään Mitchell Hashimoton artikkelin (helmikuu 2026) ja LangChainin artikkelin (maaliskuu 2026) välillä.
Harnessin anatomia
- Ohjaussilmukka. Mallin kutsuminen, sen pyytämien toimintojen suorittaminen, tuloksen palauttaminen ja toistaminen, kunnes tehtävä on valmis tai askelraja täyttyy.
- Työkalut. Agentin todelliset kyvyt: pääte, selain, tiedostot, API:t, tietokannat. Se, miten ne kuvataan ja nimetään, vaikuttaa suorituskykyyn yhtä paljon kuin valittu malli.
- Kontekstin hallinta. Mikä sisältyy konteksti-ikkunaan kussakin vaiheessa ja mikä tiivistetään, hylätään tai tallennetaan muualle. Tämä on pitkien tehtävien tavallinen pullonkaula.
- Käyttöoikeudet ja hyväksynnät. Mitä agentti voi tehdä kysymättä ja mikä vaatii ihmisen vahvistuksen (HITL).
- Muisti ja tila. Se, mikä säilyy askelten ja suoritusten välillä, sekä kyky jatkaa keskeytettyä tehtävää. Tämä on pitkäikäisten agenttien keskeinen ongelma: jokainen uusi istunto alkaa ilman muistoa edellisestä.
- Havainnoitavuus. Jäljet, lokit ja vaiheittainen toisto: ilman tätä agenttia ei voi virheenkorjata eikä parantaa.
Miksi harness ratkaisee lopputuloksen
Sama malli voi ratkaista tehtävän tai epäonnistua siinä sen mukaan, mikä harness sitä ympäröi, ja vuonna 2026 on olemassa tietoa, joka tukee tätä:
- LangChain paransi tulostaan Terminal-Bench 2.0:ssa 52,8 %:sta 66,5 %:iin vaihtamatta mallia, työstämällä vain harnessia.
- 254 SWE-bench-tuloslistalle lähetetyn lähetyksen tarkastuksessa havaittiin, että samalla mallilla scaffoldin vaihtaminen siirtää tulosta jopa 29,8 prosenttiyksikköä, kun taas koko top 30 mahtuu 8,8 pisteeseen.
Tästä syystä yhä yleisempi suositus on ilmoittaa aina malli-harness-pari: kahta lukua, jotka on saatu samalla mallilla ja eri rakennelmalla, ei voi verrata. Yritykselle seuraus on suora: kun verrataan kahta tekoälytuotetta, suuri osa erosta ei ole mallissa – usein se on sama –, vaan harnessissa, jonka joku on rakentanut sen ympärille.
Suhde muihin termeihin
- Scaffold käytetään lähes synonyymina; se viittaa yleensä koodirakenteeseen, joka orkestroi agentin, kun taas harness painottaa suoritusympäristöä ja mittausta.
- Loop engineering on tieteenala, joka suunnittelee tämän silmukan hyvin.
- Guardrails ovat rajoituksia, jotka harness asettaa.
- Agentic workflows ja multi-agent orchestration ovat sitä, mitä rakennetaan päälle.
Käytännössä olennainen kysymys ei ole, mitä mallia tekoälyalusta käyttää, vaan mikä harness sille on laitettu: miten se ohjaa silmukkaa, mitä työkaluja se tarjoaa, missä se pyytää lupaa ja mitä se jättää kirjatuksi. Kerromme tästä tarkemmin artikkelissa Harness, hetken vinkki, joka on ollut olemassa jo vuosia.