# Kielet ja lokalisointi

URL: https://aihio.ai/ohjekeskus/tekoalyagentti/kielet
Kuvaus: Chatbotin kieli on kolme eri asiaa: vastausten kieli, widgetin käyttöliittymän kieli ja tietopohjan hakukieli.

Chatbotin kieli ei ole yksi kytkin vaan **kolme erillistä asiaa**. Ne säädetään erikseen, koska ne vaikuttavat eri asioihin ja eri hetkinä. Useimmat chatbot-alustat niputtavat nämä yhdeksi "kieli"-asetukseksi; Aihiossa ne on eroteltu, koska suomenkielinen haku ja suomenkielinen vastaus ovat oikeasti eri ongelmia.

| Akseli                    | Missä säädetään              | Mihin vaikuttaa                            |
| ------------------------- | ---------------------------- | ------------------------------------------ |
| **Vastausten kieli**      | Asetukset → Kielet           | Millä kielellä botti kirjoittaa            |
| **Käyttöliittymän kieli** | Muokkain → Ulkoasu → Kieli   | Widgetin omat painikkeet ja ilmoitukset    |
| **Tietopohjan hakukieli** | Tietopohja, lähdekohtaisesti | Millä kielioppisäännöillä lähteitä haetaan |

Asetukset → **Kielet** näyttää kaikkien kolmen tilan yhdellä silmäyksellä.

## 1. Vastausten kieli

Kaksi vaihtoehtoa:

- **Automaattinen.** Botti vastaa sillä kielellä, jolla asiakas kirjoittaa.
- **Aina suomi / Aina englanti.** Botti vastaa aina valitulla kielellä, riippumatta siitä millä kielellä asiakas kirjoittaa. **Lukko voittaa aina.**

Automaattisessa tilassa kieli **tahmenee**: lyhyet täytesanat kuten "ok", "kiitos" tai "thanks" eivät vaihda keskustelun kieltä. Vasta selkeä, riittävän pitkä viesti toisella kielellä vaihtaa sen. Tämä estää sen tyypillisen ärsytyksen, jossa botti hyppii kielestä toiseen kesken keskustelun.

Jos kieltä ei voi varmuudella päätellä, botti ei arvaa vaan käyttää suomea.

### Mitä vastauskieli muuttaa

Vastauskieli ei ole viimeistelykerros. Se muuttaa useaa asiaa kerralla:

- **Suomen kirjoitussäännöt** ovat käytössä vain suomeksi vastaavilla boteilla.
- **Puhuttelumuoto** (sinuttelu tai teitittely) koskee vain suomea.
- **Ehdotetut jatkokysymykset** kirjoitetaan samalla kielellä. Lukitulla botilla ne pysyvät lukitussa kielessä, vaikka asiakas kirjoittaisi toisella.
- **Toimintokorttien ohjeistus** on englanniksi vain, kun vastauskieli on lukittu englanniksi. Automaattisessa tilassa ohjeistus on suomeksi eikä vaihdu kävijän viestin mukana.

### Suomi ja englanti ovat syvyyskieliä, muut toimivat silti

Botti vastaa myös saksaksi, ranskaksi tai espanjaksi, jos asiakas kirjoittaa niin ja vastauskieli on Automaattinen. Malli peilaa kielen, ja haku toimii, koska upotukset ovat monikieliset.

Suomi ja englanti saavat lisäksi **syvyyskäsittelyn**, jota muut kielet eivät vielä saa: deterministinen kielilukko, taivutustietoinen avainsanahaku ja suomalainen numeromuoto. Lukitus (Aina suomi / Aina englanti) koskee siis vain näitä kahta.

## 2. Widgetin käyttöliittymän kieli

Tämä on widgetin **omien tekstien** kieli: lähetä-painike, valikko, virheilmoitukset. Se ei ole sama asia kuin vastausten kieli, ja ne saavat vapaasti olla eri.

Muokkaimessa on yksi lista, jossa jokainen rivi on kieli jonka widget saa näyttää, ja yksi niistä on merkitty oletukseksi:

> Widget näkyy kävijän selaimen kielellä, jos se on listalla. Muuten käytetään oletuskieltä.

Listan olemassaolo **on** lupa vaihtaa kieltä. Jos haluat että widget on aina suomeksi, jätä listalle vain suomi – silloin selaimen tunnistuksella ei ole mihin osua.

