Tekninen dokumenttiassistentti.
Kun käyttöohjeelta voi kysyä.
Katso 5 minuutin videoesittely YouTubessaKuusi Designin tekemä demo, ei Harvian virallinen palvelu. Demo perustuu julkiseen käyttöohjeeseen.Lähtökohta
Kansainvälisessä käyttöympäristössä tekninen tieto on usein englanninkielisissä käyttöohjeissa, huoltokirjoissa ja sähkökaavioissa. Kun apua tarvitaan, oikea kohta pitäisi löytää nopeasti myös silloin, kun käyttäjän oma kieli on jokin muu.
Mitä rakensin
Rakensin asiakkaalle toimitetun teknisen dokumenttiassistentin, jonka lähdeaineistona ovat kyseisen koneen tai laitteen käyttö- ja huolto-ohjeet, mahdolliset sähköpiirustukset sekä vikadiagnostiikan dokumentaatio. Asiakas voi kysyä chatissa omalla kielellään esimerkiksi huoltoväleistä. Assistentti kertoo huoltokirjan mukaiset toimenpiteet ja voi tarvittaessa ohjata tilaamaan tarvittavan osan laitteen valmistajalta sekä kertoa, mihin ottaa yhteyttä. Myös takuuaikaisen vian selvitys voi alkaa chatista: usein ohjeissa on ratkaisu asiaan, joka on jäänyt huomaamatta. Näin asiakkaan ei tarvitse käydä läpi useita laajoja ja teknisiä dokumentteja löytääkseen oikean toimintaohjeen.
Julkinen Harvia-demo
Toimintaperiaatetta havainnollistaa erillinen demo, jonka aineistona on Harvian julkisesti saatavilla oleva kiukaan asennus- ja käyttöohje. Demo näyttää esimerkiksi vianetsinnän, asennusetäisyydet, sähkötiedot ja saman kysymyksen eri kielillä. Se ei ole Harvian palvelu eikä sisällä asiakasprojektin aineistoa.
Oma roolini
Suunnittelin käyttötavan ja rakensin sovelluksen: aineiston jäsentelyn, keskustelukäyttöliittymän, lähdeviitteet, kieliohjauksen ja vastausten testauksen. Keskeinen osa työtä on myös asiakkaan nykyisen dokumentaation arviointi. Kun käyttöohjeita, huolto-ohjeita, sähköpiirustuksia ja muuta aineistoa on kertynyt useita ja niitä on päivitetty eri aikoina, tiedoissa voi olla ristiriitoja tai vanhentuneita kohtia. Aineisto käydään läpi, jäsennetään ja muokataan tekoälylle helposti luettavaan muotoon ennen kuin se liitetään assistentin lähdeaineistoksi. Tämä aineiston laadullinen arviointi ja valmistelu on olennainen osa luotettavan dokumenttiassistentin toteutusta. Toteutuksessa hyödynsin Reactia, TypeScriptiä ja Geminiä.
Hyöty ja rajat
Assistentti nopeuttaa tiedon löytämistä, helpottaa kielimuuria ja tekee laajasta dokumentaatiosta käytännöllisemmän. Sama toimintamalli sopii myös yrityksen turvallisuusohjeisiin, työohjeisiin, laatukäsikirjoihin ja perehdytysaineistoihin. Se ei korvaa alkuperäistä ohjetta, valtuutettua ammattilaista tai turvallisuusvastuuta. Asiakkaan nimi, aineisto, käyttöliittymä ja lähdekoodi pysyvät luottamuksellisina.
Työkalut
- React
- TypeScript
- Gemini