- Created by Unknown User (aliisa.palm@gofore.com), last modified on 07.12.2022
AuroraAI-chatbotista löytyy seuraavan tyyppisiä palvelusuosittelutoiminnallisuuksia:
Vapaatekstihakuun pohjautuva palvelusuosittelija
Konsepti
- Palvelusuosittelijan käyttö tapahtuu kutsumalla custom actionia Botfrontissa jossain kohdassa tarinaa. (https://botfront.io/docs/rasa/custom-actions)
- Kutsuttavan custom actionin nimi voi vaihdella botin mukaan, koska custom actionilta voidaan vaatia erilaisia toiminnallisuuksia eri käyttötapauksissa, ja samassa botissa voi teoriassa olla useita custom actioneja, jotka kutsuvat samaa palvelusuosittelijaa.
- Vapaatekstihakuun perustuvaa palvelusuosittelijaa voidaan kutsua kahdella eri "actionilla" riippuen esitystavasta:
- action_service_list_by_text_search -niminen action palauttaa palvelut listoina
- action_service_carousel_by_text_search -niminen action palauttaa palvelut karusellina
- Vapaatekstihakuun perustuvaa palvelusuosittelijaa voidaan kutsua kahdella eri "actionilla" riippuen esitystavasta:
- Palvelusuositukset perustuvat palveluiden palvelukuvausten sisällön ja hakutekstin samankaltaisuuteen.
- Hakuteksti täytyy tallentaa sille varattuun slottiin (taulukko: Vapaatekstihaun parametrit).
- Palvelusuosittelijan tuloksiin voidaan vaikuttaa myös suodatusparametreilla, jotka on listattu alemmassa taulukossa (Tulosten suodatusparametrit).
Käyttöohje
- Luo bottiin tarvittavat slotit
- Toiminnalliset slotit ovat pakollisia (ks. Toiminnalliset slotit)
- Suositteluun vaikuttavat slotit lisätään tarpeen mukaan (ks. Suositteluun liittyvät slotit)
- Nimeä slot ao. taulukoiden mukaan (ks. slotin nimi)
- Valitse slotin tyyppi ao. taulukoiden mukaan (ks. slotin tyyppi)
- HUOM! kaikista sloteista tulee disabloida "influence conversation" merkintä.
- Täytä slotit keskustelupolussa tai formilla
- Varmista (esim. formin validoinnissa) että slotin arvot on ao. taulukoiden mukaiset (ks. slotin hyväksytyt arvot)
- keskustelupolku ja/tai form on tehtävä Botfrontissa (kuiskaajan tehtävä). Polkuun/formiin upotetaan konseptin mukaisia 3x10D kyselyn kysymyksiä, eli kysytään 14–17 -vuotiaan nykytilanteesta.
- Kutsu palvelusuosittelija-actionia. Esimerkiksi haluttaessa esittää palvelut listana, kutsuttava action on action_service_list_by_life_situation.
Vapaatekstihaun parametrit
Parametri (filters) | slotin nimi | slotin tyyppi | slotin hyväksytyt arvot | esimerkkiarvo | apin parametri | Lisätiedot |
|---|---|---|---|---|---|---|
| Tekstihaun vapaateksti * | sr_param_search_text | text | lasten palvelut | search_text | ||
| Tulosten määrä | sr_param_result_limit | text | {0, 1, ... 49, 50} | 5 | limit | |
| Tulosten järjestys | sr_param_rerank | bool | true/false | true | rerank | Setting this value to true reranks recommendations based on feedback from users. Set to false returns values in decreasing order of similarity. |
*Pakollinen parametri
Elämäntilannemittareihin (3x10D) perustuva palvelusuosittelija
Taustatietoja 3x10D-kyselystä
3x10D on DIAK:n kehittämä elämäntilannemittari, jolla on tarkoitus kartoittaa henkilön tai perheen tilannetta ja elämän laatua. Mittari on käytännössä itsearviontikysely, johon henkilö tai perhe vastaa antamalla arvoja asteikolta 1-10.
Kyselyt ovat ikäluokkakohtaisia (ikäluokat ja mittarit on listattu täällä: https://www.terveysportti.fi/apps/dtk/tmi/article/tmm00192?toc=802599)
- 7–9 -vuotiaille suunnattu lomake
- 10–13 -vuotiaille suunnattu lomake
- 14–17 -vuotiaille suunnattu lomake
- täysi-ikäisille suunnattu lomake
- perheille suunnattu lomake
Jokaisessa kyselyssä on 10 kysymystä, joita voi esittää kolmesta ajallisesta näkökulmasta:
- kysymyksen painoarvo henkilön tai perheen elämässä (eli kuinka tärkeä ko. asia on)
- tyytyväisyys ko. asiaan (nykytilanne)
- tavoitteet ko. asiaan liittyen (mitä toivoo tulevaisuudessa)
Konsepti
- Palvelusuosittelijan käyttö tapahtuu kutsumalla custom actionia Botfrontin tarinassa. (https://botfront.io/docs/rasa/custom-actions)
- Kutsuttavan custom actionin nimi voi vaihdella botin mukaan, koska custom actionilta voidaan vaatia erilaisia toiminnallisuuksia eri käyttötapauksissa, ja samassa botissa voi teoriassa olla useita custom actioneja, jotka kutsuvat samaa palvelusuosittelijaa.
- Elämäntilannemittareihin perustuvaa palvelusuosittelijaa voidaan kutsua kahdella eri actionilla riippuen esitystavasta:
- action_service_list_by_life_situation -niminen action palauttaa palvelut listoina
- action_service_carousel_by_life_situation -niminen action palauttaa palvelut karusellina
- Elämäntilannemittareihin perustuvaa palvelusuosittelijaa voidaan kutsua kahdella eri actionilla riippuen esitystavasta:
- Palvelusuositukset perustuu elämäntilanneparametrien arvoihin, jotka välitetään palvelusuosittelijalle kutsun yhteydessä.
- Kunkin elämäntilanneparametrin arvo täytyy tallentaa botissa alla olevan taulukon (Elämäntilannemittarin parametrit) mukaiseen slottiin jotta ko. arvo välittyy palvelusuosittelijalle.
- Palvelusuosittelijan tuloksiin voidaan vaikuttaa myös suodatusparametreilla, jotka on listattu alemmassa taulukossa (Tulosten suodatusparametrit).
- Tällä sivulla kuvattu konsepti perustuu kyselyyn, joka on suunnattu 14–17 -vuotiaille ja ajallinen näkökulma on nykytilanne.
Käyttöohje
- Luo bottiin tarvittavat slotit
- Toiminnalliset slotit ovat pakollisia (kts. Toiminnalliset slotit)
- Suositteluun vaikuttavat slotit lisätään tarpeen mukaan (kts. Suositteluun liittyvät slotit)
- Nimeä slot alla esitettyjen taulukoiden mukaan (kts. slotin nimi)
- Valitse slotin tyyppi alla esitettyjen taulukoiden mukaan (kts. slotin tyyppi)
- HUOM! kaikista sloteista tulee disabloida "influence conversation" -merkintä
- Täytä slotit storyssa tai formissa (tarinatyypit)
- Varmista (esim. formin validoinnissa) että slotin arvot on alla esitettyjen taulukoiden mukaiset (kts. slotin hyväksytyt arvot)
- Story ja/tai form on tehtävä Botfrontissa (kuiskaajan tehtävä). Storyyn/formiin upotetaan konseptin mukaisia 3x10D kyselyn kysymyksiä, eli kysytään 14-17 -vuotiaan nykytilanteesta.
- Kutsu palvelusuosittelija-actionia. Esimerkiksi haluttaessa palvelut listana esitettyinä, kutsuttava action on action_service_list_by_life_situation.
Elämäntilannemittareihin perustuvan suosittelun slotit
Elämäntilannemittarin parametrit
| Parametri (3x10D) | slotin nimi | slotin tyyppi | slotin hyväksytyt arvot | apin parametri | Lisätiedot Linkittyvä 3x10D kyselyn kysymys (14–17 -vuotiaille suunnattu kysely) |
|---|---|---|---|---|---|
| Perhe | 3x10d_family | text | {0,1,2,3,4,5,6,7,8,9,10} | family | Linkittyvä 3x10D kyselyn kysymys: "Kun ajattelet nykyhetkeä, niin kuinka tyytyväinen olet seuraaviin asioihin? #5: perheesi |
| Raha-asiat | 3x10d_finance | text | {0,1,2,3,4,5,6,7,8,9,10} | finance | Linkittyvä 3x10D kyselyn kysymys: "Kun ajattelet nykyhetkeä, niin kuinka tyytyväinen olet seuraaviin asioihin? #7: taloudelliseen tilanteeseesi |
| Ystävät | 3x10d_friends | text | {0,1,2,3,4,5,6,7,8,9,10} | friends | Linkittyvä 3x10D kyselyn kysymys: "Kun ajattelet nykyhetkeä, niin kuinka tyytyväinen olet seuraaviin asioihin? #6: luotettavien ystävien määrään |
| Terveys | 3x10d_health | text | {0,1,2,3,4,5,6,7,8,9,10} | health | Linkittyvä 3x10D kyselyn kysymys: "Kun ajattelet nykyhetkeä, niin kuinka tyytyväinen olet seuraaviin asioihin? #1: terveydentilaasi |
| Asuminen | 3x10d_housing | text | {0,1,2,3,4,5,6,7,8,9,10} | housing | Linkittyvä 3x10D kyselyn kysymys: "Kun ajattelet nykyhetkeä, niin kuinka tyytyväinen olet seuraaviin asioihin? #3: asumisoloihisi |
| Opiskelu ja työ | 3x10d_working_studying | text | {0,1,2,3,4,5,6,7,8,9,10} | working_studying | Linkittyvä 3x10D kyselyn kysymys: "Kun ajattelet nykyhetkeä, niin kuinka tyytyväinen olet seuraaviin asioihin? #4: päivittäiseen pärjäämiseesi |
| Itsensä kehittäminen | 3x10d_improvement_of_strengths | text | {0,1,2,3,4,5,6,7,8,9,10} | improvement_of_strengths | Linkittyvä 3x10D kyselyn kysymys: "Kun ajattelet nykyhetkeä, niin kuinka tyytyväinen olet seuraaviin asioihin? #8: omien vahvuuksiesi kehittämiseen (esim. harrastamalla mieluisia asioita) |
| Vaikeuksien voittaminen | 3x10d_resilience | text | {0,1,2,3,4,5,6,7,8,9,10} | resilience | Linkittyvä 3x10D kyselyn kysymys: "Kun ajattelet nykyhetkeä, niin kuinka tyytyväinen olet seuraaviin asioihin? #2: kykyysi voittaa elämässä eteen tulevia vaikeuksia |
| Tyytyväisyys elämään | 3x10d_life_satisfaction | text | {0,1,2,3,4,5,6,7,8,9,10} | life_satisfaction | Linkittyvä 3x10D kyselyn kysymys: "Kun ajattelet nykyhetkeä, niin kuinka tyytyväinen olet seuraaviin asioihin? #10: elämääsi kokonaisuutena |
| Itsetunto | 3x10d_self_esteem | text | {0,1,2,3,4,5,6,7,8,9,10} | self_esteem | Linkittyvä 3x10D kyselyn kysymys: "Kun ajattelet nykyhetkeä, niin kuinka tyytyväinen olet seuraaviin asioihin? #9: itsetuntoosi Parametri ei ole dokumentoitu tietomalliin. * |
Muut parametrit
Parametri (filters) | slotin nimi | slotin tyyppi | slotin hyväksytyt arvot | esimerkkiarvo | apin parametri | Lisätiedot |
|---|---|---|---|---|---|---|
| Tulosten määrä | sr_param_result_limit | text | {0, 1, ... 49, 50} | 5 | limit | |
| Tulosten järjestys | sr_param_rerank | bool | true/false | true | rerank | Setting this value to true reranks recommendations based on feedback from users. Set to false returns values in decreasing order of similarity. |
*parametria ei löydy dokumentaatiosta (https://tietomallit.suomi.fi/model/aurora-att/Elamantilanne/), mutta sitä käytetään api-rajapinnan hakuparametrina (https://auroraai.astest.suomi.fi/service-recommender/v1/docs/#/)
Tulosten suodatusparametrit
Parametri (filters) | slotin nimi | slotin tyyppi | slotin hyväksytyt arvot (ks. koodistot) | esimerkkiarvo | apin parametri | Lisätiedot |
|---|---|---|---|---|---|---|
| Kunta | sr_filter_municipality | list | kuntakoodit | 091 | municipality_codes | Palvelusuosittelijoiden rajauskentät |
| Maakunta | sr_filter_region | list | maakuntakoodit | 01 | region_codes | Palvelusuosittelijoiden rajauskentät |
| Sairaanhoitopiiri | sr_filter_hospital_district | list | sairaanhoitopiirikoodit | 03 | hospital_district_codes | Palvelusuosittelijoiden rajauskentät |
| Palveluluokka | sr_filter_service_class | list | julkisten palveluiden | P1 | service_classes | Palvelusuosittelijoiden rajauskentät |
| Kansalliset palvelut | sr_filter_include_national_services | bool | 1/0/yes/no | 1 | include_national_services | Palvelusuosittelijoiden rajauskentät |
| Tulosten määrä | sr_param_result_limit | text | {0, 1, ... 49, 50} | 5 | limit |
Koodistot:
- Hyväksyttyjen kuntakoodien lista: https://koodistot.suomi.fi/codescheme;registryCode=jhs;schemeCode=kunta_1_20220101
- Hyväksyttyjen maakuntakoodien lista: https://koodistot.suomi.fi/codescheme;registryCode=jhs;schemeCode=maakunta_1_20220101
- Hyväksyttyjen sairaanhoitopiirikoodien lista: https://koodistot.suomi.fi/codescheme;registryCode=jhs;schemeCode=sairaanhoitop_1_20220101
- Hyväksyttyjen palveluluokkakoodien lista: https://koodistot.suomi.fi/codescheme;registryCode=ptv;schemeCode=ptvserclass2
Toiminnalliset slotit ja intentit
slotit
| slotin nimi | slotin tyyppi | Lisätiedot |
|---|---|---|
| sr_recommended_services | text | Tähän tallennetaan palautetut palvelusuositukset. |
| sr_button_pressed | text | Tämä slot täytetään intentin sr.buttonpressed tapahtuessa. Tällöin slot saa tiedon siitä mitä nappia on painettu ja siten action (action_show_info) osaa hakea oikeat tiedot ruudulle. (ks. esimerkki rule oikealla) |
intentit
| Intent | Entiteetti | Tarkoitus |
|---|---|---|
| sr.buttonpressed | sr_button_pressed | Aina kun palvelukortin nappia painetaan, intentti täyttää slotin entiteetin perusteella, ja tämän jälkeen voidaan kutsua actionia (action_show_info), joka näyttää kyseisen napin osoittamat tiedot. (ks. kuva oikealla) |
- No labels