Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info
titleMallitoteutuksen kuvaus

Tässä kuvataan AuroraAI-ohjelmassa luotuja toiminnallisuuksia. Niiden lähdekoodit ovat hyödynnettävissä.


Suosittelija

Organisaatio voi ottaa AuroraAI-suosittelijan käyttöön digitaalisissa palveluissa, kuten verkkopalvelussa, mobiilisovelluksessa tai chattibotissa. Suosittelijan avulla käyttäjälle tarjotaan palveluita hänen itse käyttöliittymässä antamiensa tietojen perusteella.

Suosittelut pohjautuvat antamiin elämäntilannetietoihin

Loppukäyttäjä antaa tilanteestaan tietoja AuroraAI-verkkoon kytkeytyneessä palvelussa. Käyttäjän tilanteesta voidaan kysyä tietoja esimerkiksi eri elämänalueita kartoittavalla kyselylomakkeella tai chat-keskustelun aikana.

Tämän jälkeen käyttäjän antamat tiedot lähetetään AuroraAPI-rajapinnan kautta suosittelijalle. Suosittelija etsii annettuja tietoja hyödyntäen Palvelutietovarannosta sopivia palveluita ja palauttaa suositeltavien palvelujen ja asiointikanavien tiedot rajapintaa pitkin takaisin. Tämän jälkeen palvelu, jossa käyttäjä on, voi näyttää saadut suositukset käyttäjälle.

Kaksi suosittelijavaihtoehtoa

Tarjolla on kaksi suosittelijavaihtoehtoja

  1.     vapaatekstisuosittelija
  2.     3x10D-suosittelija

Vapaatekstisuosittelija suosittelee palveluita PTV:n palvelukuvausten ja käyttäjän syöttämän hakulauseen vastaavuuteen perustuen.

3x10D-suosittelija perustuu Diakonia-ammattikorkeakoulun (Diak) tutkijoiden kehittämä elämäntilannemittari, jonka avulla on mahdollista kartoittaa käyttäjän elämäntilannetta. Kyselyssä käyttäjä vastaa asteikolla 1–10, miten tyytyväinen hän on seuraaviin elämänsä osa-alueisiin:

•    opiskelu tai työ
•    perhe
•    ystävät
•    terveys
•    itsensä kehittäminen
•    asuminen
•    raha-asiat
•    itsetunto
•    vaikeuksien voittaminen
•    yleinen tyytyväisyys elämään.

Kun käyttäjä on vastannut kyselyyn, suosittelija hakee käyttäjän 3x10D-elämäntilanteisiin sopivia palveluja. 3x10D-elämänalueiden lisäksi rajapintaan voi antaa tiedon vastaajan kotikunnasta. Suositteluja on mahdollista hakea myös vaikka vain yhden elämänalueen osalta. Rajapinta palauttaa vastauksessaan palvelut, jotka parhaiten sopivat eri elämänalueista saatuihin tietoihin ja ovat yhdistelmä kaikista annetuista tiedoista.

Suosittelijan räätälöinti

Suosittelijan toimintaa on mahdollista räätälöidä oman asiakaskunnan tarpeisiin sopivaksi rajaamalla suositeltavia palveluita kohderyhmän, palveluluokan tai palveluiden aluetiedon perusteella. Suosittelijaa varten on mahdollista määritellä Palvelutietovarantoon myös rajattu palvelukokonaisuus, johon liitettyjen palveluiden joukosta suosittelija poimii tarvittavat palvelut.

Palveluhakemisto

AuroraAI-palveluhakemisto kokoaa palveluita Suomi.fi-palvelutietovarannosta ja verkkoon liittyneiden palvelujen rajapinnoista. Jotta saisit organisaatiosi palvelun näkymään AuroraAI-suosittelijan palvelusuosituksissa, sinun tulee kuvata se Palvelutietovarantoon.

Palvelutietovaranto on Digi- ja väestötietoviraston ylläpitämä keskitetty tietovaranto, johon palvelut kuvataan asiakaslähtöisesti, yhdenmukaisen mallin avulla.

Konsepti

Excerpt

Suosittelijan yleiskuvaus on julkaistu osoitteessa Suosittelija | Suomidigi.

Suosittelija mahdollistaa palveluehdotusten tekemisen käyttäjälle perustuten tämän syöttämiin tietoihin. Suositteluun ei välttämättä tarvitse käyttää AuroraAI-tiliä (ks. Profiilinhallinta), mutta sen tietoja voidaan käyttäjän luvalla hyödyntää suosittelussa. 

Suosittelijaan voidaan tehdä tehdä API-kutsuja, jotka on tarkemmin määritelty Swaggerissa

Suosittelijan dokumentaatio

Children Display

Info
titleTermistö

AuroraAI:n sanastoa voi tarkastella täältä.

...

Käyttötapaus: Kirjautumattoman käyttäjän tietojen siirtäminen suosittelun yhteydessä

Info

Kirjautumattoman käyttäjän tietoja ei voida tallentaa.

Suosittelijan käyttö on mahdollista, kun käyttäjä on antanut palvelulle X luvan tietojen välittämiseen suosittelijalle.

Käyttäjän antamien tietojen siirtäminen palvelusta X palveluun Y on mahdollista, kun käyttäjä antaa luvan palvelulle X siirtää tietoja palvelully Y.

Verkkoon liittynyt palvelu pystyy ottamaan vastaan tietoja, kun

  • Käyttäjä on antanut tähän luvan (suostumuksen)
  • Palvelulla on lupa AuroraAPI-rajapinnan käyttöön 
  • Palvelu on ottanut AuroraAPI-rajapinnan käyttöön

Kirjautumattoman käyttäjän tietojen tallentaminen:

  1. Käyttäjä avaa palvelun X
  2. Käyttäjä antaa tietoja suosittelujen muodostamiseksi
  3. Käyttäjä antaa luvan tietojen välittämiseen suosittelijalle
  4. Käyttäjä valitsee suositeltavan palvelun Y
  5. Käyttäjä antaa luvan tietojen siirtoon hyödynnettäväksi suositellulle palvelulle
  6. Käyttäjä siirtyy palveluun Y

...