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

# Ohje kehotteiden laatimiseen

> Taktiikoita ja kopioitavia mallipohjia kehotteisiin, jotka kuulostavat luonnollisilta puhelimessa ja toimivat myös oikeiden soittajien kanssa.

Kehote on agenttisi toimintakäsikirjoitus: kuka se on, mitä se tietää,
miten se hoitaa puhelun ja mitä se ei saa koskaan tehdä — selkeällä
kielellä, millä tahansa kielellä. Tällä sivulla käsitellään kehotteen
rakennetta, puhelussa tärkeimpiä toimintatapoja ja kolmea valmista mallia,
joista voit aloittaa.

<Tip>
  Siirrytkö toiselta alustalta? Liitä nykyinen kehotteesi — tai koko
  viety agentti-JSONisi — [copilotiin](/fi/guides/ask-the-copilot) ja pyydä
  sitä määrittämään agentti puolestasi.
</Tip>

## Aloita rungosta

Lähes jokainen hyvä puheagentin kehote vastaa viiteen kysymykseen. Käytä
osion otsikoita — ne eivät maksa mitään ja pitävät pitkät kehotteet
muokattavina:

```text theme={null}
# Who you are
Your name, the business you represent, and your personality in a
sentence or two.

# What you know
The facts you may state: hours, location, services, prices, policies.

# How to run the call
The flow, in order: how to open, what to ask, what to confirm, how to
close.

# Rules
What you must always do and must never do.

# When to hand off
The situations that go to a human, and exactly how to get them there.
```

Rakentajan kehote-editori näyttää arvioidun tokenimäärän kirjoittaessasi
ja merkitsee yleiset ongelmat — tyhjän kehotteen, jäljelle jääneet
mallipaikkamerkit tai puuttuvan eskalointipolun. Ensimmäiset **5 000
arvioitua tokenia** sisältyvät perushintaan; pidemmistä kehotteista
veloitetaan [lohkopohjainen lisämaksu](/fi/guides/pricing).

## Puhelussa olennaiset taktiikat

### Ole tarkka, älä yleisluontoinen

Epämääräiset ohjeet tuottavat epämääräisiä agentteja. Nimeä tarkka toiminta, jonka haluat:

| Sen sijaan että kirjoittaisit       | Kirjoita                                                             |
| ----------------------------------- | -------------------------------------------------------------------- |
| "Ole huolellinen tilausten kanssa." | "Vahvista tilausnumero soittajalle ennen muutosten tekemistä."       |
| "Ole ammattimainen."                | "Käytä soittajan nimeä, kun tiedät sen. Älä koskaan keskeytä."       |
| "Auta ajanvarauksissa."             | "Tarjoa kahta aikaisinta vapaata aikaa ja kysy sitten, kumpi sopii." |

### Kirjoita korvalle, älä silmälle

Soittajat kuulevat agentin — he eivät voi silmäillä tai lukea uudelleen. Ohjeista agenttia pitämään puheenvuorot lyhyinä, esittämään **yhden kysymyksen kerrallaan** ja kertomaan, miten tiedot luetaan ääneen:

```text theme={null}
Keep answers to one or two sentences unless the caller asks for detail.
Read phone numbers digit by digit. Read prices as "nineteen ninety-nine".
Spell email addresses letter by letter, and say "at" and "dot".
```

### Vahvista kaikki, minkä virheellisyyttä et hyväksyisi

Puheentunnistus kuulee nimiä, numeroita ja osoitteita väärin. Sisällytä kulkuun takaisinlukeminen:

```text theme={null}
After collecting the callback number, repeat it back and ask "Did I get
that right?" before moving on.
```

### Kirjoita käsikirjoitus myös hankalia tilanteita varten

Sujuva kulku kirjoittaa itse itsensä; puhelut voitetaan ja hävitään kaikkialla muualla. Anna agentille repliikki jokaiseen ennakoitavissa olevaan tilanteeseen — väärään numeroon, raivostuneelle soittajalle ja kysymykseen, johon et voi vastata:

```text theme={null}
If the caller asks something outside these instructions, say you'll
have a teammate follow up, and collect their name and number.
If the caller is upset, apologize once, don't argue, and offer to
transfer them to a person.
```

### Anna puhelulle aina jokin seuraava askel

