---
title: "Iebūvētie rīki"
description: "Norādiet ThunderPhone balss aģentiem beigt zvanus, pārsūtīt zvanītājus, pārvietoties pa taustiņiem, gaidīt aizturēšanas režīmā, meklēt zināšanās, atskaņot skaņas, sūtīt e-pastus un aprēķināt kopsummas."
---

Iebūvētie rīki ļauj balss aģentam veikt bieži sastopamas zvanu darbības, nepievienojot savu API. Lielākā daļa ir pieejama automātiski; e-pasts, skaņas, kalkulators un zināšanu meklēšana parādās tikai pēc attiecīgā iestatījuma vai avota konfigurēšanas. Norādiet balss aģentam tā uzvednē, kad izmantot katru darbību.

| Rīks | Izmantojiet to, lai | Kā to iespējot | Atbalstītie zvani |
| --- | --- | --- | --- |
| `end_call` | Pabeigt noslēgtu sarunu | Vienmēr pieejams | Tālrunis, pārlūkprogrammas Talk, logrīks, simulācija un Realtime |
| `transfer_call` | Pāradresēt tālruņa zvanītāju | Konfigurējiet maršrutēšanu uzvednē | Parasti tālruņa zvani; iekļautais Realtime ar `call_events` var izmantot auksto pārsūtīšanu. Saglabātā aģenta Realtime to neietver. |
| `send_keypad_input` | Nospiest taustiņus tālruņa izvēlnē | Vienmēr pieejams parastajos tālruņa zvanos | Tālruņa zvani; iekļautais izejošais Realtime ar `call_events`. Saglabātā aģenta Realtime to neietver. |
| `no_response` | Turpināt klausīties, kamēr runā automatizēta izvēlne vai zvanītājs domā skaļi; zvanītājs, kurš lūdz aģentam pagaidīt, saņem tikai “Protams.” | Vienmēr pieejams | Visu veidu zvani |
| `wait_on_hold` | Klusi gaidīt, līdz persona atgriežas | Iekļauts izejošajos zvanos | Izejošie tālruņa zvani un izejošās iekļautās Realtime sesijas |
| `search_knowledge_base` | Atbildēt, izmantojot pievienotos avotus | Pievienojiet balss aģentam zināšanas | Saglabātā aģenta zvani ar pievienotām zināšanām |
| `play_sound` | Atskaņot konfigurētu paziņojuma skaņu | **Papildu → Rīka skaņa** | Saglabātā aģenta zvani |
| `send_email` | Nosūtīt e-pastu vienam fiksētam adresātam | **Papildu → Sūtīt e-pastu** | Saglabātā aģenta zvani |
| `calculate` | Precīzi saskaitīt summas, maksas un atlikumu | **Papildu → Kalkulators** | Saglabātā aģenta zvani |

## `end_call`

Pārtrauc pašreizējo zvanu, kad uzvedne liek modelim to darīt. Tas ir pieejams
pēc noklusējuma, un tam nav balss aģenta iestatījuma.

Uzvednē ierakstiet nosacījumu un nepieciešamo atvadu frāzi:

```text
When the caller confirms they need nothing else, say goodbye and end the call.
```

Modeļa pabeigtam zvanam ir `end_reason: "ai_hangup"`, tostarp zvanam, kas beidzas
pēc zvana laika limita brīdinājuma. Zvans beidzas ar `max_duration` tikai tad, ja
vispirms tiek sasniegts laika limits, un ar `balance_exhausted`, kad beidzas
priekšapmaksas atlikums.

## `transfer_call`

Pārsūta tālruņa zvanītāju uz modeļa norādītu fiksētu numuru. Aukstā pārsūtīšana
notiek nekavējoties. Pārbaudīta siltā pārsūtīšana pirms pušu savienošanas privāti
piezvana uz galamērķi. Siltajai pārsūtīšanai nepieciešams verificēts importēts
VoIP numurs, no kura var veikt izejošos zvanus.

Uzvednē norādiet galamērķa numuru un precīzu maršrutēšanas nosacījumu:

```text
If the caller asks for billing, transfer them to +15551234567.
```

Sekmīgai aukstajai pārsūtīšanai ir `end_reason: "ai_transfer"`; pabeigtai siltajai
nodošanai ir `end_reason: "ai_warm_transfer"`. Neizdevies siltais mēģinājums
atdod vadību balss aģentam, tāpēc zvana vēlākā pabeigšana nosaka tā beigu iemeslu. Sesijās,
kas nav tālruņa sesijas, pārsūtīšanas pieprasījums tā vietā beidz sesiju.

Informāciju par informācijas paneļa un API iestatīšanu, maršrutēšanu, pārbaudi,
kļūdu apstrādi, ierobežojumiem un testēšanu skatiet sadaļā [Zvanu pārsūtīšana](/lv/guides/call-transfers).

## `send_keypad_input`

Sūta DTMF (tālruņa tastatūras) ciparus `0`–`9`, `*` un `#` uz tālruņa līniju.
Modelis to izmanto, lai pārvietotos IVR — automatizētajā izvēlnē, kas zvanītājiem
lūdz nospiest taustiņus. Tas ir pieejams pēc noklusējuma, un tam nav balss aģenta iestatījuma.

