Kuinka rakentaa tietopankki: artikkelit, haku, oikeudet ja AI-vastaukset

Tietopankki on haettava kirjasto vastauksista: miten jotain tehdään, miten jokin korjataan, mikä sääntö pätee. Sen rakentamiseen tarvitset artikkeleita muutamassa selkeässä luokassa, muokkausnäkymän, jota kirjoittajasi oikeasti käyttävät, haun, joka löytää oikean artikkelin ihmisten todellisilla hakusanoilla, ja päätöksen siitä, kuka saa lukea mitäkin: julkiset, kirjautuneet asiakkaat vai vain henkilökunta. AI-sovellusrakentaja voi tuottaa rakenteen, muokkausnäkymän ja haun lyhyessä istunnossa. Tietopankin hyödyllisyys riippuu kirjoittamisesta ja ylläpidosta, joten suunnittele helppo muokkaus ja vanhentuneiden artikkelien tunnistaminen ensimmäisestä päivästä alkaen.

Päätä ensin, kenelle se on

Sama ominaisuusjoukko palvelee hyvin erilaisia sivustoja:

• Julkinen ohjekeskus — asiakkaille ja potentiaalisille asiakkaille. Sen täytyy olla nopea, hakukoneiden indeksoitavissa ja kirjoitettu heidän omilla sanoillaan.
• Vain asiakkaille tarkoitetut dokumentit — kirjautumisen takana, maksaville asiakkaille tai kumppaneille.
• Sisäinen tietopankki — työntekijöiden käytännöt, prosessit ja ohjeet. Sen täytyy olla yksityinen; haku ja tuoreus ovat tärkeämpiä kuin ulkoasu.

Julkisten ja sisäisten artikkelien sekoittaminen samalle sivustolle on yleisin syy vuotoihin. Jos tarvitset molempia, anna jokaiselle artikkelille selkeä näkyvyysasetus tai pidä kaksi erillistä sivustoa.

Mitä sovellus tarvitsee

Data

Kaksi kenttää tekevät paljon työtä: omistaja (kuka pitää artikkelin oikeana) ja viimeksi tarkistettu (milloin joku vahvisti, että se on yhä totta). Yhdessä ne mahdollistavat listan artikkeleista, joita kukaan ei ole tarkistanut kuuteen kuukauteen.

Sivut

• Lukija: etusivu hakukentällä ja kategorioilla, kategoriasivut, artikkelisivut sisällysluettelolla, aiheeseen liittyvillä artikkeleilla ja kysymyksellä „Oliko tästä apua?”.
• Muokkaaja: artikkelilista suodattimilla (luonnokset, vanhentuneet, huonosti arvioidut), muokkausnäkymä esikatselulla ja versiohistoria.
• Ylläpito: kategoriat, käyttäjät ja roolit sekä raportit hauista, joilla ei ole tuloksia.

Oikeudet

Lukijat näkevät julkaistut artikkelit, joihin heillä on oikeus. Muokkaajat luovat ja muokkaavat artikkeleita, mahdollisesti vain tietyissä kategorioissa. Ylläpitäjät julkaisevat, arkistoivat ja hallitsevat käyttäjiä. Sisäiseen tietopankkiin kaikilla tarvitaan kirjautuminen; julkiseen ohjekeskukseen kirjautuvat vain kirjoittajat.

Päätökset ja kompromissit

Muokkausnäkymä: Markdown vai rich text

Markdown on nopea, siirrettävä ja sopii hyvin versiohistoriaan, mutta osa kirjoittajista pitää siitä vieraana. Rich text -muokkain otsikoilla, listoilla, kuvilla, huomautuslaatikoilla ja koodilohkoilla tuntuu tutulta. Kumpaa valitset, tallenna sisältö muodossa, jonka voit viedä myöhemmin ulos.

Haku

Perustason tietokantahaku riittää muutamalle sadalle artikkelille, kun haet otsikoista, tiivistelmistä ja sisällöistä ja nostat otsikko-osumat ylimmäksi. Sen jälkeen tai jos kirjoitusvirheet ja synonyymit ovat tärkeitä (esim. „lasku” vs. „laskutus”), käytä kunnollista kokotekstihakua tai hostattua hakupalvelua. Opas hakutoiminnon lisäämiseen käy vaihtoehdot läpi. Kirjaa jokainen haku, joka ei tuota tuloksia: se on ilmainen lista artikkeleista, jotka kannattaa kirjoittaa.

AI-vastaukset

Laatikko, johon kysytään kysymys ja joka vastaa artikkeleistasi, on nykyään yleinen. Se toimii etsimällä olennaisimmat kohdat ja pyytämällä kielimallia vastaamaan vain niiden pohjalta — katso mitä RAG on. Näytä aina lähdeartikkelit, salli „en tiedä” -vastaus ja muista, että malli toistaa varmasti luottavaisesti kaiken vanhentuneen, mitä artikkeleissasi on. Rakenna se vasta, kun artikkelit ovat kunnossa.

Versiointi ja tarkistus

Säilytä versiot, jotta näet, kuka muutti mitä ja voit palauttaa vanhan version. Säänneltyyn sisältöön (henkilöstöpolitiikka, turvallisuusohjeet) kannattaa lisätä hyväksyntävaihe ennen julkaisua.

Ensimmäinen toimiva kehote

