# Aihio: Dokumentaation täysteksti (LLM)

> Aihio on suomalainen tekoälyagenttialusta. Tämä tiedosto sisältää
> koko suomenkielisen dokumentaation tekstimuodossa LLM-pohjaisia
> hakukokemuksia varten (ChatGPT, Claude, Perplexity).

Lähde: https://aihio.ai/ohjekeskus
Kuratoiva linkkihakemisto: https://aihio.ai/llms.txt


# Tilin asetukset

URL: https://aihio.ai/ohjekeskus/tili/asetukset
Kuvaus: Tilin asetusten hallinta.

Tiliasetuksia hallitaan ohjauspaneelin oikean yläkulman valikosta.

## Mitä voit muuttaa

- Sähköpostiosoite ja näyttönimi
- Salasana ja kaksivaiheinen tunnistautuminen
- Ilmoitusasetukset — sovellusilmoitukset ja käytettävissä olevat sähköpostitapahtumat
- Kielivalinta — hallintapaneelin ja sähköpostiviestien kieli

> **Kaksivaiheinen tunnistautuminen:**
>
> Suosittelemme vahvasti käyttämään kaksivaiheista tunnistautumista. Se suojaa
> tiliäsi myös siinä tapauksessa, että salasana paljastuu.


---

# Tilauksen hallinta

URL: https://aihio.ai/ohjekeskus/laskutus/tilauksen-hallinta
Kuvaus: Laskutuksen ja tilausten hallinta.

Tilaustiedot löytyvät ohjauspaneelin "Laskutus"-välilehdeltä.

## Mitä voit tehdä

- Vaihtaa hinnoittelumallia — ilmainen, kasvu tai yritys
- Päivittää maksutiedot — kortti tai laskutustiedot
- Ladata laskut — PDF-muodossa kirjanpitoa varten
- Peruuttaa tilaus — milloin tahansa, ilman selityksiä

> **Maksutapa:**
>
> Hyväksymme luotto- ja debit-kortit (Visa, Mastercard) sekä yritysasiakkaille
> laskutuksen.


---

# Chatbotin asetukset

URL: https://aihio.ai/ohjekeskus/tekoalyagentti/asetukset
Kuvaus: Chatbotin asetusten hallinta.

Chatbotin käyttäytymistä, ulkoasua ja tietopohjaa hallitaan asetus-välilehdiltä.

## Välilehdet

- **Yleiset** — nimi, kieli, avoinna-ajat
- **Ulkoasu** — pääväri, avausnapin väri, logo ja chat-widgetin sijainti
- **Tietopohja** — dokumentit ja URL-osoitteet, joista chatbot oppii
- **Vastaukset** — persoona, sävy, kielletyt aiheet
- **Integraatiot** — sähköposti, Slack, Teams, CRM

> **Muista tallentaa:**
>
> Muutokset tulevat voimaan vasta, kun painat **Tallenna**-painiketta.

Pääväri vaikuttaa otsikkoon, omiin viesteihin ja ensisijaisiin painikkeisiin.
Avausnapille voi valita oman värin, ja sen ikonin kontrasti valitaan
automaattisesti. Näin esimerkiksi valkoinen otsikko ei pakota avausnappia
valkoiseksi.

## Nykyisen sivun tunnistus

**Tekoäly**-asetusten **Ymmärrä kävijän nykyinen sivu** -kytkin auttaa chatbotia tulkitsemaan viittaavia kysymyksiä. Esimerkiksi hinnoittelusivulla esitetty ”Mitä tähän sisältyy?” voidaan yhdistää kyseiseen tietopohjasivuun.

Ominaisuus on oletuksena pois käytöstä. Sen voi ottaa käyttöön, kun chatbotin tietopohjassa on vähintään yksi valmis verkkosivu. Upotuskoodia tai sivuston asetuksia ei tarvitse muuttaa. Chat-widget tarkistaa sivun jokaisen lähetetyn viestin yhteydessä, joten myös yksisivuisen verkkosovelluksen osoitteenmuutokset huomioidaan automaattisesti.

Tunnistus toimii vain, kun selaimen sivu vastaa yksiselitteisesti tietopohjaan lisättyä verkkosivua. Jos sivua ei löydy tai sama tunniste vastaa useaa lähdettä, chatbot käyttää tavallista tietopohjahakua. Sivukohtainen haku ei estä tavallisen haun parasta osumaa.

### Tietosuoja ja rajaukset

- Chat-widget poistaa osoitteesta kyselyparametrit ja ankkurin sekä muodostaa alkuperästä ja polusta kiinteän tunnisteen selaimessa.
- Chat-widget ei lähetä Aihiolle raakaa sivuosoitetta, sivun otsikkoa, tekstiä, otsikoita, lomakkeita, syötekenttiä tai muita DOM-tietoja.
- Tunnistetta ei tallenneta keskusteluun eikä kirjoiteta sovelluslokeihin. Sitä käytetään vain kyseisen viestin tietopohjahaun rajaamiseen.
- Ominaisuus kannattaa jättää pois käytöstä sivustoissa, joiden osoitepolku yksilöi käyttäjän tai sisältää arkaluonteista tietoa. Jos ominaisuus otetaan käyttöön tällaisessa ympäristössä, käsittely pitää arvioida ja kuvata sivuston omassa tietosuojaselosteessa.

Ominaisuus on vapaaehtoinen eikä vaikuta chatbotin tavalliseen toimintaan, kun se on pois käytöstä.

Tunnistus kannattaa testata sivustolle julkaistulla chat-widgetillä. Ohjauspaneelin esikatselu ei vastaa asiakkaan verkkosivun osoitetta, joten se käyttää tavallista tietopohjahakua.


---

# Identiteettivarmistus

URL: https://aihio.ai/ohjekeskus/tekoalyagentti/identiteettivarmistus
Kuvaus: Sido kirjautunut käyttäjä kryptografisesti chat-widgettiin. HMAC-käyttäjätiiviste tai JWT – palvelin allekirjoittaa, Aihio vahvistaa.

Ilman identiteettivarmistusta kuka tahansa kävijä voi kutsua `AihioWidget('identify', { user_id: '…' })` selaimen kehittäjätyökalusta millä käyttäjätunnuksella tahansa. Varmistus sitoo istunnon palvelimesi allekirjoittamaan salaisuuteen: Aihio tietää, että kutsuja on oikeasti kirjautunut käyttäjä.

Aihio tukee kahta menetelmää: **HMAC-käyttäjätiivistettä** ja **JWT HS256 -tokenia**.

## Mistä salaisuus löytyy

Avaa ohjauspaneelissa chatbotin **Asetukset → Suojaus**. Paina
**Identiteetin varmistus** -osiossa **Luo salaisuus** ja kopioi arvo heti
talteen: se näytetään vain kerran. Salaisuus näyttää esimerkiksi tältä:
`aihio_idv_…`.

Tallenna salaisuus palvelimesi ympäristömuuttujaksi (esim. `AIHIO_IDENTITY_SECRET`). Älä koskaan sisällytä sitä selainpuolen JavaScript-koodiin tai versiohallintaan.

## Menetelmä A: HMAC-käyttäjätiiviste

Laske `HMAC-SHA256(salaisuus, user_id)` palvelimellasi ja välitä tulos `user_hash`-kentässä. Tulosteen **on oltava pienet kirjaimet sisältävä heksadesimaali**. Aihio hylkää isolla kirjoitetun heksan.

Kaikki alla olevat esimerkit tuottavat oikean muodon oletuksena.

### Node.js

```javascript
const crypto = require('crypto');

function computeUserHash(secret, userId) {
  return crypto.createHmac('sha256', secret).update(userId).digest('hex');
}
```

### Python