Norādiet modelim, kurās izvēlnēs tas drīkst pārvietoties un no kurienes iegūt
pieprasītās vērtības. Nelieciet tam minēt izvēļņu opcijas:

```text
Follow the phone menu for account status. Press a key only after the menu
states what that key does. Enter the account number supplied by the caller.
```

Platforma noņem neatbalstītās rakstzīmes un nosūta derīgos ciparus secīgi.
Ja nepaliek derīgu ciparu vai zvans nevar nosūtīt tastatūras ievadi, kļūda tiek
atgriezta balss aģentam, lai tas varētu atgūties.

## `no_response`

Saglabā balss aģentu klusu, kamēr automatizēta sistēma vēl runā vai lūdz turpināt klausīties, kā arī kamēr zvanītājs domā skaļi ("hmm, ļaujiet paskatīties") vai pagriežas, lai parunātu ar kādu citu. Ja zvanītājs lūdz balss aģentam pagaidīt, kamēr viņš kaut ko dara ("vienu brīdi", "ļaujiet pārbaudīt", "vai varat uz brīdi uzgaidīt?"), un nesniedz neko citu, uz ko atbildēt, balss aģents saka tikai "Protams." (nevis "Nesteidzieties") un gaida, līdz zvanītājs atkal runās. Balss aģenta klusuma pārbaudes joprojām darbojas un vienmēr tiek izrunātas, ja līnija paliek klusa. Tas nav paredzēts dzīva cilvēka sasveicināšanās, jautājuma vai īstas gaidīšanas rindas gadījumam. Tas ir pieejams pēc noklusējuma, un tam nav balss aģenta iestatījuma.

Ja jūsu uzvednē balss aģentam ir norādīts, ko teikt, kad zvanītājs lūdz brīdi pagaidīt, noteicošā ir uzvedne.

Parasti pietiek ar iebūvēto aprakstu. Zvaniem ar biežu IVR izmantošanu
nostipriniet robežu uzvednē:

```text
Stay silent while a phone menu is still speaking. Answer a live person as soon
as they address you.
```

Šī darbība nebeidz zvanu.

## `wait_on_hold`

Pārslēdz izejošo balss aģentu klusā gaidīšanas režīmā, līdz atgriežas reāla persona.
Modelis to izmanto tikai tad, kad otra puse skaidri pasaka, ka balss aģents tiek
pārslēgts gaidīšanas režīmā. Tas ir automātiski pieejams izejošajos zvanos, un tam nav
iestatījuma vadības panelī.

```text
If a person explicitly puts you on hold, wait silently. When they return,
continue from the question you were discussing.
```

Nenorādiet balss aģentam to izmantot IVR ziņojumam “lūdzu, uzgaidiet”. Gaidīšana pēc
noklusējuma ilgst līdz 15 minūtēm. Parastiem izejošajiem zvaniem `POST /v1/call`
pieņem pozitīva vesela skaitļa `max_hold_seconds`; iekļautais Realtime ierobežo
`max_hold_seconds` līdz 10–900 sekundēm. Ja persona
atgriežas, balss aģents atsāk sarunu, nemainot zvana beigu iemeslu. Ja limits
beidzas, platforma pārtrauc zvanu ar `end_reason: "ai_hangup"`.

## `search_knowledge_base`

Meklē balss aģentam pievienotos dokumentus un atgriež atbilstošus fragmentus. Lai to
iespējotu, pievienojiet zināšanu bāzi vai atsevišķus zināšanu bāzes dokumentus, pēc tam
norādiet modelim, kurām atbildēm jābalstās šajos avotos:

```text
Search the knowledge base before answering policy questions. If the first
search is inconclusive, try once more with different key terms.
```

Ja meklēšana neizdodas, rezultāts tiek atgriezts balss aģentam. Informāciju par
vadības paneļa un API iestatīšanu skatiet sadaļā [Zināšanu
bāze](/lv/guides/knowledge-base).

## `play_sound`

Atskaņo balss aģenta konfigurēto paziņojuma skaņu pēc jebkuras runas tajā pašā
dialoga gājienā. Vadības panelī iestatiet **Papildu → Rīka skaņa** uz **Chime**, **Ding**
vai **Beep**, pēc tam izvietojiet balss aģentu. **Nav** noņem rīku.

Izmantojot [Agents API](/api-reference/agents), sagatavošanas konfigurācijā iestatiet
`play_sound_asset` uz `"chime"`, `"ding"` vai `"beep"`, pēc tam izvietojiet
balss aģentu. Lai atspējotu rīku, iestatiet to uz `""`.

```text
After confirming that an appointment was saved, say "You're all set" and play
the notification sound.
```

Atskaņošanas kļūme tiek atgriezta balss aģentam un nepārtrauc zvanu.

## `send_email`

Nosūta vienkārša teksta e-pastu vienam saņēmējam, ko konfigurējis balss aģenta
īpašnieks. Modelis nodrošina tematu un pamattekstu. Tas nekad neredz saņēmēja parametru
un nevar izvēlēties vai mainīt adresi.

