# 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.

Agentin kieliasetukset ohjaavat **kolmea eri asiaa**. Valitse muutettava asetus sen mukaan, haluatko vaihtaa vastausten kielen, keskusteluikkunan tekstit vai tietolähteiden hakukielen.

| 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.** Agenttia ohjataan vastaamaan sillä kielellä, jolla asiakas kirjoittaa.
- **Aina suomi / Aina englanti.** Valitse kiinteä vastauskieli. Tämä asetus ohittaa automaattisen kielivalinnan, mutta mallin tuottaman vastauksen kieli ja laatu on silti tarkistettava.

Automaattisessa tilassa lyhyet ilmaukset, kuten "ok", "kiitos" tai "thanks", eivät yleensä vaihda keskustelun kieltä. Selkeä viesti toisella kielellä voi vaihtaa sen. Testaa kielenvaihto asiakkaillesi tyypillisillä kysymyksillä.

Jos kieltä ei voi varmuudella päätellä eikä keskustelusta löydy aiempaa kielivalintaa, kielenratkaisu käyttää suomea varakielenä.

### 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** ohjataan samalle kielelle. Tarkista myös ne, jos toiminto on käytössä.
- **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

Automaattisessa tilassa agentti voi vastata myös muilla kielillä, kuten saksaksi, ranskaksi tai espanjaksi. Vastauksen laatu riippuu kielimallista ja lähteistä; varmista tarvitsemasi kieli testaamalla. Merkityspohjainen haku voi löytää sisältöä myös toisella kielellä.

Kiinteät vastauskielivalinnat ovat suomi ja englanti. Haun kielikohtaiset säännöt auttavat käsittelemään taivutusmuotoja. Suomenkielisiin vastauksiin annetaan lisäksi suomen kirjoittamista koskevia ohjeita. Nämä eivät takaa virheetöntä vastausta.

Voit lisätä **Asetukset → Kielet** -näkymän **Suojatut termit** -kohtaan nimet ja lyhenteet, jotka haluat säilyttää alkuperäisessä muodossaan. Tallenna valitsemalla **Tallenna uusi ohjeversio** ja testaa termit niillä kielillä, joita käytät. Lista ohjaa kielimallia; se ei ole vastauksen tekstiä jälkikäteen pakottava korvaussääntö.

## 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.

> **Huomaa — Mikä kielivalinta tulee voimaan?:**
>
> Sivuston kelvollinen `uiLanguage`-ohitus on ensisijainen. Muussa tapauksessa
> widget käyttää kävijän muistettua kielivalintaa, jos kielivalitsin on käytössä
> ja kieli on yhä sallittu. Ensikäynnillä ilman kumpaakaan selaimen kielen
> tunnistus voi valita sallitun kielen; muuten widget avautuu oletuskielellä.

Selaimen kielen tunnistus on erillinen asetus ja oletuksena pois. Kun se on käytössä, tunnistus voi valita vain listalla olevan kielen. Jos selaimen kieli ei ole sallittu, widget käyttää oletuskieltä.

Aiemmin luotu widget voi edelleen käyttää selaimen kieltä, jos erillinen tunnistusasetus puuttuu ja vanha kielitila on `auto`. Muokkaimen seuraava tallennus säilyttää tämän toiminnan; poista tunnistus käytöstä kytkimellä.

Jos haluat, että widget on aina suomeksi, valitse suomi oletukseksi ja jätä selaimen tunnistus pois. Yhden kielen lista lukitsee käyttöliittymän siihen kieleen myös tunnistuksen ollessa päällä.

### 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.

### Widgetin omat sisältötekstit

Muokkaimen Sisältö- ja Toiminta-välilehdillä sekä liidiasetuksissa voit valita, minkä kielen tekstejä muokkaat. Kieliversioitavia sisältöjä ovat esimerkiksi:

- chatbotin nimi, tervetulotekstit ja keskustelunaloitukset
- avauspainikkeen teksti ja vihjeteksti
- vastausten vastuuvapausteksti
- esitietolomakkeen otsikot ja painikkeet sekä suostumusteksti linkkeineen
- tietosuojailmoituksen teksti, näkyvä linkkiteksti ja URL.

Oletuskieli toimii muiden kielten sisältöjen varaversiona. Jos esimerkiksi englanninkielinen tervetuloteksti puuttuu ja englanti ei ole oletuskieli, widget käyttää oletuskielen tekstiä. Oletuskieleen tallennettu tyhjä arvo ei palauta vanhaa yksikielistä tekstiä; widgetin oma oletusteksti voi silti tulla käyttöön kentissä, joille sellainen on määritetty. Esitietolomakkeen suostumusteksti ja tietosuojailmoitus vaihtuvat kumpikin oman linkkitekstinsä ja URL-osoitteensa kanssa yhtenä ryhmänä, jotta samaan tekstiin ei sekoitu kahta kieltä.

### 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ä käsittelyn yhteydessä. Samassa tietopohjassa voi olla esimerkiksi suomenkielinen käyttöohje ja englanninkielinen hinnasto. Hakusäännöt valitaan tunnistetun kielen perusteella, joten väärä kielimerkintä voi heikentää hakua.

Suomenkieliset hakusäännöt auttavat löytämään sanan eri taivutusmuotoja. Osuma riippuu silti kysymyksestä ja lähteen sisällöstä; testaa asiakkaidesi käyttämiä ilmauksia.

Hakukielen muokkaus ei ole käytettävissä samalla tavalla kaikille tietolähteille. Jos lähteen tiedoissa on käytettävissä **Kieli**-valinta, valitse suomi tai englanti ja odota tallennuksen vahvistusta. Tarkista haku uudelleen. Jos valinta puuttuu, on lukittu tai tallennus ei onnistu, älä yritä kiertää rajoitusta: [ota yhteyttä](/yhteystiedot#contact-form) ja kerro lähteen tyyppi sekä odotettu kieli.

**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. **Hakukieli arvioidaan kysymyksestä.** Englannin vastausasetus ei yksin vaihda suomenkielisen kysymyksen hakukieltä.
2. **Vastausta ohjataan englanniksi.** Kiinteä vastauskieliasetus ohittaa automaattisen valinnan.
3. **Jatkokysymyksiä ohjataan englanniksi.** Tarkista myös niiden kieli, jos toiminto on käytössä.
4. **Widgetin käyttöliittymä ei muutu** – se on oma akselinsa.

Voit siis testata englanninkielisiä vastauksia suomenkielisestä tietopohjasta. Varmista erityisesti nimet, luvut ja käyttöehdot; kieliasetus ei takaa niiden oikeaa tulkintaa.

### Vastauskieli on Automaattinen, asiakas kirjoittaa saksaksi

Agentti voi vastata saksaksi. Haku käyttää merkityspohjaista hakua, mutta suomen ja englannin kielikohtaisia hakusääntöjä ei sovelleta saksaan. Tarkista vastauksen laatu itse.

### 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än kielivalinta muuttuu. Vastauskieliasetus ei muutu: suomeen lukittua agenttia ohjataan edelleen vastaamaan 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 Tietolähteet-sivulta     |