Erillistä "automaattinen"-valintaa ei ole, koska sitä ei tarvita: lista kertoo jo mihin kieliin tunnistus saa osua.

### Kielivalitsin kävijälle

Erillinen asetus lisää widgetin valikkoon kielivalinnan. Se näkyy vasta kun sallittuja kieliä on **vähintään kaksi**. Kävijän valinta muistetaan seuraavillekin käynneille.

Jos poistat myöhemmin kielen, jonka kävijä oli valinnut, kävijä siirtyy hallitusti seuraavaan sallittuun kieleen.

### Ruotsi

Ruotsin käyttöliittymäkielestä on luonnos, joka odottaa äidinkielisen tarkistusta, eikä sille luvata vielä tuotantotukea. Se ei missään tapauksessa muuta vastausten kieltä eikä tietopohjan hakua.

## 3. Tietopohjan hakukieli

Jokaisen lähteen kieli tunnistetaan **erikseen** sen sisällöstä indeksoinnin yhteydessä. Sama botti voi siis palvella suomenkielistä käyttöohjetta ja englanninkielistä hinnastoa, ja haku käyttää kummallekin oikeita kielioppisääntöjä.

Tällä on käytännön merkitys: suomenkielinen haku osaa taivutusmuodot. Kysymys "paljonko verot on" osuu tekstiin, jossa lukee "verotuksen määrä".

Jos jokin lähde tunnistetaan väärälle kielelle, voit korjata sen Tietopohjan lähdenäkymästä. Korjaus indeksoi lähteen uudelleen ja säilyy, vaikka lähde haettaisiin myöhemmin uudelleen.

**Uusien lähteiden varakieli** (Asetukset → Kielet) on se kieli, jota käytetään vain silloin kun lähteen omaa kieltä ei voi päätellä. Se ei ohita tunnistusta eikä käsin tehtyä korjausta.

## Mitä oikeasti tapahtuu: esimerkkejä

### Vastauskieli on Aina englanti, asiakas kirjoittaa suomeksi

1. **Haku tehdään suomeksi.** Hakukieli päätellään kysymyksestä, ei vastausasetuksesta, joten suomenkielinen kysymys osuu suomenkielisiin lähteisiin taivutusmuotoineen.
2. **Vastaus tulee englanniksi.** Lukko voittaa tunnistuksen.
3. **Jatkokysymykset ovat englanniksi.**
4. **Widgetin käyttöliittymä ei muutu** – se on oma akselinsa.

Lopputulos: suomenkielinen tietopohja palvelee kansainvälistä asiakaskuntaa ilman että sisältöä täytyy kääntää. Tämä on tuettu yhdistelmä, ei virhe.

### Vastauskieli on Automaattinen, asiakas kirjoittaa saksaksi

Botti vastaa saksaksi. Haku nojaa monikieliseen upotushakuun, koska saksalle ei ole taivutustietoista avainsanahakua. Vastaus on käyttökelpoinen, mutta suomen ja englannin syvyyskäsittelyä siihen ei sovelleta.

### Kävijän selain on englanninkielinen, listalla on vain suomi

Widgetin käyttöliittymä näkyy suomeksi. Vastausten kieli määräytyy erikseen omasta asetuksestaan.

### Kävijä vaihtaa kielen valikosta

Vain käyttöliittymä vaihtuu. Vastausten kieli ei muutu – jos botti on lukittu suomeen, se vastaa suomeksi vaikka kävijä lukisi käyttöliittymää englanniksi.

## Milloin mitäkin kannattaa muuttaa

| Tilanne                                                                          | Muuta tätä                                  |
| -------------------------------------------------------------------------------- | ------------------------------------------- |
| Asiakkaat kirjoittavat monella kielellä ja haluat palvella heitä heidän omallaan | Vastauskieli → Automaattinen                |
| Haluat että botti vastaa aina yrityksesi kielellä                                | Vastauskieli → Aina suomi tai Aina englanti |
| Sivustollasi käy muunkielisiä kävijöitä                                          | Lisää kieli widgetin kielilistaan           |
| Botti taivuttaa tuote- tai viranomaistermejä väärin                              | Suojatut termit (Asetukset → Kielet)        |
| Haku ei osu johonkin lähteeseen odotetusti                                       | Tarkista sen kieli Tietopohjasta            |