> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Puheagentin asetusten viite

> Kaikki ThunderPhone-puheagentin asetukset selitettyinä: tasot, äänet, kielet, vahvistukset, työkalut, puhejärjestys, vastaajaviestit, suostumusilmoitukset, hiljaisuuden käsittely, testaus ja käyttöönotto.

Avaa **Puheagentit**, valitse agentti ja hallitse sen ääntä, päättelyä,
puhelujen aloitusta, työkalujen käyttöä, hiljaisuuden ja vastaajan käsittelyä
sekä soittajien tavoittamista sen **Asetukset**-välilehdellä. Muutokset
tallentuvat automaattisesti luonnokseen; tuotantoliikenne ei muutu, ennen kuin
valitset **Ota käyttöön**.

Tämä sivu on täydellinen hallintapaneelin viite. Kenttien nimet ja
pyyntöesimerkit löydät [agenttien API-viitteestä](/api-reference/agents).

## Kehote ja identiteetti

Agentin nimi tunnistaa sen kaikkialla hallintapaneelissa, raporteissa,
puheluhistoriassa ja asiakasportaaleissa. Kehote on agentin toimintakäsikirjoitus:
persoona, yritystiedot, pakolliset kysymykset, eskalointikäytäntö ja
puhelutoiminnot.

Kehoteeditori näyttää arvioidun tokenimäärän ja merkitsee yleiset ongelmat,
kuten tyhjän kehotteen, ratkaisemattomat mallipaikkamerkit, puuttuvan
eskalointipolun tai erittäin pitkän kehotteen. Ensimmäiset **5 000 arvioitua tokenia**
sisältyvät hintaan; pidemmistä kehotteista veloitetaan
[lohkopohjainen lisämaksu](/fi/guides/pricing).

<Tip>
  Siirrot, näppäinpainallukset, pidossa toimiminen ja puhelun lopettamista koskevat
  päätökset voidaan kirjoittaa suoraan kehotteeseen. Liitä API-, sovellus-, MCP-
  tai tietämystyökaluja, kun agentti tarvitsee ulkoista dataa tai toimintoja.
</Tip>

## Mallitaso

| Taso      | Perushinta | Soveltuu parhaiten                                                   |
| --------- | ---------: | -------------------------------------------------------------------- |
| **Spark** |    2 ¢/min | Kustannusherkkiin, suoraviivaisiin puheluihin.                       |
| **Bolt**  |    5 ¢/min | Nopeisiin vastauksiin ja tasapainoisiin päivittäisiin työnkulkuihin. |
| **Storm** |    9 ¢/min | Monimutkaisiin ohjeisiin, äänen ymmärtämiseen ja päättelyyn.         |

Storm tarjoaa kaksi valinnaista hallintaa:

* **Kuittaus** — **Ei mitään** pysyy hiljaa valmistellessaan koko vastausta;
  **Tikitys** toistaa hiljaisen odotusäänen; **Sanallinen** lausuu lyhyen kuittauksen
  ja lisää **2 ¢/min**. Sanallinen teksti voidaan luoda pääkehotteesta tai
  antaa manuaalisesti API:n kautta.
* **Lisää älykkyyttä** — lisää syvempää päättelyä monimutkaisiin puheluihin ja
  **3 ¢/min**.

Rakentaja näyttää jatkuvasti agentin **kokonaishinnan minuutilta**, mukaan lukien
tason, ääni-/kielipolun, kehotteen pituuden, sanallisen kuittauksen, lisä-älykkyyden
ja valvonnan.

## Ääni, tausta ja kielet

Valitse ääni ja toista sen näyte ennen käyttöönottoa. Valitsin tarjoaa vain
kaikkien valittujen kielten kanssa yhteensopivia ääniä ja merkitsee
premium-yhdistelmät niiden lisämaksulla. Mukautetut äänesi näkyvät samassa
valitsimessa, kun ne ovat valmiita. Katso
[Äänikirjasto ja mukautetut äänet](/fi/guides/voice-library).

**Taustaääni** voi olla:

* **Ei mitään** — ei taustaääntä.
* **Puhelukeskus** — puhelukeskustunnelma, jonka esikuuntelu on käytettävissä hallintapaneelissa.

Aseta yksi **ensisijainen kieli** ja sitten haluamasi määrä **lisäkieliä**.
Agentti tunnistaa automaattisesti, kun soittaja vaihtaa valittuun kieleen, ja
vastaa sillä. Jotkin ääni-/kieliyhdistelmät lisäävät **3 ¢/min**; katso luotu
[Tuetut kielet](/fi/guides/supported-languages) -luettelo.

