---
title: "Vgrajena orodja"
description: "Glasovne agente ThunderPhone usmerite, da končajo klice, preusmerijo klicatelje, uporabljajo tipkovnice, čakajo na čakanju, iščejo po bazi znanja, predvajajo zvoke in pošiljajo e-pošto."
---

Vgrajena orodja agentu omogočajo izvajanje pogostih dejanj med klicem brez povezovanja z vašim
API-jem. Večina je samodejno na voljo; e-pošta, zvoki in iskanje po bazi znanja
se prikažejo šele, ko konfigurirate povezano nastavitev ali vir. Agentu v pozivu
povejte, kdaj naj uporabi posamezno dejanje.

| Orodje | Uporabite za | Kako ga omogočite | Podprti klici |
| --- | --- | --- | --- |
| `end_call` | Zaključitev dokončanega pogovora | Vedno na voljo | Telefon, Talk v brskalniku, gradnik, simulacija in Realtime |
| `transfer_call` | Preusmeritev telefonskega klicatelja | V pozivu konfigurirajte usmerjanje | Običajni telefonski klici; vdelani Realtime z `call_events` lahko uporablja hladen prenos. Realtime shranjenega agenta tega ne vključuje. |
| `send_keypad_input` | Pritiskanje tipk v telefonskem meniju | Vedno na voljo pri običajnih telefonskih klicih | Telefonski klici; vdelani odhodni Realtime z `call_events`. Realtime shranjenega agenta tega ne vključuje. |
| `no_response` | Nadaljevanje poslušanja, medtem ko govori avtomatizirani meni | Vedno na voljo | Vse vrste klicev |
| `wait_on_hold` | Tiho čakanje, da se oseba vrne | Vključeno pri odhodnih klicih | Odhodni telefonski klici in odhodne vdelane seje Realtime |
| `search_knowledge_base` | Odgovarjanje na podlagi priloženih virov | Agentu priložite znanje | Klici shranjenega agenta s priloženim znanjem |
| `play_sound` | Predvajanje konfiguriranega zvoka obvestila | **Napredno → Zvok orodja** | Klici shranjenega agenta |
| `send_email` | Pošiljanje e-pošte enemu določenemu prejemniku | **Napredno → Pošlji e-pošto** | Klici shranjenega agenta |

## `end_call`

Zaključi trenutni klic, ko modelu to naroči poziv. Privzeto je na voljo in nima
nastavitve agenta.

V poziv zapišite pogoj in morebitno zahtevano slovo:

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

Običajni klic, ki ga zaključi model, ima `end_reason: "ai_hangup"`. Zaključek
zaradi trajanja ali stanja dobroimetja lahko namesto tega uporabi natančnejši
razlog za zaključek.

## `transfer_call`

Telefonskega klicatelja preusmeri na določeno številko, ki jo navede model. Hladen
prenos je takojšen. Preverjeni topli prenos pred povezavo udeležencev zasebno
pokliče cilj. Topli prenos zahteva preverjeno uvoženo VoIP-številko, s katere je
mogoče opravljati odhodne klice.

V poziv vnesite ciljno številko in natančen pogoj usmerjanja:

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

Uspešen hladen prenos ima `end_reason: "ai_transfer"`; dokončan topli
prenos ima `end_reason: "ai_warm_transfer"`. Neuspešen topli poskus vrne
nadzor agentu, zato razlog za zaključek določi poznejši zaključek klica. Pri
sejah, ki niso telefonske, zahteva za prenos namesto tega zaključi sejo.

Za nastavitev na nadzorni plošči in prek API-ja, usmerjanje, preverjanje,
obravnavo napak, omejitve in testiranje glejte [Prenos klicev](/sl/guides/call-transfers).

## `send_keypad_input`

Pošlje DTMF-števke (telefonske tipkovnice) `0`–`9`, `*` in `#` telefonski liniji.
Model ga uporablja za krmarjenje po IVR-ju, avtomatiziranem meniju, ki klicatelje
prosi, naj pritisnejo tipke. Privzeto je na voljo in nima nastavitve agenta.

Modelu povejte, po katerih menijih lahko krmari in od kod izvirajo zahtevane
vrednosti. Ne zahtevajte, naj ugiba možnosti menija:

```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 odstrani nepodprte znake in veljavne števke pošlje po vrstnem redu.
Če ne ostane nobena veljavna števka ali klic ne more poslati vnosa s tipkovnice,
se napaka vrne agentu, da jo lahko odpravi.

## `no_response`

Agent ostane tiho, medtem ko avtomatizirani sistem še govori ali ga prosi, naj
nadaljuje s poslušanjem. Ni namenjeno pozdravu žive osebe, vprašanju ali
dejanski čakalni vrsti. Privzeto je na voljo in nima nastavitve agenta.

Običajno zadošča vgrajeni opis. Pri klicih z veliko IVR-ji mejo okrepite v
pozivu:

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

To dejanje ne zaključi klica.

## `wait_on_hold`

Odhodnega agenta postavi v stanje tihega čakanja, dokler se živa oseba ne vrne.
Model ga uporabi samo potem, ko druga oseba izrecno pove, da je agent postavljen
na čakanje. Samodejno je na voljo pri odhodnih klicih in nima nastavitve na
nadzorni plošči.

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

Agenta ne pozivajte, naj ga uporabi za sporočilo IVR-ja »prosimo, počakajte«.
Čakanje privzeto traja do 15 minut. Pri običajnih odhodnih klicih `POST /v1/call`
sprejme pozitivno celoštevilsko vrednost `max_hold_seconds`; v vdelanem Realtime je
`max_hold_seconds` omejen na 10–900 sekund. Če se oseba vrne,
agent nadaljuje, ne da bi spremenil razlog za zaključek klica. Če omejitev
poteče, platforma zaključi klic z `end_reason: "ai_hangup"`.

## `search_knowledge_base`

Preišče dokumente, povezane z agentom, in vrne ustrezne odlomke. Če ga želite
omogočiti, agentu priložite zbirko znanja ali posamezne dokumente znanja, nato pa
modelu povejte, kateri odgovori morajo izhajati iz teh virov:

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

Če iskanje ne uspe, se rezultat vrne agentu. Za nastavitev na nadzorni plošči in
prek API-ja glejte [Zbirka znanja](/sl/guides/knowledge-base).

## `play_sound`

Po katerem koli govoru v isti potezi predvaja konfiguriran zvok obvestila agenta.
Na nadzorni plošči nastavite **Napredno → Zvok orodja** na **Zvonček**, **Ding**
ali **Pisk**, nato pa uvedite agenta. Možnost **Brez** odstrani orodje.

Z [API-jem za agente](/api-reference/agents) nastavite `play_sound_asset` na
`"chime"`, `"ding"` ali `"beep"`, nato pa uvedite agenta. Za onemogočanje
orodja ga nastavite na `""`.

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

Napaka pri predvajanju se vrne agentu in ne zaključi klica.

## `send_email`

Pošlje e-pošto v navadnem besedilu enemu prejemniku, ki ga konfigurira lastnik
agenta. Model navede zadevo in vsebino. Nikoli ne vidi parametra prejemnika in
ne more izbrati ali spremeniti naslova.

Na nadzorni plošči omogočite **Napredno → Pošlji e-pošto**, shranite naslov
prejemnika, nato pa uvedite agenta. Z [API-jem za agente](/api-reference/agents)
nastavite `send_email_enabled: true` in neprazen `send_email_recipient`, nato pa
uvedite agenta. V pozivu določite sprožilec in zahtevano vsebino:

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

Klic lahko poskusi poslati največ tri e-poštna sporočila. Vsaka zadeva je omejena
na 300 znakov, vsebina pa na 20.000 znakov. Manjkajoča konfiguracija, neveljavna
vsebina, omejitev na klic in napake pri dostavi se vrnejo agentu.
Neuspešna dostava še vedno porabi enega od treh poskusov.

Pred široko uvedbo preizkusite z nadzorovanim prejemnikom. Talk v brskalniku in
simulacije pošiljajo pravo e-pošto; način suhega zagona ne obstaja.

## Opomba o združljivosti

Nastavitev **Napredno → Neprerušljiva razkritja** in starejše polje
`speak_uninterruptible_enabled` ostajata zaradi združljivosti, vendar njuna
omogočitev nima učinka. Nastavitev pustite izklopljeno; noben poziv ne more
aktivirati tega orodja.

Za obvezno razkritje ob začetku klica uporabite **Obvestilo o soglasju**.
Predvaja se dobesedno pred običajnim pogovorom in ga ni mogoče prekiniti. Glejte
[Zakoni o soglasju za snemanje klicev](/sl/guides/recording-consent-laws).

## Preizkusite in spremljajte vgrajena orodja

Za preverjanje pozivov, iskanja znanja, zvokov in e-pošte uporabite Talk v
brskalniku ali simulacijo. Ta okolja ne morejo poustvariti vedenja telefonskega
omrežja. Krmarjenje s tipkovnico in čakanje preizkusite pri odhodnem telefonskem
klicu, celoten topel prenos pa pri resničnem klicu z upravičeno uvoženo številko
VoIP. Podpora za Realtime je omejena, kot prikazuje zgornja tabela.

## Klici, cene in spletne kljuke

Vgrajena dejanja nimajo pristojbine za posamezno uporabo orodja. Običajne
pristojbine za klice in ponudnika še vedno veljajo; glejte [Cene](/sl/guides/pricing). Njihovi klici in rezultati se lahko prikažejo
v zaključenem prepisu, vendar ne ustvarijo dogodkov `telephony.tool` ali `web.tool`.
Ti dogodki so namenjeni [funkcijam, ki jih določite](/sl/tools/overview). Samo uspešno dokončana
prekinitev klica ali preusmeritev spremeni `end_reason` klica; druge napake se vrnejo
agentu. Za zapis klica glejte [Spletne kljuke ob zaključku](/sl/webhooks/call-complete).