Voit määrittää tekoälyagentille useampia taitoja eli skills-tiedostoja, joista agentti valitsee tilanteeseen sopivan toimintatavan. Tämä on usein parempi ratkaisu kuin yksi valtava ohjetiedosto, koska agentin toiminta pysyy selkeämpänä, modulaarisempana ja helpommin ylläpidettävänä.

Miksi skills-tiedosto kannattaa olla .md-muodossa?

Koska Markdown on agenttiohjeisiin erittäin sopiva formaatti:

1. Se on selkeä ihmiselle Voit avata tiedoston millä tahansa tekstieditorilla, kuten VS Codella, Notepadilla tai Obsidianilla.
2. Se on helppo lukea tekoälylle Otsikot, listat, taulukot ja koodilohkot erottuvat selkeästi.
3. Se ei sisällä turhaa muotoilukoodia Word-tiedostoissa on paljon piilotettua rakennetta ja muotoilua. Markdownissa sisältö on yleensä puhtaampaa.
4. Se sopii versionhallintaan Jos käytät GitHubia, Markdown-tiedostojen muutokset näkyvät hyvin: mitä on lisätty, poistettu tai muokattu.
5. Se tukee modulaarista ohjeistusta Jokainen skill voidaan kirjoittaa omaksi .md-tiedostokseen

Keskeinen periaate on tämä:

Agentin pääohje ei saa yrittää sisältää kaikkea osaamista, vaan sen tehtävä on kertoa, milloin mitäkin skills-tiedostoa käytetään.

Suositeltu rakenne

Kannattaa jakaa ohjeistus kolmeen tasoon:

1. Agentin pääohje

Pääohjeessa määritellään agentin rooli, yleiset toimintaperiaatteet ja sääntö siitä, miten skills-tiedostoja käytetään.

Esimerkiksi:

Olet opetusteknologiaan ja tekoälyn pedagogiseen käyttöön erikoistunut agentti.

Käytä aina tehtävään sopivinta skills-tiedostoa. Älä yritä ratkaista tehtävää yleisellä tiedolla, jos jokin skills-tiedosto sisältää tarkemmat toimintaohjeet.

Valitse skills-tiedosto käyttäjän pyynnön perusteella seuraavasti:

- Jos käyttäjä pyytää arvioimaan opiskelijatyötä tai laatimaan arviointipalautetta, käytä tiedostoa skill_palaute.md.
- Jos käyttäjä pyytää muokkaamaan Moodle XML -tiedostoa, käytä tiedostoa skill_moodle_xml.md.
- Jos käyttäjä pyytää laatimaan opintojakson toteutussuunnitelman, käytä tiedostoa skill_toteutussuunnitelma.md.
- Jos käyttäjä pyytää analysoimaan tietosuojariskejä tai tekoälyn vastuullista käyttöä, käytä tiedostoa skill_tietosuoja_ja_ai.md.
- Jos tehtävä ei sovi mihinkään skills-tiedostoon, vastaa yleisten ohjeiden perusteella ja kerro tarvittaessa, että tarkempaa skills-ohjetta ei ole käytettävissä.

2. Skills-tiedostojen hakemisto tai valintalogiikka

Pääohjeeseen kannattaa lisätä erillinen “skills-hakemisto”. Se toimii agentille reitittimenä.

Esimerkiksi:

Skills-tiedostojen käyttötarkoitukset:

1. skill_palaute.md
Käytä, kun tehtävä liittyy opiskelijapalautteiden arviointiin, arviointimatriiseihin, numeeriseen arviointiin, osaamistavoitteiden arviointiin tai palautetekstien muodostamiseen.

2. skill_moodle_xml.md
Käytä, kun tehtävä liittyy Moodle XML -kysymyksiin, tenttikysymysten muotoiluun, monivalintakysymyksiin, aukkotehtäviin tai XML-rakenteen korjaamiseen.

3. skill_toteutussuunnitelma.md
Käytä, kun tehtävä liittyy opintojakson aikatauluun, viikkorakenteeseen, kuormituslaskentaan, oppimistehtäviin tai arvioinnin kokonaisuuteen.

4. skill_tietosuoja_ja_ai.md
Käytä, kun tehtävä liittyy tekoälyn riskeihin, tietosuojaan, DPIA/FRIA-arviointiin, opiskelijadatan käsittelyyn tai organisaation AI-ohjeisiin.

3. Varsinaiset skills-tiedostot

Jokaisen skills-tiedoston kannattaa olla mahdollisimman rajattu yhteen tehtävätyyppiin.

Hyvä skills-tiedosto sisältää yleensä nämä osat:

# Skill: Opiskelijatyön palautteen muodostaminen

## Milloin tätä käytetään
Käytä tätä skill-ohjetta, kun käyttäjä pyytää  laatimaan palautetta tai soveltamaan arviointimatriisia opiskelijatyöhön.

## Tavoite
Tuota palaute, joka on perusteltu, johdonmukainen, opiskelijalle ymmärrettävä ja sidottu annettuun arviointimatriisiin.

