Open in
Ugrađeni alati
Uputite ThunderPhone agente da završe pozive, preusmjere pozivatelje, upravljaju tipkovnicama, čekaju na čekanju, pretražuju znanje, reproduciraju zvukove, šalju e-poštu i izračunavaju ukupne iznose.
Ugrađeni alati omogućuju agentu izvršavanje uobičajenih radnji u pozivu bez povezivanja vlastitog API-ja. Većina je automatski dostupna; e-pošta, zvukovi, kalkulator i pretraživanje znanja prikazuju se tek nakon što konfigurirate povezanu postavku ili izvor. U promptu recite agentu kada treba upotrijebiti svaku radnju.
| Alat | Upotrijebite za | Kako ga omogućiti | Podržani pozivi |
|---|---|---|---|
end_call | Završavanje dovršenog razgovora | Uključeno prema zadanim postavkama; system_tool_settings može ga isključiti | Telefonski pozivi, Talk u pregledniku, widget, simulacija i Realtime |
transfer_call | Preusmjeravanje telefonskog pozivatelja | Konfigurirajte usmjeravanje u promptu | Uobičajeni telefonski pozivi; ugrađeni Realtime s call_events može upotrebljavati slijepi prijenos. Realtime spremljenog agenta ga ne uključuje. |
send_keypad_input | Pritisak tipki u telefonskom izborniku | Uključeno prema zadanim postavkama za odlazne pozive; system_tool_settings može ga uključiti ili isključiti | Telefonski pozivi; ugrađeni odlazni Realtime s call_events. Realtime spremljenog agenta ga ne uključuje. |
no_response | Nastavak slušanja dok automatizirani izbornik govori ili pozivatelj razmišlja naglas; pozivatelj koji od agenta zatraži da pričeka dobiva samo „Naravno.” | Uvijek dostupno | Sve vrste poziva |
wait_on_hold | Tiho čekanje da se osoba vrati | Uključeno prema zadanim postavkama za odlazne pozive; system_tool_settings može ga uključiti ili isključiti | Telefonski pozivi i ugrađene odlazne 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 |
calculate | Točno zbrajanje ukupnih iznosa, naknada i kusura | Napredno → Kalkulator | Pozivi spremljenog agenta |
end_call
Završava trenutačni poziv kada uputa modelu kaže da to učini. Zadano je uključen. Glasovni agent koji nikada ne bi trebao sam prekinuti poziv, poput tumača koji posreduje između dviju osoba koje same završavaju poziv, može ga isključiti pomoću polja system_tool_settings glasovnog agenta ({"end_call": false}). Poziv se tada završava kada osoba prekine vezu ili zbog ograničenja tišine i vremena.
U uputu unesite uvjet i potrebno oproštajno obraćanje:
When the caller confirms they need nothing else, say goodbye and end the call.Poziv koji završi model ima end_reason: "ai_hangup", uključujući i onaj koji završi
nakon upozorenja o vremenskom ograničenju poziva. Poziv završava s max_duration samo ako se
vremensko ograničenje prvo dosegne, s balance_exhausted kada se potroši unaprijed plaćeni
saldo te s price_cap_reached kada poziv dosegne čvrsto ograničenje cijene agenta
(agent se najprije kratko pozdravi).
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:
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 za postavljanje nadzorne ploče i API-ja, usmjeravanje, provjeru, rukovanje neuspjesima, ograničenja i testiranje.
send_keypad_input
Šalje DTMF znamenke (telefonska tipkovnica) 0–9, * i # na telefonsku liniju. Model ih upotrebljava za navigaciju IVR-om, automatiziranim izbornikom koji pozivatelje traži da pritisnu tipke. Prema zadanim je postavkama uključeno za odlazne pozive, a isključeno za dolazne pozive; postavite "send_keypad_input": true ili false u system_tool_settings agenta kako biste to promijenili za svaki poziv.
Recite modelu kroz koje se izbornike smije kretati i odakle dolaze tražene vrijednosti. Nemojte tražiti od njega da pogađa opcije izbornika:
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
Glasovni agent ostaje tih dok automatizirani sustav još govori ili od njega traži da nastavi slušati te dok pozivatelj razmišlja naglas („hm, da vidim”) ili se okrene kako bi razgovarao s nekim drugim. Kada pozivatelj zatraži od agenta da pričeka dok nešto obavlja („samo trenutak”, „da provjerim”, „možete li pričekati sekundu?”) i ne kaže ništa drugo na što bi trebalo odgovoriti, agent kaže samo „Naravno.” (ne „Uzmite si vremena”) i čeka da pozivatelj ponovno progovori. Povremena javljanja agenta tijekom tišine i dalje se izvršavaju i uvijek se izgovaraju ako veza ostane tiha. Nije namijenjeno pozdravu stvarne osobe, pitanju ni stvarnom redu čekanja na vezi. Dostupno je prema zadanim postavkama i nema zasebnu postavku agenta.
Ako vaš prompt određuje što agent treba reći kada pozivatelj zatraži trenutak, prompt ima prednost.
Uobičajeno je dovoljan ugrađeni opis. Za pozive s mnogo IVR-a, dodatno naglasite granicu u uputi:
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 odlaznog agenta u stanje tihog čekanja dok se živa osoba ne vrati.
Model ga koristi samo nakon što druga strana izričito kaže da je agent stavljen na čekanje. Prema zadanim postavkama uključen je za odlazne pozive; postavite "wait_on_hold" u system_tool_settings agenta kako biste ga uključili ili isključili za svaki poziv.
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:
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 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, pripremite play_sound_asset kao
"chime", "ding" ili "beep", a zatim objavite. Postavite ga na "" da biste onemogućili
alat.
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, pripremite
i send_email_enabled: true i neprazan send_email_recipient, a zatim objavite.
U promptu definirajte okidač i obavezni sadržaj:
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.
calculate
Točno izračunava aritmetički izraz i vraća rezultat, tako da agent ne zbraja cijene napamet. Prema zadanim je postavkama isključen. Na nadzornoj ploči omogućite Napredno → Kalkulator, a zatim implementirajte agenta. Pomoću API-ja za agente postavite calculator_enabled: true, a zatim implementirajte.
Model zapisuje izraz, kao što je 2*23.5 + 16.5 + 4, i čita rezultat pozivatelju. Izrazi mogu koristiti brojeve, +, -, *, / i zagrade. Jedan poziv može sadržavati do 10 izraza odvojenih znakom ;, kao što su međuzbroj i ukupan iznos s naknadom za dostavu, ukupno do 500 znakova. Rezultati se zaokružuju na 10 decimalnih mjesta. Matematički izračun koristi točnu decimalnu aritmetiku, pa
0.1 + 0.2 vraća 0.3. Dijeljenje s nulom i sve ostalo neispravno u izrazu vraća se agentu kao pogreška koju treba ispraviti. Izvršava se na ThunderPhoneu i odgovara trenutačno, bez umetnute rečenice ili zvuka tipkanja.
Uključite ga za agente koji navode ukupne iznose narudžbi, naknade ili ostatak za povrat. Nije potrebna izmjena uputa.
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.
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. 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. 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.