---
title: "Ugrađeni alati"
description: "Uputite agente ThunderPhonea da završavaju pozive, preusmjeravaju pozivatelje, upravljaju tipkovnicama, čekaju na liniji, pretražuju znanje, reproduciraju zvukove i šalju e-poštu."
---

Ugrađeni alati omogućuju agentu izvođenje uobičajenih radnji u pozivu bez povezivanja vlastitog API-ja. Većina je dostupna automatski; e-pošta, zvukovi i pretraživanje znanja pojavljuju se tek nakon što konfigurirate povezanu postavku ili izvor. U uputi agentu navedite kada treba koristiti svaku radnju.

| Alat | Koristite za | Kako ga omogućiti | Podržani pozivi |
| --- | --- | --- | --- |
| `end_call` | Završavanje dovršenog razgovora | Uvijek dostupno | Telefonski pozivi, Talk u pregledniku, widget, simulacija i Realtime |
| `transfer_call` | Preusmjeravanje telefonskog pozivatelja | Konfigurirajte usmjeravanje u uputi | Uobičajeni telefonski pozivi; ugrađeni Realtime s `call_events` može koristiti hladni prijenos. Realtime spremljenog agenta to ne uključuje. |
| `send_keypad_input` | Pritisak tipki u telefonskom izborniku | Uvijek dostupno za uobičajene telefonske pozive | Telefonski pozivi; ugrađeni odlazni Realtime s `call_events`. Realtime spremljenog agenta to ne uključuje. |
| `no_response` | Nastavak slušanja dok automatizirani izbornik govori | Uvijek dostupno | Sve vrste poziva |
| `wait_on_hold` | Tiho čekanje da se osoba vrati | Uključeno u odlazne pozive | Odlazni telefonski pozivi i odlazne ugrađene Realtime sesije |
| `search_knowledge_base` | Odgovaranje na temelju priloženih izvora | Priložite znanje agentu | Pozivi spremljenog agenta s priloženim znanjem |
| `play_sound` | Reprodukcija konfiguriranog zvuka obavijesti | **Napredno → Zvuk alata** | Pozivi spremljenog agenta |
| `send_email` | Slanje e-pošte jednom fiksnom primatelju | **Napredno → Pošalji e-poštu** | Pozivi spremljenog agenta |

## `end_call`

Završava trenutačni poziv kada uputa modelu to nalaže. Dostupan je prema zadanim postavkama i nema postavku agenta.

U uputu unesite uvjet i potrebno oproštajno obraćanje:

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

Uobičajeni poziv koji završi model ima `end_reason: "ai_hangup"`. Prekid zbog trajanja ili stanja računa umjesto toga može koristiti specifičniji razlog završetka.

## `transfer_call`

Preusmjerava telefonskog pozivatelja na fiksni broj koji navede model. Hladni prijenos je trenutačan. Topli prijenos s provjerom privatno poziva odredište prije povezivanja strana. Topli prijenos zahtijeva potvrđeni uvezeni VoIP broj koji može upućivati odlazne pozive.

U uputu unesite odredišni broj i točan uvjet usmjeravanja:

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

Uspješan hladni prijenos ima `end_reason: "ai_transfer"`; dovršena topla primopredaja ima `end_reason: "ai_warm_transfer"`. Neuspjeli topli pokušaj vraća kontrolu agentu, pa kasniji završetak poziva određuje njegov razlog završetka. U sesijama koje nisu telefonske zahtjev za prijenos umjesto toga završava sesiju.

Pogledajte [Prijenos poziva](/hr/guides/call-transfers) za postavljanje nadzorne ploče i API-ja, usmjeravanje, provjeru, rukovanje neuspjesima, ograničenja i testiranje.

## `send_keypad_input`

Šalje DTMF znamenke telefonske tipkovnice `0`–`9`, `*` i `#` telefonskoj liniji. Model ga koristi za kretanje kroz IVR, automatizirani izbornik koji od pozivatelja traži da pritisnu tipke. Dostupan je prema zadanim postavkama i nema postavku agenta.

Recite modelu kroz koje se izbornike smije kretati i odakle dolaze tražene vrijednosti. Nemojte tražiti od njega da pogađa opcije izbornika:

```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 uklanja nepodržane znakove i šalje valjane znamenke redom. Ako ne preostanu valjane znamenke ili poziv ne može slati unos tipkovnice, neuspjeh se vraća agentu kako bi se mogao oporaviti.

## `no_response`

Zadržava agenta tihim dok automatizirani sustav još govori ili traži da nastavi slušati. Nije namijenjen pozdravu žive osobe, pitanju ili stvarnom redu čekanja. Dostupan je prema zadanim postavkama i nema postavku agenta.

Uobičajeno je dovoljan ugrađeni opis. Za pozive s mnogo IVR-a, dodatno naglasite granicu u uputi:

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

Ova radnja ne završava poziv.

## `wait_on_hold`

Postavlja agenta za odlazne pozive u stanje tihog čekanja dok se stvarna osoba ne vrati.
Model ga koristi samo nakon što druga strana izričito kaže da agenta stavlja
na čekanje. Automatski je dostupan za odlazne pozive i nema postavku na
nadzornoj ploči.

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

Nemojte agentu zadavati da ga koristi za IVR poruku „molimo pričekajte”. Čekanje
prema zadanim postavkama traje do 15 minuta. Za standardne odlazne pozive, `POST /v1/call`
prihvaća pozitivni cijeli broj `max_hold_seconds`; ugrađeni Realtime ograničava
`max_hold_seconds` na 10–900 sekundi. Ako se osoba
vrati, agent nastavlja bez promjene razloga završetka poziva. Ako ograničenje
istekne, platforma završava poziv s `end_reason: "ai_hangup"`.

## `search_knowledge_base`

Pretražuje dokumente priložene agentu i vraća relevantne odlomke. Priložite
bazu znanja ili pojedinačne dokumente znanja da biste je omogućili, a zatim
recite modelu koji odgovori moraju potjecati iz tih izvora:

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

Ako pretraživanje ne uspije, rezultat se vraća agentu. Pogledajte [Baza
znanja](/hr/guides/knowledge-base) za postavljanje na nadzornoj ploči i putem API-ja.

## `play_sound`

Reproducira agentov konfigurirani zvuk obavijesti nakon bilo kojeg govora u istom
potezu. Na nadzornoj ploči postavite **Napredno → Zvuk alata** na **Zvonce**, **Ding**
ili **Bip**, a zatim objavite agenta. **Nijedno** uklanja alat.

S [API-jem za agente](/api-reference/agents), pripremite `play_sound_asset` kao
`"chime"`, `"ding"` ili `"beep"`, a zatim objavite. Postavite ga na `""` da biste onemogućili
alat.

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

Neuspjeh reprodukcije vraća se agentu i ne završava poziv.

## `send_email`

Šalje e-poruku u obliku običnog teksta jednom primatelju kojeg je konfigurirao
vlasnik agenta. Model navodi predmet i tijelo poruke. Nikada ne vidi parametar
primatelja te ne može odabrati ni promijeniti adresu.

Na nadzornoj ploči omogućite **Napredno → Pošalji e-poruku**, spremite adresu
primatelja, a zatim objavite agenta. S [API-jem za agente](/api-reference/agents), pripremite
i `send_email_enabled: true` i neprazan `send_email_recipient`, a zatim objavite.
U promptu definirajte okidač i obavezni sadržaj:

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

Poziv može pokušati poslati najviše tri e-poruke. Svaki je predmet ograničen na 300
znakova, a svako tijelo poruke na 20.000 znakova. Nedostajuća konfiguracija, nevaljan
sadržaj, ograničenje po pozivu i neuspjesi dostave vraćaju se agentu.
Neuspješna dostava i dalje troši jedan od tri pokušaja.

Testirajte s kontroliranim primateljem prije široke objave. Talk u pregledniku i
simulacije šalju stvarnu e-poštu; ne postoji način rada za probno pokretanje.

## Napomena o kompatibilnosti

Postavka **Napredno → Obavijesti koje se ne mogu prekinuti** i naslijeđeno
polje `speak_uninterruptible_enabled` ostaju radi kompatibilnosti, ali njihovo
omogućavanje nema učinka. Ostavite postavku isključenom; nijedan prompt ne može aktivirati ovaj alat.

Za obaveznu obavijest na početku poziva upotrijebite **Obavijest o pristanku**. Ona se
reproducira doslovno prije uobičajenog razgovora i ne može se prekinuti. Pogledajte [Zakoni o pristanku za snimanje
poziva](/hr/guides/recording-consent-laws).

## Testirajte i pratite ugrađene alate

Upotrijebite Talk u pregledniku ili simulaciju za provjeru promptova, pretraživanja znanja, zvukova
i e-pošte. Ta okruženja ne mogu reproducirati ponašanje telefonske mreže. Testirajte
navigaciju tipkovnicom i čekanje u odlaznom telefonskom pozivu te testirajte cjelovit topli
prijenos u stvarnom pozivu pomoću odgovarajućeg uvezenog VoIP broja. Podrška za Realtime
ograničena je kao što je prikazano u gornjoj tablici.

## Pozivi, cijene i webhookovi

Ugrađene radnje nemaju naknadu po upotrebi alata. I dalje se primjenjuju uobičajeni troškovi poziva i pružatelja usluga; pogledajte [Cijene](/hr/guides/pricing). Njihovi pozivi i rezultati mogu se prikazati u dovršenom transkriptu, ali ne šalju `telephony.tool` ni `web.tool`.
Ti su događaji namijenjeni [funkcijama koje definira korisnik](/hr/tools/overview). Samo dovršeni prekid poziva ili prijenos mijenja `end_reason` poziva; ostali se neuspjesi vraćaju agentu. Zapis poziva potražite u odjeljku [Webhookovi dovršetka](/hr/webhooks/call-complete).