Jokainen agentti tarvitsee luovutuspolun — siirtonumeron, lupauksen takaisinsoitosta tai molemmat. Kehote-editori varoittaa, jos se ei löydä sellaista.

### Puhelutoiminnot ovat tavallisia kehotteen rivejä

Siirrot, näppäinvalinnat, odotus ja puhelun lopettaminen eivät tarvitse erillistä määritystä — kuvaile ne siinä kohdassa kulkua, johon ne kuuluvat:

```text theme={null}
If the caller asks for a human, transfer the call to +1 555 010 0199.
When the phone menu asks for a department, press 2.
If you reach the billing menu, wait on hold until a person answers.
Once the caller confirms there's nothing else, say goodbye and hang up.
```

### Faktat kuuluvat tietopohjaan, toiminta kehotteeseen

Älä liitä verkkosivustoasi kehotteeseen. Liitä
[tietopohja](/fi/guides/knowledge-base), niin agentti hakee siitä tietoa kesken puhelun — kehote pysyy lyhyenä, eikä käytännön päivittäminen tarkoita käsikirjoituksen muokkaamista uudelleen. Säilytä kehotteessa identiteetti, kulku ja säännöt; siirrä luettelot, usein kysytyt kysymykset ja pitkät käytäntötekstit tietopohjaan.

### Personoi puhelukohtaisesti dynaamisella määrityksellä, älä paikkamerkeillä

Kehotteissa ei ole mallimuuttujajärjestelmää — toiselta alustalta jäänyt `{{customer_name}}`
luetaan kirjaimellisena tekstinä, ja rakennustyökalu merkitsee sen ratkaisemattomaksi paikkamerkiksi. Jos haluat vaihdella kehotetta soittajakohtaisesti
(VIP-reititys, sisäänkirjautuneen käyttäjän konteksti), kirjoita se uudelleen puhelun aikana käyttämällä
[dynaamista puhelumääritystä](/fi/guides/dynamic-call-config).

### Kirjoita kielellä, jota haluat kuulla

Kehote voidaan kirjoittaa millä tahansa kielellä, ja agentti noudattaa sitä.
Kieli, jota agentti *puhuu*, määritetään erikseen — ensisijainen
kieli aloittaa puhelun, ja kaikki
[lisäkielet](/fi/guides/supported-languages) vaihtuvat
automaattisesti, kun soittaja käyttää jotakin niistä.

## Mallit

Kolme valmista kehotetta kopioitavaksi ja muokattavaksi: vaihda niihin yrityksesi
tiedot, numerot ja käytännöt.

### Vastaanottovirkailija (saapuvat puhelut)

```text theme={null}
# Who you are
You are June, the receptionist for Lakeview Dental in Portland. You are
warm, efficient, and never rushed.

# What you know
We're open Monday to Friday, 8am to 5pm, at 1420 Alder Street.
We offer cleanings, fillings, crowns, and emergency visits.
New-patient cleanings are $95. We don't do orthodontics.

# How to run the call
Greet the caller and ask how you can help.
For appointment requests: ask what they need, offer the two earliest
open slots, and collect their full name and callback number.
Repeat the number back and confirm before booking.
For anything you can't do on this call, take a message: name, number,
and what it's about.

# Rules
Keep answers to one or two sentences.
Ask one question at a time.
Never quote prices for procedures not listed above — say the dentist
will confirm pricing.

# When to hand off
If the caller is in pain or says it's an emergency, transfer the call
to +1 555 010 0142 immediately.
If the caller asks for the office manager, transfer to +1 555 010 0143.
Outside those cases, offer a callback instead of a transfer.
```

### Tilaustuki hakutyökalulla (saapuvat puhelut)

Liitä tilaushakua varten [API-yhteys](/fi/guides/api-connections) tai
[yhdistetty sovellus](/fi/guides/connect-apps) sekä palautuskäytännön sisältävä
tietopankki.

