Agentin työkalut — tieto, haku ja rajatut toiminnot
Agentit90 min oppitunti

Opettajan materiaalit — oppitunti 22: Agentin työkalut

Osaamistavoitteet

Tunnin jälkeen opiskelija osaa erottaa tiedon lukemisen, ajantasaisen tiedonhaun ja ympäristöön vaikuttavan toiminnon. Hän osaa kirjoittaa yksinkertaisen työkalusopimuksen, soveltaa minimioikeusperiaatetta ja nimetä tilanteen, jossa tarvitaan ihmisen hyväksyntä. Hän ymmärtää myös vastuunjaon: kielimalli voi valita sallitun työkalun, mutta agentin ohjauskehys tarkistaa oikeudet, suorittaa kutsun ja kirjaa tuloksen tai virheen.

Tunnin ydin

Aloita arkisesta esimerkistä. Asiakaspalvelun agentti voi lukea hyväksyttyä ohjetta, hakea ajantasaisen tilaustiedon tai valmistella viestiluonnoksen. Nämä eivät ole sama oikeus. Lukeminen, hakeminen, tallentaminen, lähettäminen, muuttaminen ja poistaminen rajataan erikseen.

Korosta, ettei ohjelmointia tarvita tämän vastuunjaon ymmärtämiseen. Opiskelijan pitää osata vastata kuuteen kysymykseen: mikä on työkalun tarkoitus, mitä tietoa se saa, mitä se palauttaa, mitä se ei saa tehdä, milloin ihminen hyväksyy toiminnon ja mitä virheessä tapahtuu.

90 minuutin toteutus ja eriyttäminen

Käytä alussa noin 15 minuuttia työkalujen kolmeen ryhmään. Tiedon lukeminen käyttää ennalta rajattua aineistoa. Ajantasainen haku käyttää hyväksyttyä ulkoista lähdettä. Rajattu toiminto vaikuttaa ympäristöön, joten se tarvitsee tavallisesti tiukemmat oikeudet ja lokituksen.

Seuraavat noin 20 minuuttia käytetään oikeuksien vertailuun. Anna ryhmille sama tehtävä ja kolme oikeusmallia: liian niukka, tehtävään sopiva ja tarpeettoman laaja. Pyydä perustelemaan, mikä oikeus on välttämätön ja mikä vain kasvattaa vahingon mahdollisuutta.

Käytä noin 20 minuuttia työkalusopimuksiin. Ryhmä valitsee yhden oman agenttinsa työkalun ja kirjoittaa siitä proosakuvauksen. Parit vaihtavat kuvaukset ja yrittävät löytää epäselvän syötteen, liian laajan oikeuden tai puuttuvan virhepolun.

Tunnin lopussa opiskelija lisää työkalusopimuksen Agentti: Työkalut -pohjapiirrokseen.

Tyypilliset väärinkäsitykset

”Jos työkalu vain lukee, se on vaaraton.” Lukutulos voi olla vanha, väärä, manipuloitu tai väärälle käyttäjälle tarkoitettu. Lähde ja käyttöoikeus tarkistetaan silti.

”Promptissa oleva kielto riittää.” Pelkkä tekstiohje ei toimeenpane teknistä oikeusrajaa. Agentin ohjauskehyksen pitää estää kielletty toiminto.

”Laaja pääsy tekee agentista hyödyllisemmän.” Tarpeeton oikeus kasvattaa vahingon laajuutta. Oikeudet annetaan tehtävän, ei mahdollisten tulevien tarpeiden perusteella.

”Lokitus estää virheen.” Loki auttaa jäljittämään tapahtuman, mutta ei pysäytä sitä. Tarkistus ja hyväksyntä tehdään ennen kriittistä toimintoa.

Arvioitava tuotos

Hyvässä tuotoksessa työkalu on tarpeellinen valittuun ongelmaan, sen syöte ja tulos ovat ymmärrettäviä, oikeudet on rajattu ja virhepolku on kuvattu. Erinomainen tuotos erottaa lisäksi luonnoksen tekemisen ja ulkomaailmaan vaikuttavan toiminnon sekä nimeää kohdan, jossa ihmisen hyväksyntä tarvitaan.

Lähteet

Tuotevertailun ajantasaiset lähteet ovat opiskelijan teoria-aineiston ”Tilanne heinäkuussa 2026” -laatikossa. Tunnin pysyvä ydin on minimioikeusperiaate, työkalusopimus ja agentin ohjauskehyksen toimeenpanema rajaus.