01
Kuinka usein sivusto luetaan uudelleen?
Kerran vuorokaudessa, yöaikaan. Kuntelo käy sivuston läpi samalla tavalla kuin ensimmäisellä kerralla ja vertaa tulosta edelliseen.
Kuntelo/Näin se toimii
Sivustosta neuvojaksi kolmessa vaiheessa.
Kuntelo lukee sivuston, järjestää sen sisällön hakemistoksi ja vastaa kysymyksiin sen perusteella. Sivusto luetaan uudelleen joka yö, joten neuvoja tietää saman kuin sivustosi.
// lue · järjestä · vastaaascii
// Vaihe 1
Sivusto luetaan.
Anna verkko-osoite. Kuntelo käy sivuston läpi samaan tapaan kuin hakukone, mutta vain sinun sivustosi.
Miten Kuntelo toimii?
Kuntelo tekee kolme asiaa: lukee sivuston, järjestää sen sisällön hakemistoksi ja vastaa kysymyksiin sen perusteella. Kaikki alkaa lukemisesta.
Käykö Kuntelo läpi kaikki sivuston alasivut?
Kyllä. Kuntelo lukee ensin sivuston sivukartan ja seuraa sen jälkeen jokaista linkkiä, kunnes uusia sivuja ei enää löydy. Mukaan tulevat etusivu, alasivut, uutiset, tapahtumat ja liitteinä olevat PDF-tiedostot. Sivuston ulkopuolelle johtavia linkkejä se ei seuraa.
Lukeeko Kuntelo myös PDF-tiedostot?
Kyllä. Pöytäkirjat, esityslistat, esitteet ja lomakeohjeet ovat kunnan sivustolla usein PDF-muodossa, ja ne ovat botille yhtä lailla lähteitä kuin tavalliset sivut. Kuvat, videot ja Office-tiedostot ohitetaan.
Noudattaako Kuntelo robots.txt-ohjeita?
Kyllä. Ennen ensimmäistäkään sivupyyntöä Kuntelo lukee sivuston robots.txt-tiedoston ja noudattaa sen kieltoja. Jos jokin osa sivustosta on kielletty hakuroboteilta, Kuntelo ei mene sinne.
Jätetäänkö noindex-sivut pois?
Kyllä. Sivu, jonka julkaisija on merkinnyt hakukoneilta piilotettavaksi, ei päädy botin tietoihin. Näin esimerkiksi julkaisujärjestelmän vanhat arkistosivut pysyvät poissa vastauksista, vaikka ne olisivat suoralla osoitteella yhä luettavissa. Jos jokin tällainen sivu halutaan silti mukaan, sen voi lisätä käsin.
Kuormittaako sivuston lukeminen palvelintani?
Ei. Kuntelo hakee sivuja rauhalliseen tahtiin, yhden kerrallaan samalta palvelimelta, ja hidastaa tahtia entisestään, jos palvelin vastaa kiireiseksi. Tavallinen sivusto ei huomaa lukemista mitenkään. Kuntelo myös ohittaa listaussivut, jotka vain toistavat muualta löytyvää sisältöä, kuten avainsanasivut ja kalenterin kuukausinäkymät, joten turhia pyyntöjä ei tehdä.
// lukeminenascii
// Vaihe 2
Sisältö järjestetään hakemistoksi.
Sivuilta karsitaan kaikki, mikä ei ole sisältöä, ja loput järjestetään niin, että oikea kohta löytyy kysymyksen perusteella.
Miten sivustoni sisältö indeksoidaan?
Jokaisesta luetusta sivusta otetaan talteen varsinainen sisältö, ja se pilkotaan sopivan kokoisiin osiin, esimerkiksi yhteen osioon tai muutamaan kappaleeseen kerrallaan. Jokaisesta osasta Kuntelo laskee sen merkitystä kuvaavan tunnisteen ja tallentaa sen yhdessä tekstin ja sivun osoitteen kanssa. Lisäksi jokaisesta sivusta kirjoitetaan lyhyt kuvaus siitä, mitä sivu käsittelee, jotta hakemisto tietää myös asiayhteyden.
Karsitaanko navigaatiot ja evästeilmoitukset pois?
Kyllä. Valikot, ylä- ja alatunnisteet, evästeilmoitukset ja muut jokaisella sivulla toistuvat lohkot poistetaan ennen tallennusta. Kuntelo tunnistaa ne kahdella tavalla: sivun rakenteesta ja siitä, että sama teksti toistuu suurella osalla sivuista. Näin botti ei koskaan vastaa "Hyväksy evästeet" tai luettele valikon kohtia lähteenä.
Miten haku toimii teknisesti?
Kun kävijä kysyy jotain, Kuntelo etsii hakemistosta ne osat, jotka vastaavat kysymystä parhaiten. Haku tehdään kahdella tavalla yhtä aikaa: sanojen perusteella, jolloin täsmälleen samat termit löytyvät varmasti, ja merkityksen perusteella, jolloin löytyy myös sisältö, joka puhuu samasta asiasta eri sanoin. Kahden haun tulokset yhdistetään ja parhaat kohdat annetaan vastauksen pohjaksi.
Mitä tarkoittaa vektorihaku ja BM25?
Ne ovat noiden kahden hakutavan tekniset nimet. BM25 on hakukoneiden käyttämä sanahaku, joka pisteyttää sivut sen mukaan, kuinka hyvin kysymyksen sanat esiintyvät niissä. Vektorihaku vertaa merkityksiä: jokaisesta tekstinpätkästä on laskettu numerosarja, joka kuvaa sen sisältöä, ja samasta asiasta puhuvat tekstit saavat samankaltaiset numerosarjat. Siksi kysymys "Mihin vien vanhan jääkaapin?" löytää sivun, jossa puhutaan sähkö- ja elektroniikkaromun keräyksestä, vaikka sana jääkaappi ei esiintyisi siinä lainkaan. Kuntelo käyttää molempia, koska kumpikin löytää asioita, jotka toiselta jäisivät huomaamatta.
// karsintaascii
// Vaihe 3
Botti vastaa.
Kysymys ymmärretään keskustelun valossa, sopivin sisältö haetaan ja vastaus kirjoitetaan sen pohjalta.
Mistä Kuntelo hakee vastauksensa?
Ainoastaan sivustosi sisällöstä: sivuilta ja PDF-tiedostoista, jotka se on lukenut. Kuntelo ei hae tietoa muualta internetistä eikä käytä tekoälyn yleistietoa vastauksen sisältönä.
Vastaako botti vain sivustoni sisällön perusteella?
Kyllä. Jokainen vastaus perustuu sivustolta haettuihin kohtiin, ja vastauksen alla näytetään, mitkä ne olivat. Jos haluat, botille voi lisäksi antaa vahvistettuja vastauksia tiettyihin kysymyksiin, esimerkiksi silloin kun sivustolla oleva tieto on tulkinnanvarainen. Nekin ovat sinun kirjoittamiasi, eivät tekoälyn.
Mitä tapahtuu, jos vastausta ei löydy sivustolta?
Kuntelo kertoo, ettei löytänyt tietoa sivustolta, ja neuvoo ottamaan yhteyttä suoraan. Tekstin voi muotoilla itse, esimerkiksi ohjaamaan kunnan neuvontaan tai yrityksen asiakaspalveluun. Vastaamatta jääneet kysymykset kootaan listaksi hallintanäkymään, joten näet, mitä kävijät kysyvät ja mitä sivustolta puuttuu.
Keksiikö botti koskaan vastauksia?
Kuntelo on ohjeistettu vastaamaan vain lähteiden perusteella ja sanomaan, kun tietoa ei ole. Tekoälyä käytetään vastauksen muotoiluun, ja siksi sanamuoto voi joskus olla epätarkka. Siksi jokaisen vastauksen alla ovat lähteet: kävijä voi tarkistaa asian alkuperäiseltä sivulta, ja sinä voit merkitä väärän vastauksen hallintanäkymässä ja korjata sen. Lisää aiheesta sivulla Kielet ja rajoitukset.
Näyttääkö botti lähteet vastauksilleen?
Kyllä, aina. Kuntelo listaa vain ne sivut, joita se oikeasti käytti vastaukseen, ei kaikkia hakutuloksia. Jos vastaus perustuu kahteen sivuun, lähteitä on kaksi.
Miten lähteet näytetään käyttäjälle?
Vastauksen alla on Lähteet-otsikko ja sen alla linkit sivujen omilla otsikoilla. Linkki avaa sivun uuteen välilehteen. Halutessasi linkkien viereen voi näyttää myös sivun kuvan, jos sivustollasi on sellaiset.
Ymmärtääkö botti aiemman keskustelun?
Kyllä. Kuntelo lukee kysymyksen keskustelun valossa. Jos kävijä kysyy ensin kirjaston aukioloajoista ja sitten "Entä sunnuntaina?", Kuntelo ymmärtää, että kysymys koskee yhä kirjastoa. Keskustelu jatkuu myös, kun kävijä siirtyy sivustolla sivulta toiselle.
// vastausascii
// Päivitykset
Aina ajan tasalla.
Sivusto luetaan uudelleen joka yö. Kenenkään ei tarvitse muistaa päivittää bottia.
02
Päivittyvätkö muuttuneet sivut automaattisesti?
Kyllä. Jos sivun sisältö on muuttunut, sen vanha versio korvataan hakemistossa uudella. Muuttumattomiin sivuihin ei kosketa, joten päivitys on nopea myös suurella sivustolla.
03
Poistuvatko poistetut sivut botin tiedoista?
Kyllä. Sivu, jota ei enää löydy sivustolta tai joka on merkitty piilotettavaksi, poistetaan hakemistosta seuraavassa yöllisessä lukukerrassa. Botti ei siis vastaa vanhentuneilla sivuilla, jotka on jo otettu pois sivustolta.
04
Kuinka nopeasti uusi sivu näkyy botin vastauksissa?
Viimeistään seuraavana aamuna, kun sivusto on luettu yöllä uudelleen. Jos sivu tarvitaan bottiin heti, sen voi lisätä osoitteella hallintanäkymän Lähteet-sivulta, jolloin se luetaan muutamassa minuutissa.
05
Voinko pakottaa sivuston uudelleenluvun heti?
Kyllä. Hallintanäkymän Lähteet-sivulla on painike, joka käynnistää koko sivuston uudelleenluvun heti, ja yksittäisen sivun voi lukea uudelleen erikseen. Näin esimerkiksi kiireellinen tiedote saadaan bottiin samalla hetkellä, kun se julkaistaan.
Kokeile ensin, päätä sitten.
Botti tällä sivustolla on oikea Kuntelo, joka on lukenut nämä sivut. Kysy siltä, ja ota sitten yhteyttä, niin katsotaan sivustollesi sopiva toteutus.