```python
import hmac, hashlib

def compute_user_hash(secret: str, user_id: str) -> str:
    return hmac.new(
        secret.encode('utf-8'),
        user_id.encode('utf-8'),
        hashlib.sha256
    ).hexdigest()
```

### PHP

```php
function compute_user_hash(string $secret, string $user_id): string {
    return hash_hmac('sha256', $user_id, $secret);
}
```

### Ruby

```ruby
require 'openssl'

def compute_user_hash(secret, user_id)
  OpenSSL::HMAC.hexdigest('SHA256', secret, user_id)
end
```

## Menetelmä B: JWT HS256 -token

Allekirjoita JWT `HS256`-algoritmilla chatbotin salaisuudella. `exp`-väite on **pakollinen**: Aihio hylkää tokenin ilman sitä. Kellopoikkeama on 30 sekuntia.

Suositeltu tokenin elinikä on 1 tunti (`exp = iat + 3600`). Älä myönnä yli 24 tunnin tokeneita.

### Tuetut JWT-väitteet

| Väite               | Tyyppi             | Pakollinen         | Huomio                                 |
| ------------------- | ------------------ | ------------------ | -------------------------------------- |
| `user_id` tai `sub` | merkkijono         | kyllä (jompikumpi) | Käyttäjätunnus omassa järjestelmässäsi |
| `external_id`       | merkkijono         | ei                 | `user_id`/`sub`-alias                  |
| `exp`               | numero (Unix-aika) | kyllä              | Vanheneminen; 30 s poikkeama           |
| `nbf`               | numero (Unix-aika) | ei                 | Voimassa aikaisintaan; 30 s poikkeama  |
| `email`             | merkkijono         | ei                 | Esitäyttää esikeskustelulomakkeen      |
| `name`              | merkkijono         | ei                 | Esitäyttää esikeskustelulomakkeen      |
| `phonenumber`       | merkkijono         | ei                 | Esitäyttää esikeskustelulomakkeen      |
| `custom_attributes` | objekti            | ei                 | Vapaamuotoiset lisätiedot              |
| `stripe_accounts`   | taulukko           | ei                 | Käyttäjän Stripe-tilit (ks. alla)      |

Vain `HS256` hyväksytään. RS256-, ES256- tai `alg: none` -tokeneja ei hyväksytä.

## Allekirjoita JWT palvelimella

Allekirjoita token chatbotin salaisuudella `HS256`-algoritmilla. Aseta `exp` (suositus 1 tunti). `custom_attributes` on vapaaehtoinen.

### Node.js (`jsonwebtoken`)

Asennus: `npm install jsonwebtoken`

```javascript
const jwt = require('jsonwebtoken');

function signIdentityToken(secret, user) {
  return jwt.sign(
    {
      user_id: user.id,
      email: user.email,
      name: user.name,
      custom_attributes: { plan: user.plan },
    },
    secret,
    { algorithm: 'HS256', expiresIn: '1h' },
  );
}
```

### Ruby on Rails (`jwt`-kirjasto)

Asennus: `bundle add jwt`

```ruby
require 'jwt'

def sign_identity_token(secret, user)
  payload = {
    user_id: user.id,
    email: user.email,
    name: user.name,
    custom_attributes: { plan: user.plan },
    exp: Time.now.to_i + 3600,
  }
  JWT.encode(payload, secret, 'HS256')
end
```

### Django / Python (`PyJWT`)

Asennus: `pip install PyJWT`

```python
import time
import jwt

def sign_identity_token(secret: str, user) -> str:
    payload = {
        'user_id': user.id,
        'email': user.email,
        'name': user.name,
        'custom_attributes': {'plan': user.plan},
        'exp': int(time.time()) + 3600,
    }
    return jwt.encode(payload, secret, algorithm='HS256')
```

### PHP (`firebase/php-jwt`)

Asennus: `composer require firebase/php-jwt`

```php
use Firebase\JWT\JWT;

function sign_identity_token(string $secret, $user): string {
    $payload = [
        'user_id' => $user->id,
        'email' => $user->email,
        'name' => $user->name,
        'custom_attributes' => ['plan' => $user->plan],
        'exp' => time() + 3600,
    ];
    return JWT::encode($payload, $secret, 'HS256');
}
```

### Go (`golang-jwt`)

Asennus: `go get github.com/golang-jwt/jwt/v5`

```go
import (
    "time"

    "github.com/golang-jwt/jwt/v5"
)

func SignIdentityToken(secret string, user User) (string, error) {
    token := jwt.NewWithClaims(jwt.SigningMethodHS256, jwt.MapClaims{
        "user_id":           user.ID,
        "email":             user.Email,
        "name":              user.Name,
        "custom_attributes": map[string]any{"plan": user.Plan},
        "exp":               time.Now().Add(time.Hour).Unix(),
    })
    return token.SignedString([]byte(secret))
}
```

### Java (`jjwt`)

Asennus (Maven): `io.jsonwebtoken:jjwt-api`, `jjwt-impl`, `jjwt-jackson` (runtime).

```java
import io.jsonwebtoken.Jwts;
import javax.crypto.spec.SecretKeySpec;
import java.nio.charset.StandardCharsets;
import java.util.Date;
import java.util.Map;

String signIdentityToken(String secret, User user) {
    SecretKeySpec key = new SecretKeySpec(
        secret.getBytes(StandardCharsets.UTF_8), "HmacSHA256");
    return Jwts.builder()
        .claim("user_id", user.getId())
        .claim("email", user.getEmail())
        .claim("name", user.getName())
        .claim("custom_attributes", Map.of("plan", user.getPlan()))
        .expiration(new Date(System.currentTimeMillis() + 3_600_000))
        .signWith(key)
        .compact();
}
```

### Stripe-tilien välittäminen (tuleva ominaisuus)

Kirjoittamalla `stripe_accounts`-taulukon JWT-tokeniin voit liittää käyttäjään Stripe-asiakastiedot. Varmennettu identiteetti toimii tulevien identiteettisidonnaisten toimintojen pohjana, jotka hakevat tilaukset ja laskut ilman erillistä tunnistautumista.

```javascript
jwt.sign(
  {
    user_id: user.id,
    email: user.email,
    stripe_accounts: [{ label: 'Pääasiakkuus', stripe_id: 'cus_xxx' }],
    exp: Math.floor(Date.now() / 1000) + 3600,
  },
  secret,
  { algorithm: 'HS256' },
);
```

> **Tämä on tuleva ominaisuus:**
>
> Identiteettivarmistus ja `identity_verified`-lippu toimivat tänään. Toiminnot,
> jotka lukevat `stripe_accounts`-tietoja (tilaukset, laskut) ovat erillinen
> tuleva ominaisuus. Allekirjoita kenttä jo nyt, niin käyttöönotto on sujuvaa
> kun ominaisuus julkaistaan.

## Identiteetin välittäminen widgetille

Laske arvo palvelimella ja injektoi se sivulle. Kutsu sitten `identify`:

```javascript
// Menetelmä A: HMAC-käyttäjätiiviste
window.AihioWidget('identify', {
  user_id: currentUser.id, // 'externalId' hyväksytään myös aliaksena
  email: currentUser.email,
  name: currentUser.name,
  user_hash: '{{ palvelimelta_laskettu_tiiviste }}',
});

// Menetelmä B: JWT-token
window.AihioWidget('identify', {
  token: '{{ palvelimelta_allekirjoitettu_jwt }}',
});
```

`identify`-kutsun voi tehdä milloin tahansa `init`-kutsun jälkeen. Jos kutsut sitä ennen kuin bundle on latautunut, komento asetetaan jonoon ja suoritetaan automaattisesti käynnistyksen yhteydessä.

Tyhjennä identiteetti uloskirjautumisen yhteydessä:

```javascript
window.AihioWidget('resetUser');
```

## Salaisuuden kierrätys

Salaisuuden kierrätys **ei** välittömästi mitätöi vanhaa salaisuutta. Edellinen salaisuus on voimassa 24 tuntia kierrätyksen jälkeen. Tämä vastaa Stripen webhook-salaisuuden kierrätysmallia: voit päivittää allekirjoituskoodin ympäristöihin ennen kuin vanha salaisuus vanhenee.

1. **Kierrätä salaisuus**

   Paina **Kierrätä salaisuus** kohdassa **Asetukset → Suojaus → Identiteetin varmistus**.
2. **Päivitä ympäristömuuttuja**

   Päivitä `AIHIO_IDENTITY_SECRET` palvelimesi ympäristöön uudella arvolla.
3. **Ota muutos käyttöön**

   Ota uusi ympäristömuuttuja käyttöön. Vanha salaisuus jatkaa istuntojen varmennusta rinnakkain 24 tunnin ajan.
4. **Odota 24 tuntia**

   24 tunnin kuluttua vanha salaisuus lakkaa toimimasta. Holvimerkintä säilytetään, mutta sitä ei enää käytetä varmennuksessa.

## Pakota identiteettivarmistus

Oletuksena varmistus on avoin (fail-open). Pakotuksen voi ottaa käyttöön chatbotin
**Asetukset → Suojaus** -näkymästä.

- **Pakota identiteettivarmistus.** Pyyntö, joka väittää identiteettiä (`user_id`/`external_id`, `email`, `token` tai `user_hash`) ilman validia allekirjoitusta, hylätään HTTP 403:lla. Anonyymit kävijät voivat silti keskustella.
- **Vaadi tunnistautuminen (tiukka).** Jokainen varmistamaton pyyntö hylätään, myös anonyymit.

Kun pakotus on päällä, keskustelu sidotaan varmennettuun `external_id`-tunnisteeseen. Uudelleenkäytetty `reference_id`, jonka tallennettu identiteetti ei vastaa varmennettua tokenia, aloittaa uuden keskustelun sen sijaan että liittyisi vanhaan. Näin yksi kävijä ei voi jatkaa toisen kävijän yksityistä keskustelua.

Pakotus avautuu vasta, kun Aihio on nähnyt vähintään yhden validin tokenin, joten et voi lukita itseäsi ulos ottamalla sen käyttöön ennen kuin integraatiosi on toiminnassa.

## Turvallinen yhteys ja istunnon kesto

- **Vain turvallinen yhteys.** Kun tämä on päällä, chat-widget lähettää identiteettiotsikot ja tallentaa identiteetin vain HTTPS-yhteydellä. Tavallisella HTTP-sivulla se ei lähetä identiteettiä, ja palvelin hylkää varmennuksen.
- **Istunnon kesto.** Aseta tokenin suurin hyväksytty ikä (60 sekunnista 30 päivään). Chat-widget tyhjentää tallennetun identiteetin iän ylittyessä, ja palvelin hylkää rajaa vanhemman tokenin, vaikka sen oma `exp` olisi yhä voimassa.

## Käyttöönottotapa: toiminto avoimena (fail-open)

Nykyinen toteutus on **avoin käyttöönottoa varten**: jos allekirjoitusta ei toimiteta tai varmennus epäonnistuu, istunto jatkuu `identity_verified = false` -tilassa eikä sitä hylätä.

Tämä tarkoittaa, että varmistamaton `user_id` tai sähköposti hyväksytään näyttövihjeinä, mutta teknisesti hyökkääjän muutettavissa olevia arvoja. Käsittele identiteettitietoja luotettavina **vain** kun keskustelun `identity_verified`-lippu on `true`.

## Allekirjoitetut vs allekirjoittamattomat tiedot

Vain JWT:n sisällä allekirjoitetut tiedot ovat varmennettuja ja luotettavia. Kaikki muu on näyttövihje, jonka lähettäjä voi väärentää.

| Allekirjoitettu (luotettava)                                     | Allekirjoittamaton (vain vihje)                 |
| ---------------------------------------------------------------- | ----------------------------------------------- |
| `user_id` / `external_id`                                        | Prechat-lomakkeen nimi, sähköposti ja suostumus |
| `email`, `name`, `custom_attributes` (kun ne ovat JWT:n sisällä) | Mikä tahansa `x-identify`-otsikko ilman JWT:tä  |

HMAC-käyttäjätiiviste (tapa A) varmentaa vain `external_id`-arvon. Jos haluat luottaa `email`-, `name`- tai mukautettuihin kenttiin, allekirjoita ne JWT:n sisällä (tapa B). Lähettäjän antamat kentät hyväksytään näyttövihjeinä. Niitä ei koskaan tallenneta varmennettuina, ja keskustelun `identity_verified`-lippu pysyy arvossa `false`, ellei validia allekirjoitusta ole.

## Tietoturvatarkistuslista

- Tallenna chatbotin salaisuus yksinomaan palvelimelle. Älä sisällytä sitä selainpuolen JavaScript-koodiin tai versiohallintaan.
- Aseta `exp` jokaiseen JWT-tokeniin (suositus 1 h).
- Kierrätä salaisuus heti, jos se paljastuu (**Asetukset → Suojaus → Identiteetin varmistus**).
- Tarkista `identity_verified = true` toimintokäsittelijöissäsi ennen tilitasoisen datan palauttamista.
- Käytä HMAC-funktiosi oletustulosteen pieniä kirjaimia sisältävää heksadesimaalia.


---

# Julkaisu

URL: https://aihio.ai/ohjekeskus/tekoalyagentti/julkaisu
Kuvaus: Chatbotin julkaiseminen sivustolle.

Julkaisemiseen kuuluu koodinpätkän asentaminen sivustolle ja chatbotin aktivointi.

## Ennen julkaisua

Käy testi-keskustelu esikatselussa ja varmista, että chatbot vastaa odotetulla tavalla eri kysymyksiin.

## Koodinpätkän asennus

Avaa ohjauspaneelissa chatbotin **Muokkain** ja valitse oikeasta yläkulmasta
**Asenna → Verkkosivun chat-widget**. Kopioi `<script>`-koodinpätkä ja lisää se
sivustosi HTML-koodiin juuri ennen sulkevaa `</body>`-tagia. Useimmissa
julkaisujärjestelmissä (WordPress, Webflow, Shopify) tämä onnistuu erillisellä
skriptikentällä.

WordPress-sivustoille on myös virallinen lisäosa, joka liittää chatbotin yhdellä napsautuksella ilman koodia. Katso [WordPress-lisäosa](/ohjekeskus/tekoalyagentti/wordpress-lisaosa).

**Asenna**-valikosta löydät myös sivulle upotettavan keskustelun ja
WordPress-lisäosan. Suora keskustelulinkki löytyy **Kanavat**-sivulta.
Domain-rajoitukset ja kirjautuneiden käyttäjien tunnistus määritetään kohdassa
**Asetukset → Suojaus**.


---

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


---

# Luo chatbot

URL: https://aihio.ai/ohjekeskus/tekoalyagentti/luo-chatbot
Kuvaus: Uuden chatbotin luominen ohjauspaneelissa.

Tällä sivulla käydään läpi chatbotin luonnin vaiheet ohjauspaneelissa.

## Nimen ja pohjan valinta

Valitse chatbotille nimi, joka kuvaa sen käyttötarkoitusta — esimerkiksi "Asiakaspalvelu" tai "Myyntiassistentti". Aihio tarjoaa valmiita pohjia eri käyttötapauksiin.

## Pohjan räätälöinti

Jokaisesta pohjasta saat toimivan lähtökohdan. Voit muokata:

- Chatbotin persoonaa ja sävyä
- Tervehdys- ja lopetusviestejä
- Kysymysten ohjausta epävarmoissa tilanteissa


---

# SMS-kanava (Twilio)

URL: https://aihio.ai/ohjekeskus/tekoalyagentti/sms-kanava
Kuvaus: Yhdistä oma Twilio-tilisi ja anna tekoälyagentin vastata SMS-viesteihin. Asiakas tuo numerot ja maksaa Twiliolle suoraan.

Aihio tukee oman Twilio-tilin käyttöä: yhdistät oman Twilio-tilisi, jolloin tekoälyagentti vastaa saapuviin SMS-viesteihin samasta numerosta josta asiakkaasi sen lähetti. Numerot pysyvät sinun omistuksessasi ja Twilion käyttömaksut menevät suoraan Twilio-tilillesi — Aihio ei välitä laskutusta.

## Edellytykset

- **Twilio-tili.** Kokeilutili riittää testaukseen, mutta tuotantokäytössä tarvitset aktiivisen tilin (ks. Twilion 10DLC-vaatimukset Yhdysvaltoihin lähetettäville viesteille).
- **SMS-kykyinen numero** Twilio-tililläsi. Numero voi olla suomalainen, eurooppalainen tai mikä tahansa Twilion tukema numero — Aihio ei rajoita maakohtaisesti.
- **Aihio-tilaus**, jossa on integraatiot käytössä (Starter-tasolta ylöspäin).

## Yhteyden luonti