Vadības panelī iespējojiet **Papildu → Sūtīt e-pastu**, saglabājiet saņēmēja adresi,
pēc tam izvietojiet balss aģentu. Izmantojot [Agents API](/api-reference/agents),
sagatavošanas konfigurācijā iestatiet gan `send_email_enabled: true`, gan netukšu
`send_email_recipient`, pēc tam izvietojiet balss aģentu.
Uzvednē definējiet aktivizētāju un nepieciešamo saturu:

```text
When the caller asks to leave a message, collect their name, callback number,
and message. Read the details back for confirmation, then email them.
```

Vienā zvanā var mēģināt nosūtīt ne vairāk kā trīs e-pastus. Katra temata garums ir
ierobežots līdz 300 rakstzīmēm, bet katra pamatteksta garums — līdz 20 000 rakstzīmēm.
Trūkstoša konfigurācija, nederīgs saturs, viena zvana limits un piegādes kļūmes tiek
atgrieztas balss aģentam. Neveiksmīga piegāde joprojām izmanto vienu no trim mēģinājumiem.

Pirms plašas izvietošanas testējiet ar kontrolētu saņēmēju. Talk pārlūkprogrammā un
simulācijas sūta īstus e-pastus; izmēģinājuma režīms nav pieejams.

## `calculate`

Precīzi aprēķina aritmētisku izteiksmi un atgriež rezultātu, lai balss aģentam nebūtu galvā jāsaskaita cenas. Pēc noklusējuma tas ir izslēgts. Informācijas panelī iespējojiet **Papildu → Kalkulators**, pēc tam izvietojiet aģentu. Izmantojot [Agents
API](/api-reference/agents), sagatavojiet `calculator_enabled: true`, pēc tam izvietojiet.

Modelis uzraksta izteiksmi, piemēram, `2*23.5 + 16.5 + 4`, un nolasa
rezultātu zvanītājam. Izteiksmēs var izmantot skaitļus, `+`, `-`, `*`, `/` un
iekavas. Vienā izsaukumā var būt līdz 10 izteiksmēm, kas atdalītas ar `;`, piemēram,
starpsumma un kopsumma ar piegādes maksu, kopā līdz 500 rakstzīmēm.
Rezultāti tiek noapaļoti līdz 10 zīmēm aiz komata. Matemātika izmanto precīzu decimālo aritmētiku, tāpēc
`0.1 + 0.2` atgriež `0.3`. Dalīšana ar nulli un jebkas cits izteiksmē
tiek atgriezts balss aģentam kā kļūda, kas jāizlabo. Tas darbojas ThunderPhone un
atbild uzreiz, bez aizpildfrāzes vai rakstīšanas skaņas.

Ieslēdziet to balss aģentiem, kas nosauc pasūtījumu kopsummas, maksas vai atlikumu. Uzvedne
nav jāmaina.

## Savietojamības piezīme

Iestatījums **Papildu → Nepārtraucami paziņojumi** un mantotais lauks
`speak_uninterruptible_enabled` ir saglabāti savietojamībai, taču to iespējošanai
nav ietekmes. Atstājiet iestatījumu izslēgtu; neviena uzvedne nevar aktivizēt šo rīku.

Obligātam paziņojumam zvana sākumā izmantojiet **Piekrišanas paziņojums**. Tas tiek
atskaņots burtiski pirms parastas sarunas un to nevar pārtraukt. Skatiet [Zvanu
ierakstīšanas piekrišanas likumi](/lv/guides/recording-consent-laws).

## Iebūvēto rīku testēšana un uzraudzība

Izmantojiet Talk pārlūkprogrammā vai simulāciju, lai pārbaudītu uzvednes, zināšanu
meklēšanu, skaņas un e-pastu. Šajās vidēs nevar atdarināt telefona tīkla darbību.
Pārbaudiet taustiņu izvēlnes navigāciju un gaidīšanu izejošā telefona zvanā, kā arī
pārbaudiet pilnīgu silto pāradresāciju reālā zvanā, izmantojot atbilstošu importētu VoIP
numuru. Realtime atbalsts ir ierobežots, kā parādīts iepriekš esošajā tabulā.

## Zvani, cenas un tīmekļa aizķeres

Iebūvētajām darbībām nav maksas par katru rīka izmantošanu. Joprojām tiek piemērotas parastās zvanu un pakalpojumu sniedzēja maksas; skatiet sadaļu [Cenas](/lv/guides/pricing). To zvani un rezultāti var tikt parādīti pabeigtajā transkriptā, taču tie neizvada `telephony.tool` vai `web.tool`.
Šie notikumi ir paredzēti [lietotāja definētām funkcijām](/lv/tools/overview). Tikai pabeigta nolikšana vai pārsūtīšana maina zvana `end_reason`; citas kļūmes tiek atgrieztas balss aģentam. Zvana ierakstu skatiet sadaļā [Pabeigšanas tīmekļa aizķeres](/lv/webhooks/call-complete).