## Yhdistetyt ominaisuudet

Asetukset-välilehdellä on neljä toisistaan riippumatta liitettävää
ominaisuusosiota:

| Osio                       | Käyttötarkoitus                                                                                                     |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Yhdistetyt sovellukset** | Hyväksytyt toiminnot Google Calendarissa, Google Sheetsissä, Slackissa, HubSpotissa, Salesforcessa tai Cal.comissa. |
| **API-yhteydet**           | Omat HTTP-päätepisteesi, jotka kuvataan kutsuttavina funktioina.                                                    |
| **Tietämys**               | Tiedostot tai verkkosisältö, joista agentti voi hakea tietoa puhelun aikana.                                        |
| **MCP-palvelimet**         | Välimuistiin tallennetut työkalut, jotka löydetään etäisistä Model Context Protocol -palvelimista.                  |

Liite on osa luonnosta ja tulee tuotantopuhelujen käyttöön käyttöönoton
jälkeen. Määritä resurssit ensin kohdassa **Yhteydet** tai **Tietämys** ja
liitä ne sitten agenttiin.

## Puhelin- ja verkkopäätepisteet

Liitä kohdassa **Puhelinnumerot** olemassa oleva numero, varaa demonumero tai
tuo numero VoIP-yhteyden kautta. Numero voi käyttää eri agentteja saapuvissa ja
lähtevissä puheluissa.

Liitä kohdassa **Verkkovimpaimet** vimpain, jotta sivuston kävijät voivat puhua
agentin kanssa. Vimpaimen saatavuus voidaan myös ottaa käyttöön tai poistaa
käytöstä osana agentin määritystä.

## Puheluiden edistynyt toiminta

Laajenna asetusten alaosassa **Lisäasetukset** nähdäksesi seuraavat hallintatoiminnot.

### Valvonta

Kun toiminto on käytössä, toinen tekoälyvalvoja tarkistaa jokaisen agentin vuoron ohjeiden mukaisuuden ja voi puuttua tilanteeseen huomaamattomasti. Valvonta lisää hintaan **8 ¢/minuutti**, eikä se ole käytettävissä Boltissa.

### Yhdistämisääni

Toista lyhyt ääni heti puhelun yhdistymisen jälkeen ja ennen kuin kumpikaan osapuoli puhuu.

### Työkalun ääni

Valitse kehotteesta kutsuttavan äänityökalun tuottama ääni:

* **Ei mitään** — työkalua ei tarjota.
* **Helähdys**, **Kilahdus** tai **Piippaus** — jokaista voi esikuunnella rakennustyökalussa.

### Kuka puhuu ensin

Määritä saapuvat ja lähtevät puhelut erikseen:

* **Saapuva:** agentti puhuu ensin tai soittaja puhuu ensin.
* **Lähtevä:** agentti puhuu ensin tai vastaanottaja puhuu ensin.

Tämä asetus on hyödyllinen lähtevissä automaattisoittajissa, joiden on odotettava henkilöä tai puhelinvalikkoa ennen käsikirjoituksen aloittamista.

### Vastaajaviestien käsittely

Valitse, mitä tapahtuu, kun lähtevä puhelu ohjautuu vastaajaan:

| Vaihtoehto                  | Toiminta                                                                          |
| --------------------------- | --------------------------------------------------------------------------------- |
| **Anna agentin päättää**    | Kehote ja keskustelun konteksti määrittävät, puhutaanko vai katkaistaanko puhelu. |
| **Katkaise hiljaa**         | Lopeta jättämättä viestiä.                                                        |
| **Jätä viesti ja katkaise** | Sano määritetty viesti ja lopeta puhelu.                                          |

Vastaajaviestit voivat sisältää enintään **2 000 merkkiä**, ja ne tukevat
muuttujia `{agent_name}` ja `{org_name}`. Katso
[hinnoittelusta](/fi/guides/pricing), miten puheluaika
laskutetaan.

### Suostumusilmoitus

Oletusarvoisesti jokaisen puhelun alussa toistetaan lyhyt ilmoitus, joka kertoo
soittajalle, että hän puhuu tekoälyavustajan kanssa ja että puhelu tallennetaan.
Voit muokata ilmoituksen tekstiä enintään **2 000 merkin** pituiseksi; se
toistetaan sellaisenaan agentin kielellä.

