Kuinka kirjoittaa tehokkaita tietolähteitä RAG-pohjaisille järjestelmille (tiedon löytäminen)

Tämä uid tarjoaa käytännön suosituksia RAG (Retrieval-Augmented Generation) -tekoälyjärjestelmän lähdemateriaalina käytettävien artikkelien, käsikirjojen ja uid kirjoittamiseen tai parantamiseen. Tavoitteena on tehdä mallille mahdollisimman helpoksi ymmärtää ja hakea olennaista ja tarkkaa tietoa.

1. 🎯 Määrittele jokaiselle asiakirjalle selkeä tarkoitus

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

Kerro otsikossa ja otsikoissa selvästi, mistä asiakirjassa on kyse (esim. ”Salasanan nollaaminen ESM:ssä” , ”VPN-asennus etätyöntekijöille” ).

Vältä aiheiden sekoittamista – on parempi jakaa pitkät asiakirjat pienempiin, kohdennettuihin osiin.

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

Järjestä sisältö loogisiin osiin: Johdanto, Vaihe vaiheelta, Huomautukset, Yleisiä ongelmia, Usein kysytyt kysymykset .

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

Jokaisen toiminnon tai ohjeen tulisi olla omassa vaiheessaan tai kappaleessaan.

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

Pitkien kappaleiden sijaan käytä:

## How to reset your password
1. Go to the login page.
2. Click on “Forgot password”.
3. Enter your company email address.
4. Check your inbox and click the reset link.

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

4. 📌 Käytä johdonmukaista terminologiaa

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

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

5. 🧠 Pro konteksti asiakirjassa

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

"Salasanan vaihto vaaditaan 90 päivän välein yrityksen tietoturvakäytännön noudattamiseksi."

Malli ymmärtää tarkoituksen ja aikomuksen paremmin, kun konteksti on käytettävissä.

6. 🔍 Korosta tärkeimmät tiedot

Korosta tärkeitä kohtia (kuten polkuja, asetuksia, varoituksia ja vinkkejä) lihavoimalla tekstiä tai visuaalisella muotoilulla :

Huomautus: Salasanan palauttamisen jälkeen sinun on kirjauduttava uudelleen VPN-palveluun.

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ö:

"Kuinka lähettää lomapyyntö ESS2:ssa"

"Kuinka tarkistaa tiketin tila ESM:ssä"

"Kuinka ottaa monitoimitunnistus käyttöön yritystililläsi"

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

Tekoäly vastaa usein luonnollisella kielellä esitettyihin kysymyksiin. Sisällytä esimerkiksi seuraava osio:

## Frequently Asked Questions
- What if I didn't receive the reset email?
- Can I reset my password outside the office network?

9. 🧪 Testaa ennen julkaisemista

Kokeile oikeita käyttäjäystävällisiä kysymyksiä ja katso, löytyvätkö vastaukset helposti tekstistä.

Voit halutessasi testata asiakirjan tekoälyjärjestelmän avulla ja arvioida luotujen vastausten laatua.

10. 🧼 Käytä yksinkertaista ja oikeaa kieltä

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

Vältä liian teknisiä tai monimutkaisia ilmaisuja.

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

✍️ Esimerkki: Paha vs. hyvä

❌ Huono:

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

✅ Hyvää:

Salasanan nollaaminen:

Siirry ESM:n kirjautumissivulle.

Klikkaa ”Unohdin salasanani”.

Anna yrityksesi sähköpostiosoite.

Tarkista sähköpostisi ja napsauta nollauslinkkiä.

⚠️ Tärkeää: Käytä samaa kieltä kaikissa dokumenteissa

Jotta tekoälyjärjestelmä säilyttäisi korkean tarkkuuden ja vastausten laadun, kaikkien lähdedokumenttien on oltava samalla kielellä . Kielten sekoittaminen tietokannassa heikentää merkittävästi mallin tehokkuutta ja vastausten selkeyttä.

Päätäthän etukäteen, mitä ensisijaista kieltä käytetään (esim. englanti, suomi, saksa, ruotsi tai puola), ja varmista, että kaikissa artikkeleissa, ohjeissa ja dokumentaatiossa noudatetaan tätä valintaa johdonmukaisesti.