Miten kirjoittaa tehokkaita tietolähteitä RAG-pohjaisille järjestelmille (Knowledge Discovery)

Tämä opas tarjoaa käytännön suosituksia artikkelien, käsikirjojen ja oppaiden kirjoittamiseen tai parantamiseen, kun niitä käytetään lähdemateriaalina RAG (Retrieval-Augmented Generation) -tekoälyjärjestelmässä. Tavoitteena on tehdä mallille mahdollisimman helpoksi ymmärtää ja hakea olennaista, täsmällistä tietoa.

1. 🎯 Määritä jokaiselle dokumentille selkeä tarkoitus

Jokaisen dokumentin tulisi vastata yhteen tiettyyn kysymykseen tai käyttötapaukseen.

Kerro selkeästi otsikossa ja väliotsikoissa, mistä dokumentti kertoo (esim. ”Miten nollaat salasanasi ESM:ssä”, ”VPN-asetukset etätyöntekijöille”).

Vältä aiheiden sekoittamista — on parempi jakaa pitkät dokumentit pienempiin, kohdennettuihin osiin.

2. 🧱 Käytä jäsenneltyjä osioita ja selkeitä otsikoita

Jäsennä sisältö loogisiin osioihin: Johdanto, Vaiheittainen ohje, Huomiot, Yleiset ongelmat, UKK.

Käytä H2/H3-otsikoita — tämä auttaa mallia ymmärtämään sisällön rakenteen ja kontekstin.

Jokaisen toiminnon tai ohjeen tulisi olla omassa vaiheessaan tai kappaleessaan.

3. 🔢 Käytä numeroituja vaiheita ja luettelomerkkejä

Pitkien kappaleiden sijaan käytä:

## Miten nollaat salasanasi
1. Siirry kirjautumissivulle.
2. Napsauta ”Unohditko salasanan”.
3. Anna yrityksesi sähköpostiosoite.
4. Tarkista sähköpostisi ja napsauta palautuslinkkiä.

Tekoäly käsittelee tätä muotoa paljon paremmin kuin jäsentelemätöntä tekstiä.

4. 📌 Käytä johdonmukaista terminologiaa

Käytä selkeitä ja johdonmukaisia nimiä järjestelmille, tiimeille, toiminnoille ja lyhenteille (esim. ”ESM-alusta”, ”IT-tukitiimi”, ”FortiClient VPN”).

Vältä lyhenteiden tai sisäisen ammattislangin käyttöä, ellei niitä ole määritelty.

5. 🧠 Anna kontekstia dokumentin sisällä

Lisää lyhyt selitys siitä, miksi jokin tehdään. Esimerkiksi:

”Salasana on vaihdettava 90 päivän välein yrityksen tietoturvakäytännön noudattamiseksi.”

Malli ymmärtää tarkoituksen ja aikomuksen paremmin, kun konteksti on saatavilla.

6. 🔍 Korosta tärkeät tiedot

Korosta tärkeitä kohtia (kuten polkuja, asetuksia, varoituksia, vinkkejä) lihavoidulla tekstillä tai visuaalisella muotoilulla:

Huomio: Salasanan nollauksen jälkeen sinun on kirjauduttava uudelleen VPN:ään.

Tämä auttaa mallia tunnistamaan, mikä vastauksessa on tärkeää.

7. 📂 Yksi dokumentti = yksi aihe

❌ Huono käytäntö: ”Kaikki mitä sinun tarvitsee tietää ESM:stä”

✅ Hyvä käytäntö:

”Miten teet lomapyynnön ESS2:ssa”

”Miten tarkistat tiketin tilan ESM:ssä”

”Miten otat MFA:n käyttöön yritystilillesi”

8. 💬 Sisällytä UKK ja tyypilliset käyttäjien kysymykset

Tekoäly vastaa usein luonnollisen kielen kysymyksiin. Sisällytä osio, kuten:

## Usein kysytyt kysymykset
- Entä jos en saanut palautusviestiä?
- Voinko nollata salasanani toimistoverkon ulkopuolella?

9. 🧪 Testaa ennen julkaisua

Kokeile todellisen käyttäjän kaltaisia kysymyksiä ja tarkista, löytyvätkö vastaukset tekstistä helposti.

Voit myös testata dokumentin tekoälyjärjestelmän kautta ja arvioida tuotettujen vastausten laatua.

10. 🧼 Käytä yksinkertaista, oikeaoppista kieltä

Tekoäly toimii parhaiten lyhyillä, selkeillä ja kieliopillisesti oikeilla lauseilla.

Vältä liian teknisiä tai monimutkaisia ilmaisuja.

Käytä suoria ohjeita ehdollisen tai ehdottelevan kielen sijaan.

✍️ Esimerkki: huono vs. hyvä

❌ Huono:

Jos käyttäjällä on kirjautumisongelmia, hän voisi yrittää muistaa salasanan tai mennä ESM:n kirjautumissivulle ja ehkä käyttää nollausvaihtoehtoa.

✅ Hyvä:

Miten nollaat salasanasi:

Siirry ESM:n kirjautumissivulle.

Napsauta ”Unohditko salasanan”.

Anna yrityksesi sähköpostiosoite.

Tarkista sähköpostisi ja napsauta palautuslinkkiä.

⚠️ Tärkeää: käytä yhtä kieltä kaikissa dokumenteissa

Tekoälyjärjestelmän tarkkuuden ja vastausten laadun ylläpitämiseksi kaikki lähdedokumentit on kirjoitettava samalla kielellä. Kielten sekoittaminen tietämyskannassa heikentää merkittävästi mallin tehokkuutta ja vastausten selkeyttä.

Päätä etukäteen, mitä ensisijaista kieltä käytetään (esim. englanti, suomi, saksa, ruotsi tai puola), ja varmista, että kaikki artikkelit, ohjeet ja dokumentaatio noudattavat tätä valintaa johdonmukaisesti.