1. **Hae Twilio-tunnukset**

   Kirjaudu [Twilio Consoleen](https://console.twilio.com). Etusivulla näet **Account SID** -arvon ja **Auth Token** -arvon (paina "View" nähdäksesi tokenin). Kopioi molemmat talteen.

   Account SID alkaa aina merkeillä `AC` ja on 34 merkkiä pitkä. Auth Token on 32 merkkiä.
2. **Avaa SMS-asetukset Aihiossa**

   Aihion ohjauspaneelissa: **Chatbotit → valitse chatbot → Kanavat → Tekstiviestit**.
3. **Syötä tunnukset ja numero**

   Liitä Account SID, Auth Token ja Twilio-numerosi E.164-muodossa (esim. `+358401234567`). Anna halutessasi vapaamuotoinen nimi numerolle (esim. "Tuotteen tuki").

   Aihio tarkistaa heti, että tunnukset toimivat ja että numero todella kuuluu samalle Twilio-tilille. Yleisimmät virhetilanteet:
   - **"Twilio hylkäsi tunnukset"** — tarkista että kopioit Auth Tokenin kokonaan.
   - **"Antamasi numero ei kuulu samalle Twilio-tilille"** — varmista että olet valinnut oikean Twilio-tilin ja että numero on E.164-muodossa.
   - **"Twilion palveluun ei juuri nyt saatu yhteyttä"** — Twilion API hetkellisesti pois käytöstä, yritä uudelleen muutaman minuutin kuluttua.
4. **Aseta webhook-osoite Twilio Consoleen**

   Yhteyden luonnin jälkeen Aihio näyttää **webhook-osoitteen** muodossa `https://app.aihio.ai/api/webhooks/twilio/sms`. Kopioi se.

   Twilio Consolessa: **Phone Numbers → Manage → Active numbers → valitse numero → Messaging Configuration**.
   - Kohtaan **"A message comes in"** liitä Aihion webhook-osoite ja valitse menetelmäksi `HTTP POST`.
   - Tallenna asetukset.
5. **Lähetä testiviesti**

   Lähetä omasta puhelimestasi SMS Twilio-numeroosi. Muutaman sekunnin sisällä saat takaisin tekoälyagentin vastauksen, ja keskustelu ilmestyy Aihion saapuneet-kansioon SMS-kanavamerkillä merkittynä.

   Jos vastausta ei tule, tarkista:
   - Sentry-virheloki (`channels/sms` -tagi)
   - Aihion saapuneet-kansiosta keskustelu — jos näet bottivastauksen mutta toimitusta ei merkitty onnistuneeksi, klikkaa keskustelua nähdäksesi virhesyyn.

## Miten se toimii

1. Asiakkaasi lähettää SMS:n Twilio-numerolle.
2. Twilio lähettää webhook-pyynnön Aihion palvelimelle (allekirjoitettu Twilion Auth Tokenilla — Aihio verifioi jokaisen pyynnön).
3. Aihion tekoälyagentti generoi vastauksen samalla logiikalla kuin verkkosivun chat-widgetillä — samat tietopohjat, sama system prompt.
4. Aihio lähettää vastauksen takaisin Twilion REST-rajapinnan kautta omasta Twilio-tilistäsi asiakkaasi puhelimeen.
5. Keskustelu tallentuu Aihion saapuneet-kansioon, jossa voit lukea sen ja tarvittaessa eskaloida ihmisagentille.

Vastausviesti voi olla enintään 1 600 merkkiä — Twilio jakaa pidemmät viestit automaattisesti useaan SMS-segmenttiin. Käyttömaksu lasketaan Twilio-tilisi laskulla per segmentti.

## Mitä Aihio EI tee

- **Ei välitä Twilion käyttömaksuja.** Twilio veloittaa sinulta suoraan SMS:t (Suomeen tyypillisesti noin 0,05 € / segmentti vuonna 2026). Aihion palvelumaksut eivät kasva SMS-volyymin myötä.
- **Ei tue MMS-viestejä** tällä hetkellä. Saapuvien viestien liitteet (kuvat) sivuutetaan; vain tekstisisältö viedään tekoälyagentille.
- **Ei rekisteröi 10DLC-brandeja puolestasi.** Yhdysvaltoihin lähetettävät viestit edellyttävät Twilion 10DLC-rekisteröintiä — hoida se Twilion oman prosessin kautta ennen tuotantokäyttöä.

## Irrotus

Aihion ohjauspaneelissa: **Chatbotit → valitse chatbot → Kanavat → Tekstiviestit → Irrota Twilio**. Tallennetut tunnukset poistetaan välittömästi. Muista lisäksi poistaa webhook-osoite Twilio Consolesta, jotta Twilio ei yritä uudelleen lähettää viestejä Aihion palvelimelle.

## Tietosuoja

Twilio toimii alikäsittelijänä **vain** kun olet aktivoinut SMS-kanavan. Asiakas (sinä) on Twilion suora rekisterinpitäjä — Aihio toimii teknisenä välittäjänä. Yksityiskohdat löytyvät [tietojenkäsittelysopimuksesta](/juridiikka/tietojenkasittelysopimus) (kohta 6 — Alikäsittelijät) ja [tietosuojakäytännöstä](/juridiikka/tietosuojaseloste).

Tunnukset (Account SID + Auth Token) tallennetaan Aihion tietokantaan AES-256-GCM-salattuina. Salaus-avain pidetään ympäristömuuttujassa, ei tietokannassa.


---

# Tietopohja

URL: https://aihio.ai/ohjekeskus/tekoalyagentti/tietopohja
Kuvaus: Yksi selkeä ohje tietopohjan lähteisiin, lisäämiseen, tiloihin, automaattiseen päivitykseen ja laadun parantamiseen.

Tietopohja on chatbotin vastausten lähde. Kun asiakas kysyy jotain, Aihio hakee tietopohjasta kysymykseen sopivat kohdat ja muodostaa vastauksen niiden perusteella. Mitä selkeämpi, ajantasaisempi ja rajatumpi tietopohja on, sitä luotettavammin chatbot vastaa.

Tämä opas käy läpi koko Tietopohja-sivun: mitä lähteitä voit lisätä, miten tila luetaan, miten lähteitä hallitaan, miten automaattinen päivitys toimii ja miten korjaat yleisimmät ongelmat.

## Miten tietopohja toimii

Tietopohja ei ole erillinen käsin kirjoitettava vastauspankki. Se koostuu lähteistä, joita yritykselläsi on jo olemassa: verkkosivuista, tiedostoista, kysymysparista ja teksteistä.

Kun lisäät lähteen, Aihio:

1. hakee tai vastaanottaa sisällön
2. purkaa siitä luettavan tekstin
3. jakaa tekstin haettaviin osiin
4. tallentaa sisällön tietopohjaan
5. käyttää valmiita lähteitä chatbotin vastauksissa

Jos lähde on vielä jonossa tai käsittelyssä, chatbot käyttää jo valmiita lähteitä. Uusi sisältö tulee mukaan vasta, kun lähde on valmis.

## Tietopohjan tärkeimmät alueet

Tietopohja-sivulla on viisi käyttäjälle tärkeää aluetta:

| Alue           | Mitä siitä näkee                                                          | Milloin sitä käytetään                            |
| -------------- | ------------------------------------------------------------------------- | ------------------------------------------------- |
| Statusikoni    | Onko chatbot valmis, käsitteleekö se lähteitä tai vaatiiko jokin huomiota | Kun haluat nähdä tilanteen nopeasti               |
| Käyttöaste     | Kuinka paljon sivu- ja sisältörajasta on käytössä                         | Kun arvioit, mahtuuko lisää sisältöä              |
| Välilehdet     | Verkkosivut, tiedostot, kysymysparit ja tekstit                           | Kun haluat hallita tiettyä lähdetyyppiä           |
| Lähdelista     | Lähteet, tilat, lisäysajat, sisältökoot ja rivitoiminnot                  | Kun etsit, päivität tai poistat lähteitä          |
| Lähteen tiedot | Drawer, jossa näkyy lähteen sisältö, hakutesti ja tarkemmat tiedot        | Kun haluat tarkistaa, mitä tietopohjaan tallentui |

## Mitä lähteitä voit lisätä

| Lähde        | Milloin valita                                                    | Esimerkki                                         |
| ------------ | ----------------------------------------------------------------- | ------------------------------------------------- |
| Verkkosivut  | Tieto on julkisella sivustolla ja sitä päivitetään siellä         | Palvelusivut, hinnasto, toimitusehdot, ohjesivut  |
| Tiedostot    | Tieto on valmiissa dokumentissa                                   | PDF-esite, DOCX-ohje, CSV-hinnasto                |
| Kysymysparit | Sama kysymys toistuu usein ja haluat antaa täsmällisen vastauksen | "Mikä on toimitusaika?" ja sen hyväksytty vastaus |
| Tekstit      | Tieto on lyhyt ohje, jota ei ole sivustolla tai tiedostossa       | Poikkeava aukioloaika, kampanjan ehto             |

Valitse lähde sen mukaan, missä tieto on luotettavimmin ylläpidetty. Jos tieto muuttuu verkkosivulla, lisää se verkkosivuna. Jos tieto on sisäisessä ohjeessa, lisää se tiedostona tai tekstinä.

## Lisää verkkosivusisältöä

Verkkosivut-välilehdellä Lisää lähde -valikossa on kaksi päävaihtoehtoa:

- Yksittäinen linkki lisää yhden tarkan sivun.
- Hae verkkosivulta hakee sivustolta useita sivuja valittavaksi.

### Yksittäinen linkki

Käytä Yksittäinen linkki -vaihtoehtoa, kun tiedät tarkasti, minkä sivun haluat lisätä.

1. **Liitä sivun osoite**

   Käytä koko osoitetta, esimerkiksi `https://yritys.fi/toimitusehdot`.
2. **Lisää linkki**

   Aihio lisää sivun jonoon ja käsittelee sen taustalla.

Yksittäinen linkki sopii hyvin esimerkiksi toimitusehtoihin, hinnastosivuun, yhteystietosivuun tai yhteen tärkeään ohjeartikkeliin.

### Hae verkkosivulta

Käytä Hae verkkosivulta -vaihtoehtoa, kun haluat löytää useita sivuja samalta sivustolta ilman, että sinun tarvitsee kerätä osoitteita käsin.

1. **Anna sivuston osoite**

   Käytä sivuston pääosoitetta, esimerkiksi `https://yritys.fi`.
2. **Valitse mukaan otettavat sivut**

   Aihio näyttää löydetyt sivut valittavaksi. Valitse sivut, joista chatbotin
   kannattaa vastata.
3. **Käynnistä käsittely**

   Valitut sivut siirtyvät jonoon. Eteneminen näkyy Tietopohja-näkymässä.

> **Valitse laatu ennen määrää:**
>
> Lisää mieluummin tärkeimmät palvelu-, hinta-, ohje- ja toimitusehtosivut kuin
> koko sivusto sellaisenaan. Tagisivut, arkistot, kampanjasivut ja tyhjät sivut
> heikentävät usein vastausten laatua.

## Lataa tiedostoja

Tiedostot-välilehdellä voit lisätä dokumentteja tietopohjaan. Voit pudottaa tiedostot latausalueelle tai valita ne koneelta.

Tuetut muodot:

- PDF
- DOCX
- TXT
- Markdown
- CSV
- HTML

Vanha `.doc`-muoto ei ole tuettu. Muunna se ensin DOCX- tai PDF-muotoon.

1. **Lisää tiedostot jonoon**

   Pudota tiedostot latausalueelle tai valitse ne tiedostonvalitsimella.
2. **Aloita lataus**

   Aihio lataa tiedostot ja käsittelee niiden sisällön taustalla.

Jos tiedoston käsittely epäonnistuu, tarkista tiedostomuoto, koko ja lukusuojaus. Skannattu PDF voi näyttää ihmiselle luettavalta, mutta sisältää kuvan tekstin sijaan. Tällöin teksti kannattaa muuntaa koneellisesti luettavaan muotoon ennen latausta.

## Lisää kysymyspari

Kysymyspari sopii tilanteeseen, jossa haluat chatbotin vastaavan usein toistuvaan kysymykseen täsmällisesti.

Hyvä kysymyspari:

- käyttää asiakkaan luonnollista kysymystapaa
- vastaa yhteen asiaan kerrallaan
- sisältää vastauksen ehdot ja rajaukset
- ei ole ristiriidassa verkkosivujen tai tiedostojen kanssa

| Kenttä  | Esimerkki                                                                                                                       |
| ------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Kysymys | Kuinka nopeasti tilaus toimitetaan?                                                                                             |
| Vastaus | Varastossa olevat tuotteet toimitetaan yleensä 2-4 arkipäivässä. Jos tuotteella on pidempi toimitusaika, se näkyy tuotesivulla. |

## Lisää teksti

Tekstilähde sopii lyhyelle sisällölle, jota ei ole järkevää tehdä omaksi tiedostoksi tai verkkosivuksi.

Hyviä käyttötapoja:

- poikkeavat aukioloajat
- kampanjan ehdot
- lyhyt sisäinen ohje
- tieto, joka puuttuu sivustolta mutta jota asiakkailta kysytään usein

Pidä tekstilähde yhtenäisenä. Jos siinä on monta erillistä aihetta, tee mieluummin useampi tekstilähde.

## Tilan lukeminen

Tietopohjan yläreunassa näkyy kompakti statusikoni. Se kertoo yhdellä silmäyksellä, onko chatbot valmis vastaamaan.

| Tila            | Miltä se näyttää         | Mitä se tarkoittaa                                                                |
| --------------- | ------------------------ | --------------------------------------------------------------------------------- |
| Valmis          | Vihreä onnistumisen tila | Tietopohjassa on käytettävää sisältöä eikä avoimia virheitä näy.                  |
| Käsitellään     | Animoitu käsittelytila   | Uusia lähteitä on jonossa tai käsittelyssä. Chatbot käyttää jo valmiita lähteitä. |
| Vaatii huomiota | Punainen varoitustila    | Osa lähteistä epäonnistui. Avaa lähde ja tarkista virheen syy.                    |
| Tyhjä           | Harmaa tila              | Tietopohjassa ei ole vielä lähteitä. Lisää ensimmäinen lähde.                     |

Vie hiiri statusikonin päälle nähdäksesi tarkemmat luvut: valmiit lähteet, käsittelyssä olevat lähteet, virheet, lähteiden kokonaismäärä ja viimeisin lisäys.

## Lähteiden hallinta

Lähdelistasta voit hakea, suodattaa ja hallita lähteitä.

| Toiminto          | Mistä löytyy                     | Milloin käyttää                                                                  |
| ----------------- | -------------------------------- | -------------------------------------------------------------------------------- |
| Haku              | Taulukon yläpuolella             | Kun etsit tiettyä URL-osoitetta tai otsikkoa                                     |
| Tilan suodatus    | Tila-valikko                     | Kun haluat nähdä esimerkiksi vain epäonnistuneet tai käsittelyssä olevat lähteet |
| Sivuston suodatus | Lähde-valikko verkkosivuissa     | Kun tietopohjassa on usean sivuston sisältöä                                     |
| Avaa tiedot       | Rivin toimintovalikko            | Kun haluat nähdä sisällön, metatiedot tai virheen syyn                           |
| Päivitä           | Rivin toimintovalikko tai drawer | Kun yksittäinen verkkosivu pitää hakea uudelleen                                 |
| Poista            | Rivin toimintovalikko tai drawer | Kun lähde on vanha, väärä tai tarpeeton                                          |

## Automaattinen päivitys

Verkkosivut-välilehdellä näkyvä Automaattinen päivitys koskee verkkosivulähteitä. Kun se on käytössä, Aihio tarkistaa sivuston muutokset valitulla aikataululla ja päivittää muuttuneet sivut tietopohjaan.

Automaattinen päivitys on hyödyllinen, jos:

- hinnat, palvelut tai toimitusehdot muuttuvat säännöllisesti
- sivustolle lisätään usein uusia ohjesivuja
- haluat vähentää käsin tehtävää ylläpitoa

Automaattinen päivitys ei korvaa kaikkea ylläpitoa. Tiedostot, kysymysparit ja tekstit kannattaa tarkistaa aina, kun yrityksen tiedot muuttuvat.

## Käyttöaste ja rajat

Statusikonin vieressä näkyy tietopohjan käyttöaste. Se näyttää visuaalisesti, kuinka paljon sivu- ja sisältörajasta on käytössä. Tarkat arvot näkyvät hoverilla.

Käyttöaste auttaa huomaamaan ajoissa, milloin:

- tietopohja alkaa lähestyä paketin rajaa
- uusia lähteitä kannattaa valita tarkemmin
- paketin päivittäminen voi olla järkevää

Jos raja lähestyy, poista ensin vanhat, päällekkäiset tai vähäarvoiset lähteet. Lisää vain sellaiset sivut ja dokumentit, joiden perusteella chatbotin oikeasti kannattaa vastata.

## Testaa, löytyykö sisältö

Kun olet lisännyt tärkeän lähteen, testaa se ennen kuin luotat siihen asiakaskeskusteluissa.

1. **Avaa lähteen tiedot**

   Klikkaa lähderiviä tai valitse rivin valikosta Avaa tiedot.
2. **Avaa hakutesti**

   Käytä lähteen hakutestiä ja kirjoita kysymys asiakkaan sanoin.
3. **Tarkista löytyvä sisältö**

   Jos oikea sisältö löytyy, lähde on käyttökelpoinen. Jos ei, lähde tarvitsee
   tarkennusta.

Jos haku ei löydä oikeaa sisältöä:

- lisää tarkempi kysymyspari
- jaa pitkä teksti selkeämmiksi osiksi
- lisää puuttuva verkkosivu tai tiedosto
- poista vanha tai ristiriitainen lähde

## Yleisimmät ongelmat

| Ongelma                              | Todennäköinen syy                                                      | Mitä tehdä                                                                     |
| ------------------------------------ | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| Sivua ei löydy                       | Osoite on väärä, sivu on poistettu tai sivu vaatii kirjautumisen       | Avaa osoite selaimessa ja lisää oikea julkinen sivu uudelleen                  |
| Lähde jää käsittelyyn                | Sisällön haku tai purku on vielä kesken                                | Odota hetki ja päivitä näkymä myöhemmin                                        |
| Tiedosto epäonnistuu                 | Tiedosto on liian suuri, lukusuojattu tai ei sisällä luettavaa tekstiä | Muunna tiedosto PDF- tai DOCX-muotoon ja varmista, että teksti on valittavissa |
| Sisältö jäi vajaaksi                 | Sivulla on vähän tekstiä tai sisältö latautuu vain selaimessa          | Lisää parempi lähde tai kirjoita tieto tekstilähteeksi                         |
| Chatbot ei vastaa uudesta sisällöstä | Lähde ei ole vielä valmis tai kysymys ei vastaa lähteen sanastoa       | Odota valmis-tilaa ja testaa hakutestillä asiakkaan sanoin                     |
| Vastaus on ristiriitainen            | Tietopohjassa on kaksi eri lähdettä, jotka sanovat eri asian           | Poista tai korjaa vanha lähde                                                  |

## Ylläpidon rutiini

Hyvä tietopohja pysyy laadukkaana vain, jos sitä ylläpidetään.

Tarkista tietopohja aina, kun:

- hinnat muuttuvat
- toimitusajat tai ehdot muuttuvat
- palveluvalikoima muuttuu
- sivustolle lisätään uusi tärkeä ohjesivu
- keskusteluissa näkyy kysymys, johon chatbot ei osaa vastata

Kuukausittain kannattaa:

- tarkistaa epäonnistuneet lähteet
- poistaa vanhat kampanja- ja arkistosivut
- lisätä puuttuvat usein kysytyt kysymykset kysymyspariksi
- testata tärkeimmät asiakaspolut hakutestillä

## Ennen julkaisua

Käy tämä tarkistuslista läpi ennen kuin julkaiset chatbotin asiakkaille:

- Tietopohjan status on valmis tai tiedät, mitkä lähteet ovat vielä kesken.
- Tärkeimmät palvelu-, hinta-, toimitus- ja yhteystietosivut on lisätty.
- Vanhat tai ristiriitaiset lähteet on poistettu.
- Usein toistuvat kysymykset on lisätty kysymyspariksi.
- Olet testannut vähintään 10 asiakkaan luonnollista kysymystä.
- Tiedät, kuka vastaa tietopohjan ylläpidosta jatkossa.


---

# Mukautetut HTTP-toiminnot

URL: https://aihio.ai/ohjekeskus/tekoalyagentti/toiminnot
Kuvaus: Määrittele HTTPS-rajapintakutsu, jonka agentti täyttää ja palvelin suorittaa keskustelun aikana. Tunnukset säilytetään salattuina ja kutsut on suojattu.

Mukautetuilla HTTP-toiminnoilla tekoälyagentti voi kutsua omaa HTTPS-rajapintaasi kesken keskustelun: esimerkiksi hakea tilauksen tilan, varata ajan tai luoda tukipyynnön suoraan omasta järjestelmästäsi. Sinä määrität rajapinnan ja parametrit, tekoälyagentti täyttää parametrit keskustelusta ja Aihion palvelin suorittaa kutsun turvallisesti.

## Edellytykset

- **Aihio-tilaus Starter-tasolta ylöspäin.**
- **HTTPS-rajapinta**, jota agentti kutsuu. Vain `https` hyväksytään, ja kutsut suoritetaan palvelinpuolella SSRF-suojattuna (yksityiset ja sisäverkko-osoitteet estetään).
- Tarvittaessa **rajapinnan tunnus** (Bearer-token tai API-avain).

## Toiminnon luonti

1. **Avaa Toiminnot-välilehti**

   Ohjauspaneelissa: **Chatbotit → valitse chatbot → Asetukset → Toiminnot**. Valitse **Lisää toiminto**.
2. **Määrittele perustiedot**
   - **Tunniste** on toiminnon koneluettava nimi (snake\_case, esim. `hae_tilaus`). Tekoälyagentti viittaa toimintoon tällä nimellä.
   - **Kuvaus** kertoo tekoälyagentille, *milloin* toimintoa käytetään. Kirjoita se selkeästi, esimerkiksi "Hae asiakkaan tilauksen tila tilausnumerolla."
   - **URL** ja **HTTP-metodi** (GET, POST, PUT, PATCH tai DELETE). URL:n on alettava merkeillä `https://`.
3. **Lisää parametrit**

   Parametrit ovat tietoja, jotka tekoälyagentti kerää keskustelusta ja täyttää kutsuun. Anna jokaiselle parametrille nimi (snake\_case), näyttönimi ja tyyppi (teksti, sähköposti tai puhelin). Viittaa parametriin URL:ssä, otsikoissa tai rungossa kaksoisaaltosulkeilla, esimerkiksi `https://api.esimerkki.fi/tilaukset/{{tilausnumero}}`.

   Voit lisäksi antaa parametrille valinnaisen vihjeen tekoälylle (esimerkiksi "Asiakkaan tilausnumero, kuten ORD-123"). Vihje parantaa sitä, miten tarkasti agentti täyttää kentän keskustelusta.

   Pyynnössä käytetyn parametrin on oltava pakollinen, jotta kutsu ei suoriudu vajailla tiedoilla.
4. **Valitse todennus**
   - **Ei todennusta** julkisille rajapinnoille.
   - **Bearer-token** tai **API-avain**: syötä tunnus kerran. Se tallennetaan salattuna (Supabase Vault), eikä sitä näytetä enää myöhemmin; vain viimeiset merkit jäävät näkyviin tunnistamista varten.
5. **(Valinnainen) Välitä varmennetun käyttäjän tiedot**

   Jos chat-widget varmentaa käyttäjän henkilöllisyyden (ks. [Identiteetin varmennus](/ohjekeskus/tekoalyagentti/identiteettivarmistus)), voit välittää varmennetut tiedot kutsuun viittauksilla kuten `{{identity.email}}`. Tämä edellyttää, että toiminnossa on **Vaadi varmennettu identiteetti** käytössä.

   **Tunnistetietojen välitys edellyttää JWT-varmennusta.** Vain allekirjoitettu JWT tuo `{{identity.*}}`-kentät HTTP-toimintojen käyttöön. HMAC-tiivistemenetelmällä käyttäjä varmennetaan näyttöä varten, mutta tunnistetietojen viittaukset jäävät tyhjiksi ja kutsu epäonnistuu hallitusti. Käytä allekirjoitettua JWT:tä, jos toimintosi lähettää tunnistetietoja.

   Koska tällöin lähetät henkilötietoja omaan järjestelmääsi, varmista että käsittely on tietosuoja-asetuksen mukaista. Aihio näyttää tästä muistutuksen.
6. **Ota käyttöön ja testaa**

   Voit testata toiminnon jo ennen tallennusta: syötä esimerkkiarvot lomakkeen **Testaa toiminto** -osiossa ja suorita kutsu, jolloin näet rajapinnan vastauksen ja statuksen heti. Autentikoidun toiminnon testaaminen edellyttää tunnuksen syöttämistä.

   Kun toiminto on valmis, kytke se päälle ja kokeile keskustelua, joka laukaisee sen. Kun tekoälyagentti suorittaa toimintoa, chat-widget näyttää siitä ilmaisimen vierailijalle.

## Miten se toimii

Kun keskustelu vastaa toiminnon kuvausta, tekoälyagentti kutsuu toimintoa: se täyttää parametrit, ja Aihion palvelin suorittaa HTTP-kutsun ja palauttaa vastauksen agentille, joka muotoilee siitä vastauksen asiakkaalle. Kutsut ovat aina `https`, ne on SSRF-suojattu, ja vain määrittelemäsi parametrit ja varmennetut identiteettitiedot välitetään. Mitään muuta keskustelun sisältöä ei lähetetä rajapintaasi automaattisesti.

## Ominaisuuskirjasto

Toiminnot-sivun yläosassa on ominaisuuskirjasto: kortit valmiista ominaisuuksista, kuten tietopohjavastauksista, liidienkeruusta ja ihmistuesta. Kortti kertoo yhdellä silmäyksellä kolme asiaa:

- **Tila**: "Saatavilla" tarkoittaa, että ominaisuuden voi ottaa käyttöön heti; "Tulossa" tarkoittaa, että se on vasta kehitteillä.
- **Tilaustaso**: jos ominaisuus vaatii nykyistä korkeamman tilaustason, kortissa näkyy tason merkki (esimerkiksi Starter tai Pro). Merkki katoaa, kun taso riittää.
- **Määritä**: painike vie suoraan oikeaan asetusnäkymään, esimerkiksi tietopohjaan tai ihmistuen asetuksiin.

**Testaa**-painike ajaa ominaisuudelle valmiustestin: se tarkistaa, onko ominaisuus käytössä tällä botilla, ja Vastaa tietopohjasta -kortin kohdalla myös, onko tietopohjassa sisältöä. Tulos näkyy värillisenä merkkinä (valmis, osittain valmis tai vaatii toimia), ja tarkemmat tiedot avautuvat viemällä osoitin merkin päälle. Testi ei lähetä viestejä eikä muuta asetuksia.

## Tietoturva

- Tunnukset tallennetaan salattuina, eikä niitä koskaan paljasteta selaimelle.
- Kutsut suoritetaan palvelinpuolella: vain `https`, portti 443, ei uudelleenohjauksia, vastekoon raja ja aikakatkaisu.
- Yksityiset, sisäverkko- ja metadata-osoitteet estetään (SSRF-suoja).


---

# WordPress-lisäosa

URL: https://aihio.ai/ohjekeskus/tekoalyagentti/wordpress-lisaosa
Kuvaus: Lisää Aihio-chatbot WordPress-sivustoon virallisella lisäosalla ja yhden napsautuksen yhteydellä.

Virallinen **Aihio Chatbot** -lisäosa liittää chatbotin WordPress-sivustoon ilman koodia. Aihio säilyttää tietosi EU:ssa ja noudattaa GDPR:ää – myös kielimallit ajetaan EU:ssa (Mistral AI, Ranska), joten keskustelutietoja ei siirretä EU:n ulkopuolelle. Lisäosa osaa lisäksi tunnistaa kirjautuneet käyttäjät varmennetusti.

## Asenna lisäosa

1. Siirry WordPressin ohjausnäkymässä kohtaan **Lisäosat → Lisää uusi**.
2. Hae hakukentällä **Aihio Chatbot**.
3. Napsauta **Asenna nyt** ja sen jälkeen **Ota käyttöön**.

## Yhdistä Aihioon

Lisäosa käyttää turvallista yhden napsautuksen yhteyttä (OAuth), joten chatbotin tunnusta ei tarvitse kopioida käsin.

1. Avaa **Asetukset → Aihio Chatbot**.
2. Napsauta **Yhdistä Aihioon**. Sinut ohjataan Aihion ohjauspaneeliin.
3. Hyväksy yhteys ja valitse chatbot, jonka haluat liittää sivustoon.

Tämän jälkeen chat-widget näkyy sivustollasi heti. Voit vaihtaa chatbotia milloin tahansa toistamalla yhdistämisen.

## Tunnista kirjautuneet käyttäjät

Voit halutessasi näyttää chatbotille, kuka kirjautunut käyttäjä on. Tunnistus varmennetaan palvelimella.

1. Hae tunnistussalaisuus chatbotin kohdasta **Asetukset → Suojaus → Identiteetin varmistus**.
2. Lisää se WordPressiin `AIHIO_IDENTITY_SECRET`-vakiona `wp-config.php`-tiedostoon (suositeltu) tai lisäosan asetuskenttään.
3. Ota lisäosan asetuksista käyttöön **Tunnista kirjautuneet käyttäjät**.

## Suostumus ja evästeet

Jos sivustollasi on suostumustenhallinta (Complianz, CookieYes, Real Cookie Banner), lisäosa voi noudattaa sen tilaa. Ota asetuksista käyttöön **Lykkää lataus suostumustenhallintaan**, niin chat-widget latautuu vasta toiminnallisen suostumuksen jälkeen.

## Manuaalinen vaihtoehto

Jos et halua käyttää lisäosaa, voit liittää koodinpätkän käsin. Katso ohjeet [julkaisuoppaasta](/ohjekeskus/tekoalyagentti/julkaisu).


---

# Yleiskatsaus

URL: https://aihio.ai/ohjekeskus/ominaisuudet/yleiskatsaus
Kuvaus: Aihion ominaisuudet ja niiden käyttötarkoitukset.

Aihion ominaisuudet kattavat chatbotin koko elinkaaren — rakentamisesta, julkaisusta ja ylläpidosta aina analytiikkaan saakka.

## Keskeiset ominaisuudet

- **Helppokäyttöinen rakentaja** — luo chatbot ilman koodaustaitoja
- **Tietopohjan hallinta** — lisää dokumentteja, URL-osoitteita ja manuaalisia vastauksia
- **Monikielinen tuki** — suomi ja englanti oletuksena, muut kielet lisättävissä
- **Integraatiot** — Slack, Teams, sähköposti, CRM-järjestelmät
- **Analytiikka** — seurannaiset käyttäjäkohtaamiset ja tyytyväisyysmittarit
- **GDPR-yhteensopiva** — EU-pohjainen palvelu, tietosuoja ensin

> **Lisää ominaisuuksia tulossa:**
>
> Aihiota kehitetään aktiivisesti. Seuraa muutosloki-sivua kuullaksesi uusimmat
> päivitykset.


---

# Aloitus

URL: https://aihio.ai/ohjekeskus/aloita/aloitus
Kuvaus: Pääset alkuun Aihion chatbotin rakentamisessa ja julkaisemisessa.

Tervetuloa Aihion käyttöön. Tämä aloitussivu kokoaa tärkeimmät vaiheet, joiden avulla rakennat ensimmäisen chatbotin ja julkaiset sen omalle verkkosivustollesi.

## Mitä tarvitset

- Sähköpostiosoite tilin luontiin
- Verkkosivusto, jolle haluat upottaa chat-widgetin
- Sisältöä tietopohjaan: tekstiä, dokumentteja tai sivuston URL-osoitteita

> **Vinkki:**
>
> Voit aloittaa ilmaisella tilillä — luottokorttia ei tarvita.

## Seuraavaksi

1. Luo chatbot ohjauspaneelissa.
2. Lisää tietopohjaan tärkeimmät verkkosivut, tiedostot, kysymysparit tai tekstit.
3. Testaa vastaukset ennen julkaisua.
4. Julkaise chatbot sivustolle, kun vastaukset ovat valmiita asiakkaille.

Kun dokumentaatio laajenee, tämä sivu toimii käyttäjän ensimmäisenä lähtöpisteenä.


---

# Julkaise sivustolle

URL: https://aihio.ai/ohjekeskus/aloita/julkaise-sivustolle
Kuvaus: Liitä valmis chatbot verkkosivuillesi.

Kun chatbot on valmis, julkaiseminen vie minuutin.

## Upota koodinpätkä

Avaa chatbotin **Muokkain** ja valitse **Asenna → Verkkosivun chat-widget**.
Kopioi `<script>`-elementti ja liitä se sivuston `</body>`-tagia ennen.

> **Sijoituspaikka:**
>
> Koodinpätkä toimii missä tahansa sivuston pohjassa, mutta paras paikka on juuri ennen `</body>`-tagia.

## Tarkista toiminta

Avaa sivustosi selaimessa ja varmista että chat-widget ilmestyy oikeaan alakulmaan.

**Rakenna ensimmäinen agentti ilmaiseksi** — Aloita omalla sisällölläsi ilman luottokorttia.

[Aloita ilmaiseksi](#)


---

# Luo ensimmäinen chatbot

URL: https://aihio.ai/ohjekeskus/aloita/luo-ensimmainen-chatbot
Kuvaus: Vaiheittainen ohje uuden chatbotin luomiseen.

Tällä sivulla kuvataan chat-widgetin rakentajan päävaiheet.

1. **Kirjaudu ohjauspaneeliin**

   Avaa selaimessa osoite [app.aihio.ai](https://app.aihio.ai) ja kirjaudu
   tilillesi.
2. **Luo uusi chatbot**

   Valitse "Luo uusi chatbot" -painike ja anna sille kuvaava nimi.
3. **Valitse käyttötarkoitus**

   Aihio ehdottaa malleja yleisille käyttötarkoituksille — asiakaspalvelu,
   myynti, tukeen ohjaaminen.
4. **Lisää tietopohja**

   Lataa dokumentteja tai anna sivuston URL-osoite, josta Aihio rakentaa
   hakurakenteen.
5. **Esikatsele ja testaa**

   Käynnistä esikatselu rakentajan oikeasta yläkulmasta ja kokeile kysymyksiä.


---

# Usein kysytyt kysymykset

URL: https://aihio.ai/ohjekeskus/tuki/usein-kysytyt-kysymykset
Kuvaus: Vastaukset yleisimpiin kysymyksiin.

Tältä sivulta löytyvät vastaukset yleisimpiin kysymyksiin.

**Voinko käyttää Aihiota ilmaiseksi?**

Kyllä. Ilmainen tili sisältää yhden chatbotin ja rajallisen määrän
keskusteluja kuukaudessa. Se sopii kokeiluun ja pieniin käyttötarkoituksiin.

**Missä tieto sijaitsee?**

Aihio toimii EU:n alueella. Tietoja ei siirretä EU:n ulkopuolelle. Palvelu
on GDPR-yhteensopiva.

**Kuinka paljon tietopohja voi olla?**

Ilmaisessa tilissä tietopohja on rajoitettu. Kasvu- ja yritystileillä raja
on olennaisesti korkeampi. Tarkat rajat löytyvät hinnoittelu-sivulta.

**Tukeeko Aihio muita kieliä kuin suomea ja englantia?**

Chatbot osaa vastata kaikilla kielillä, joilla taustalla oleva kielimalli
toimii. Ohjauspaneelin kielet ovat suomi ja englanti.


---

## Optional

- [FI: Documentation](https://aihio.ai/ohjekeskus)
- [FI: Pricing](https://aihio.ai/hinnoittelu)
- [FI: Data processing agreement](https://aihio.ai/juridiikka/tietojenkasittelysopimus)
- [EN: Documentation](https://aihio.ai/en/help)
- [EN: Pricing](https://aihio.ai/en/pricing)
- [EN: Data processing agreement](https://aihio.ai/en/legal/data-processing-agreement)