```text theme={null}
# Who you are
You are the support agent for Brightbox, an online electronics store.
Friendly, direct, and honest about what you can and can't do.

# How to run the call
Ask for the order number first. Read it back digit by digit and
confirm before looking anything up.
Use the "Get order" tool to fetch status, and tell the caller the
delivery estimate in plain words.
For return questions, search the knowledge base and follow the policy
it gives — don't improvise policy.

# Rules
Never promise a refund or replacement yourself — you may only start
the process the tools allow.
If a tool fails twice, stop retrying and offer a callback.
Ask one question at a time and keep answers short.

# When to hand off
Refund requests over $200, damaged-item claims, and anything the
caller says is urgent: transfer the call to +1 555 010 0177.
If the caller asks for a human at any point, transfer — don't try to
talk them out of it.
```

### Ajanvarausmuistutus (lähtevät puhelut)

Määritä lähtevissä puheluskripteissä myös **kuka puhuu ensin** ja
**vastaajaviestien käsittely**
[kutsun lisäasetuksissa](/fi/guides/agent-settings) —
kehote kattaa keskustelun, asetukset vastaamiseen liittyvät asiat.

```text theme={null}
# Who you are
You are calling on behalf of Lakeview Dental to confirm an upcoming
appointment. You are brief and courteous — this is their time.

# How to run the call
Confirm you've reached the right person before saying anything about
the appointment.
State the appointment day and time, and ask if it still works.
If yes: thank them and end the call.
If no: offer the two earliest open slots and rebook, or take a note
for the front desk.

# Rules
This call should take under two minutes.
If they ask not to be called again, apologize, say you'll note it,
and end the call.
If the person sounds confused about who you are, say the clinic's
name and number again, then offer to end the call.

# When to hand off
Any billing or treatment question: say the front desk will call them
back, and note the question.

# Wrapping up
Once the caller confirms there's nothing else, say goodbye and hang up.
```

<Warning>
  Lähtevään soittamiseen liittyy lakisääteisiä vaatimuksia — suostumus,
  soittoajat ja tunnistautumissäännöt vaihtelevat alueittain. Tutustu
  [lähtevän soittamisen lakeja käsittelevään oppaaseen](/fi/guides/outbound-calling-laws) ennen
  kampanjoiden käynnistämistä.
</Warning>

## Iteroi, kunnes se kestää oikeat soittajat

Mikään kehote ei ole oikein ensimmäisellä versiolla. Toimiva sykli:

1. **Puhu sille.** Napsauta rakentimessa **Puhu** ja kokeile rajoja itse — keskeytä se, poikkea käsikirjoituksesta, mumise puhelinnumero. Tämä on nopein muokkaus- ja uudelleenkokeilusykli.
2. **[Simuloi puheluita.](/fi/guides/simulate-a-call)** Tekoälysoittaja käy kokonaisia keskusteluja agenttisi kanssa skenaario kerrallaan.
3. **[Luo validointijoukko.](/fi/guides/validation-sets)** Muuta tärkeät skenaariot toistettavaksi kokonaisuudeksi, jonka ajat uudelleen jokaisen kehote muutoksen jälkeen.
4. **[Tee A/B-testausta tuotannossa.](/fi/guides/experiments-ab-testing)** Kun kaksi muotoilua vaikuttavat yhtä hyviltä, anna oikeiden puheluiden ratkaista.

Jokaisesta käyttöönotosta otetaan tilannekuva **Historia**-välilehdelle, joten voit julkaista kehote muutoksia turvallisesti usein — voit aina tarkistaa erot ja palauttaa aiemman version.

## Seuraavat vaiheet

<CardGroup cols={2}>
  <Card title="Rakenna ensimmäinen agenttisi" icon="wand-magic-sparkles" href="/fi/guides/build-an-agent">
    Rakentimen koko työnkulku: kehote, moottori, ääni, työkalut, käyttöönotto.
  </Card>

  <Card title="Tietopohjat" icon="book" href="/fi/guides/knowledge-base">
    Anna agentille haettavia faktoja pidemmän kehotteen sijaan.
  </Card>

  <Card title="Dynaaminen puhelukonfiguraatio" icon="shuffle" href="/fi/guides/dynamic-call-config">
    Kirjoita kehote uudelleen jokaiselle puhelulle omasta taustajärjestelmästäsi.
  </Card>

  <Card title="Kaikki agentin asetukset" icon="sliders" href="/fi/guides/agent-settings">
    Valvonta, kuka puhuu ensin, vastaaja, hiljaisuuden tarkistukset ja paljon muuta.
  </Card>
</CardGroup>
