Hoppa till huvudinnehållet

Tekoäly-ystävällinen dokumentaatio

Selkeä ja ajantasainen dokumentaatio parantaa tekoälyavustajan vastauksia. Näillä vinkeillä optimoit organisaatiosi ohjeet tekoälyn käyttöön

Timo Tuomi

• Industry Insights • Lästid: 2 minuter

Tekoäly-ystävällinen dokumentaatio



Huom! Tämä ohje ei ole vaatimus tai edellytys TekstiAI:n palveluiden käyttämiselle vaan voimme hyödyntää monenlaista dokumentaatiota. Näiden ohjeiden tarkoitus on auttaa optimoimaan omaa dokumentaatiota ja dataa tekoälyn käyttöä varten yleisesti.


Yleisenä huomiona kun tekoälyavustaja hakee vastaukset suoraan organisaation omista dokumenteista: todella pitkistä dokumenteista se ei välttämättä lue alusta loppuun kuten ihminen, vaan poimii lyhyitä tekstikatkelmia kysymyksen perusteella. Mitä selkeämmin ja täsmällisemmin tieto on kirjoitettu, sitä parempia vastauksia avustaja antaa.


Kiinnitä huomioita seuraaviin asioihin:

1. Yksi aihe, yksi dokumentti

  • Käsittele (jos mahdollista) kussakin dokumentissa yhtä selkeästi rajattua aihetta, esimerkiksi yhtä prosessia, palvelua tai ohjetta.
  • Anna tiedostolle kuvaava nimi (esim. ”Matkalaskun tekeminen – ohje 2026”), ei ”Muistio_v3_final”.

2. Kuvaavat otsikot ja looginen rakenne

  • Käytä työkalun omia otsikkotyylejä (esim. Wordin Otsikko 1, 2, 3, SharePoint-sivun otsikot tai markdownin #, ##, ###) – älä pelkkää lihavointia. Rakenne auttaa tekoälyä jäsentämään sisällön.
  • Kirjoita otsikot kysymyksinä tai sisältöä kuvaavina: ”Kuka hyväksyy hankinnan?” on parempi kuin ”Yleistä”. Aloita pitkä dokumentti lyhyellä tiivistelmällä.

3. Ymmärrettävät yksittäiset osiot

  • Pitkistä dokumenteista tekoäly saattaa lukea vain yksittäisiä kappaleita. Selkeä asiayhteys parantaa vastauksia silti aina: kirjoita esimerkiksi ”matkalaskun hyväksyy esihenkilö”, ei ”sen hyväksyy hän”.
  • Vältä erityisesti viittauksia kokonaan toisiin dokumentteihin (esim. ”katso tarkemmin matkustusohjeesta”), sillä tekoäly ei välttämättä löydä tai yhdistä niitä. Kirjoita tarvittava tieto suoraan dokumenttiin. Pitkissä dokumenteissa vältä myös viittauksia tyyliin ”kuten yllä todettiin” tai ”kts. edellinen luku” ilman, että asia toistetaan lyhyesti.

4. Täsmällisyys ja yksiselitteisyys

  • Kirjoita näkyviin konkreettiset tiedot: nimet, roolit, määräajat, summat, yksiköt ja yhteystiedot.
  • Avaa lyhenteet ja käytä samasta asiasta aina samaa termiä. Kirjoita eri tapauksille mieluummin omat ohjeet kuin yksi ohje, jossa on paljon poikkeuksia. Muuten tekoäly joutuu soveltamaan sääntöjä itse, mikä johtaa helposti virheellisiin vastauksiin. Jos tapauksia on niin paljon, ettei niitä voi kuvata erikseen, kerro poikkeukset ja ehdot suoraan (”jos…, niin…”).

5. Ajantasaisuus ja metatiedot

  • Merkitse dokumentin alkuun omistaja, päivityspäivä ja voimassaolo. Tekoäly osaa silloin kertoa, mihin tieto perustuu.
  • Poista tai arkistoi vanhentuneet versiot. Ristiriitaiset dokumentit johtavat ristiriitaisiin vastauksiin.

6. Tekoälylle luettava muoto

  • Kirjoita tärkeä tieto ensisijaisesti tekstinä. Jos käytät taulukkoa, pidä se yksinkertaisena: yksi otsikkorivi, ei yhdistettyjä soluja. Kirjoita kuvien ja kaavioiden keskeinen sisältö myös tekstinä.
  • Suosi verkkosivuja, SharePoint-sivuja tai markdown-dokumentteja. Word- ja PDF-tiedostot vaativat erityistä käsittelyä, ennen kuin tekoäly voi hyödyntää niitä, joten ne ovat heikompia lähteitä. Skannatut kuvat ja käsin kirjoitetut liitteet eivät avaudu tekoälylle.

Huomioi ennen julkaisua

  • Onko dokumentilla selkeä aihe ja kuvaava nimi?
  • Ovatko otsikkotyylit käytössä?
  • Ymmärtääkö yksittäisen osion ilman muita dokumentteja tai muuta tekstiä?
  • Ovatko luvut, nimet ja määräajat näkyvissä?
  • Onko omistaja ja päivityspäivä merkitty?
  • Onko vanha versio poistettu?