Ilmoituksen poistaminen käytöstä kelpoisessa agentissa edellyttää, että
organisaation ylläpitäjä vahvistaa organisaation antavan kaikki lain edellyttämät
ilmoitukset ja hankkivan kaikki lain edellyttämät suostumukset. Ilmoituksen
ottaminen uudelleen käyttöön ja myöhempi poistaminen käytöstä edellyttää uutta
vahvistusta. Tutustu
[tallennussuostumuslakeja käsittelevään oppaaseen](/fi/guides/recording-consent-laws)
ennen tämän asetuksen muuttamista.

### Hiljaisuustarkistukset

Kun toiminto on käytössä, agentti tarkistaa hiljaisuuden jälkeen, onko soittaja
edelleen paikalla, toistaa tarkistuksen enintään määrittämääsi rajaan asti ja
katkaisee sitten puhelun:

* **Sekuntia ennen tarkistusta:** 10–120 sekuntia.
* **Tarkistusten enimmäismäärä:** 1–10.

Oletusarvot ovat 15 sekuntia ja 3 tarkistusta.

## Rakennustyökalun välilehdet ja elinkaari

| Välilehti tai toiminto  | Tarkoitus                                                                                              |
| ----------------------- | ------------------------------------------------------------------------------------------------------ |
| **Livenä / Keskustele** | Keskustele selaimessa nykyisen luonnoksen kanssa ja tarkastele litterointia sekä työkalujen toimintaa. |
| **Puhelut**             | Tarkastele tämän agentin käsittelemiä puheluita.                                                       |
| **A/B**                 | Luo kehotteen tai määrityksen muunnelmia ja vertaile reaaliaikaisia tuloksia.                          |
| **Simuloi**             | Suorita tallennettuja tai tapauskohtaisia tekoälysoittajaskenaarioita luonnosta vastaan.               |
| **Validointi**          | Toista jäädytettyjä oikeiden puheluiden vuoroja luonnosta vastaan ennen käyttöönottoa.                 |
| **Historia**            | Vertaile käyttöön otettuja versioita ja palauta yksi niistä luonnokseen.                               |
| **Hylkää**              | Palauta kaikki odottavat luonnosasetukset käyttöön otettuun versioon.                                  |
| **Ota käyttöön**        | Ota koko luonnos käyttöön atomisesti ja luo versio.                                                    |

Jos toinen muokkaaja tallentaa saman agentin sen jälkeen, kun olet ladannut sen,
ThunderPhone estää ristiriitaisen tallennuksen tai käyttöönoton ja pyytää sinua
päivittämään sivun sen sijaan, että se korvaisi heidän muutoksensa.

## Hallitse agentteja luettelosta

**Puheagentit**-sivu tukee myös organisaatiotason elinkaaritoimia:

* **Kopioi** agentti uudeksi lähtökohdaksi samassa organisaatiossa.
* **Siirrä** agentti toiseen organisaatioon, johon kuulut. **Kopioi** säilyttää
  alkuperäisen; **Siirrä** poistaa sen nykyisestä organisaatiosta ja edellyttää
  järjestelmänvalvojan käyttöoikeuksia.
* Valitse yksi tai useampi agentti ja vie niiden näkyvissä oleva määritys
  **CSV**- tai **JSON**-muodossa.
* Poista yksi agentti tai poista valitut agentit joukkopoistona vahvistuksen jälkeen.

Agentin kopioiminen tai siirtäminen organisaatioiden välillä ei automaattisesti
anna kohdeorganisaatiolle pääsyä vain lähdeorganisaation yhteyksiin. Tarkista
kopioidun agentin sovellus-, API-, tietämys-, MCP-, puhelinnumero- ja
widget-liitokset ennen sen käyttöönottoa siellä.

## Aiheeseen liittyvät sivut

<CardGroup cols={2}>
  <Card title="Rakenna ensimmäinen agenttisi" icon="robot" href="/fi/guides/build-an-agent">
    Tiivis kokonaisvaltainen rakennusohje.
  </Card>

  <Card title="Hinnoittelu" icon="coins" href="/fi/guides/pricing">
    Perustasot, lisäosat, puheluiden mittaus, numerot ja kertaluonteiset maksut.
  </Card>

  <Card title="Validointijoukot" icon="list-check" href="/fi/guides/validation-sets">
    Tallenna oikeiden puheluiden vuorot ja toista ne ennen käyttöönottoa.
  </Card>

  <Card title="Agenttien API" icon="code" href="/api-reference/agents">
    Pyyntökentät, luonnokset, käyttöönotot, versiot ja esimerkit.
  </Card>
</CardGroup>