Rakenna julkinen ohjekeskus Parcellylle, pienille verkkokaupoille tehtävälle toimituslappusovellukselle. Etusivulla iso hakukenttä ja kuusi kategoriaa (Aloittaminen, Lappujen tulostus, Kuljetusyhtiöt, Laskutus, Palautukset, Vianetsintä). Artikkeleilla on otsikko, tiivistelmä, sisältö Markdownina kuvilla ja huomautuslaatikoilla, kategoria, tagit, tila (luonnos, julkaistu, arkistoitu), omistaja ja viimeksi tarkistettu -päivä. Artikkelisivuilla on sisällysluettelo, aiheeseen liittyviä artikkeleita ja „Oliko tästä apua?” -kysymys kyllä/ei-vastauksella ja halutessa kommentilla. Haku kattaa otsikot, tiivistelmät ja sisällöt, otsikko-osumat ensin, ja se kirjaa jokaisen haun ja sen, tuottiko se tuloksia. Muokkausnäkymä (kirjautuminen vaaditaan, roolit muokkaaja ja ylläpitäjä) listaa luonnokset, artikkelit joita ei ole tarkistettu 180 päivään ja artikkelit, joilla on heikot hyödyllisyysarviot, ja pitää versiohistorian. Jokaisella artikkelilla on oma sivun otsikko ja metakuvaus hakukoneita varten. Puhdas, rauhallinen ja luettava ulkoasu. Mobiili edellä.

Rakennusvaiheet

1. Listaa ensimmäiset 20–30 artikkelia todellisista tukikysymyksistä ennen kuin rakennat mitään. Lista muovaa luokat.
2. Luo sivusto ja tarkista lukeminen puhelimella — rivin pituus, otsikot, kuvat.
3. Muokkausnäkymä ja roolit. Kirjoittajien pitää pystyä lisäämään ja korjaamaan artikkeleita pyytämättä kehittäjää.
4. Haku, ja testaa se sanoilla, joita asiakkaat oikeasti käyttävät, myös kirjoitusvirheillä.
5. Palaute ja hakujen kirjaus.
6. Vanhentuneiden artikkelien raportti omistajan ja viimeksi tarkistetun päivän perusteella.
7. SEO-perusteet julkiselle sivustolle: yksilölliset otsikot, kuvaukset, siistit URL-osoitteet ja sivukartta. Katso SEO AI-rakennetuille verkkosivuille.
8. Linkitä se tuotteestasi ja tukivastauksistasi ja seuraa viikoittain tuloksettomien hakujen lokia.
9. AI-vastaukset, kun sisältö on kunnossa.

Yleisiä virheitä

• Järjestäminen osastojen mukaan lukijan tehtävän sijaan.
• Pitkät artikkelit, jotka kattavat viisi tehtävää. Yksi tehtävä per artikkeli, ja otsikko kertoo, mitä se ratkaisee.
• Ei omistajaa artikkelille. Kukaan ei päivitä mitään, ja luottamus laskee ensimmäisen virheellisen vastauksen jälkeen.
• Sisäiset muistiinpanot julkisissa artikkeleissa. Käytä erillistä näkyvyyttä ja tarkista ennen julkaisua.
• Haku, joka vastaa vain otsikoita. Lukijat kirjoittavat oireita, eivät artikkelien nimiä.
• Kuvakaappaukset ilman alt-tekstiä tai kontekstia. Ne vanhenevat nopeasti; kuvaa askel myös sanoin.

Milloin valmis tuote on parempi valinta

Jos tiimisi työskentelee jo dokumentaatio- tai wiki-työkalussa, sisäinen tietopankki siellä on yleensä helpoin tie — Notion vs. Confluence -vertailumme käsittelee kahta yleistä valintaa. Jos käytät tukipalvelupöytää, sen sisäinen ohjekeskus yhdistää artikkelit tikettiin ja ehdottaa artikkeleita asiakkaille, mitä on vaikea jäljitellä. Dokumentaatiosivustogeneraattorit sopivat kehittäjädokumentaatioon, joka on koodin rinnalla.

Rakenna oma, kun tarvitset omaa rakennetta tai oikeuksia (artikkelit asiakaskohtaisesti, sijainnin tai roolin mukaan), haluat tietopankin tuotteesi sisälle erillisen sivuston sijaan, tarvitset tarkistus- ja hyväksyntävaiheita, joita wiki ei pakota, tai haluat AI-vastauksia sisällöstäsi ilman toista tilausta. Se sopii luonnollisesti omaan tukipalveluun.

Rakentaminen Mythexillä

Mythexissä kuvaat tietopankin chatissa, ja se rakennetaan live-esikatseluun. Artikkelit, versiot ja palaute tallennetaan Postgres-tietokantaan, jonka agentti lisää tarvittaessa, ja kuvat menevät projektin tiedostotallennukseen. Muokkaajien kirjautuminen käyttää valitsemaasi todennustapaa, sillä Mythexissä ei ole sisäänrakennettua loppukäyttäjän kirjautumista. AI-vastauksiin käytät oman AI-palveluntarjoajasi API-avainta, joka tallennetaan projektin salaisuutena, ja käyttö laskutetaan palveluntarjoajasi tililtä eikä Mythex-krediiteistä (AI-resepti). Uudet Mythex-sovellukset ovat oletuksena asiakaspuolella renderöityjä React-yksisivuisia sovelluksia, jotka toimivat hakukoneille heikommin. Julkiselle ohjekeskukselle kannattaa siksi pyytää staattisille sivuille sopiva tai palvelimella renderöity rakenne, kuten Next.js (SEO-resepti).

Aloitukseen voit kokeilla tuotetiedon keskusta tai tiimin dokumentaatiosovellusta pohjina.

Kysymykset