## Toimintatapa
1. Lue ensin tehtävänanto.
2. Lue arviointimatriisi.
3. Lue opiskelijan vastaus.
4. Luo palaute jokaiselle kriteerille erikseen.
5. Anna perustelu jokaiselle palautteelle.
6. Tee lopuksi yhteenveto vahvuuksista ja kehityskohteista.

## Rajoitukset
Älä käytä palautteen luomisessa ulkopuolisia lähteitä, ellei käyttäjä erikseen pyydä.
Älä keksi sisältöä, jota opiskelijan tekstissä ei ole.
Jos aineistoa puuttuu, kerro mitä puuttuu.

## Tulostusmuoto
Anna vastaus seuraavassa muodossa:

- Kriteeri
- Palaute
- Perustelu
- Kehitysehdotus

Miten agentti valitsee oikean taidon?

Agentin kannattaa käyttää yksinkertaista päätöslogiikkaa:

Ennen vastaamista päättele:
1. Mikä on käyttäjän ensisijainen tavoite?
2. Liittyykö tavoite johonkin skills-tiedostoon?
3. Jos kyllä, noudata kyseistä skills-tiedostoa.
4. Jos useampi skills-tiedosto sopii, käytä ensisijaista skill-tiedostoa ja hyödynnä toista vain tukevana ohjeena.
5. Jos mikään skill ei sovi, vastaa yleisen agenttiohjeen mukaisesti.

Tämä kannattaa kirjoittaa agentin pääohjeeseen suoraan.

Jos useampi skill sopii samaan tehtävään

Tällöin kannattaa määrittää ensisijaisuusjärjestys. Muuten agentti voi yhdistellä ohjeita epäjohdonmukaisesti.

Esimerkiksi:

Jos tehtävä liittyy sekä Moodle XML -muotoon että pedagogiseen arviointiin:
1. Käytä ensin pedagogista skill-tiedostoa sisällön muodostamiseen.
2. Käytä sen jälkeen Moodle XML -skill-tiedostoa tekniseen muotoiluun.
3. Lopputuloksen tulee olla teknisesti validia Moodle XML:ää.

Tai:

Jos tehtävä liittyy sekä tietosuojaan että opettajan ohjeistukseen:
1. Noudata ensisijaisesti tietosuoja- ja AI-riskien skill-ohjetta.
2. Muotoile lopputulos opettajalle ymmärrettäväksi yleisen viestintäohjeen mukaisesti.

Hyvä pääohje agentille

Voisit käyttää esimerkiksi tällaista rakennetta:

Sinulla on käytössä useita skills-tiedostoja. Ne sisältävät tehtäväkohtaisia toimintamalleja.

Ennen jokaista vastausta tunnista käyttäjän pyynnön tehtävätyyppi ja valitse siihen sopivin skills-tiedosto.

Älä käytä skills-tiedostoja mekaanisesti, vaan sovella niitä käyttäjän tavoitteen mukaisesti. Jos käyttäjän pyyntö on epäselvä, tee paras mahdollinen tulkinta annetun aineiston perusteella.

Skills-tiedostojen valinta:

- Arviointi ja palautteet → skill_palaute.md
- Moodle XML ja tenttikysymykset → skill_moodle_xml.md
- Opintojaksojen suunnittelu → skill_toteutussuunnitelma.md
- Tietosuoja, AI-riskit ja vastuullinen tekoäly → skill_tietosuoja_ja_ai.md
- Viestintätekstit ja ohjeistukset → skill_viestinta.md

Jos tehtävä sopii useampaan skill-tiedostoon, käytä ensisijaista skill-tiedostoa tehtävän päätavoitteen mukaan ja toissijaista skill-tiedostoa vain täydentävänä ohjeena.

Jos mikään skills-tiedosto ei sovi tehtävään, vastaa yleisen roolisi ja käyttäjän pyynnön perusteella.

Käytännön suositus

Pidä yksi skill melko lyhyenä ja rajattuna. Hyvä nyrkkisääntö:

yksi skill = yksi selkeä tehtävätyyppi.

Esimerkiksi älä tee yhtä tiedostoa nimellä:

skill_opetus_ai_moodle_arviointi_tietosuoja.md

vaan mieluummin:

skill_palaute.md
skill_moodle_xml.md
skill_tietosuoja.md
skill_opintojakson_suunnittelu.md
skill_viestinta.md

Näin agentin on helpompi valita oikea toimintamalli.

Paras malli agentin ohjeistukseen

Tiivistetysti paras ratkaisu on:

1. Pääohje määrittää agentin roolin.
2. Pääohje sisältää skills-hakemiston.
3. Jokainen skill kuvaa yhden tehtävätyypin.
4. Skills-tiedostoissa on selkeä rakenne:
   - milloin käytetään
   - tavoite
   - toimintavaiheet
   - rajoitukset
   - tulostusmuoto
5. Pääohjeessa määritetään, mitä tehdään, jos useampi skill sopii.

Tärkeintä on, että agentille ei vain anneta useita skills-tiedostoja, vaan sille annetaan myös selvästi ilmaistu valintasääntö: mistä agentti tunnistaa, mitä skill-tiedostoa käytetään missäkin tilanteessa.