--- title: "Sisseehitatud tööriistad" description: "Juhenda ThunderPhone'i agente kõnesid lõpetama, helistajaid edasi suunama, klahvistikus navigeerima, ootel püsima, teadmisi otsima, helisid esitama ja e-kirju saatma." --- Sisseehitatud tööriistad võimaldavad häälagendil teha tavapäraseid kõnetoiminguid ilma sinu API-t ühendamata. Enamik neist on automaatselt saadaval; e-post, helid ja teadmiste otsing kuvatakse alles pärast seotud sätte või allika seadistamist. Määra häälagendi juhises, millal iga toimingut kasutada. | Tööriist | Kasuta selleks | Kuidas lubada | Toetatud kõned | | --- | --- | --- | --- | | `end_call` | Lõpetatud vestluse lõpetamine | Alati saadaval | Telefon, brauseri Talk, vidin, simulatsioon ja Realtime | | `transfer_call` | Telefonikõne suunamine | Seadista suunamine juhises | Tavalised telefonikõned; reasisene Realtime koos `call_events`-iga saab kasutada külma ümbersuunamist. Salvestatud agendi Realtime seda ei sisalda. | | `send_keypad_input` | Telefonimenüüs klahvide vajutamine | Tavalistel telefonikõnedel alati saadaval | Telefonikõned; reasisene väljaminev Realtime koos `call_events`-iga. Salvestatud agendi Realtime seda ei sisalda. | | `no_response` | Kuulamise jätkamine automaatmenüü rääkimise ajal | Alati saadaval | Kõik kõnetüübid | | `wait_on_hold` | Vaikselt ootamine, kuni inimene naaseb | Sisaldub väljaminevatel kõnedel | Väljaminevad telefonikõned ja väljaminevad reasisese Realtime'i seansid | | `search_knowledge_base` | Lisatud allikatele tuginevalt vastamine | Lisa häälagendile teadmised | Salvestatud agendi kõned lisatud teadmistega | | `play_sound` | Seadistatud teavitusheli esitamine | **Täpsemalt → Tööriista heli** | Salvestatud agendi kõned | | `send_email` | E-kirja saatmine ühele kindlale adressaadile | **Täpsemalt → Saada e-kiri** | Salvestatud agendi kõned | ## `end_call` Lõpetab käimasoleva kõne, kui juhis käsib mudelil seda teha. See on vaikimisi saadaval ja sellel puudub häälagendi säte. Kirjuta juhisesse tingimus ja vajalik hüvastijätt: ```text When the caller confirms they need nothing else, say goodbye and end the call. ``` Tavalisel mudeli lõpetatud kõnel on `end_reason: "ai_hangup"`. Kestuse või saldo tõttu lõpetamisel võidakse selle asemel kasutada täpsemat lõpetamise põhjust. ## `transfer_call` Suunab telefonikõne mudeli antud kindlale numbrile. Külm ümbersuunamine toimub kohe. Kontrollitud soe ümbersuunamine helistab enne osapoolte ühendamist privaatselt sihtkohta. Soe ümbersuunamine nõuab kinnitatud imporditud VoIP-numbrit, millega saab teha väljaminevaid kõnesid. Lisa juhisesse sihtnumber ja täpne suunamise tingimus: ```text If the caller asks for billing, transfer them to +15551234567. ``` Õnnestunud külmal ümbersuunamisel on `end_reason: "ai_transfer"`; lõpetatud soojal üleandmisel on `end_reason: "ai_warm_transfer"`. Ebaõnnestunud soe katse annab juhtimise tagasi häälagendile, seega määrab kõne hilisem lõpetamine selle lõpetamise põhjuse. Mitte-telefoniseanssidel lõpetab ümbersuunamistaotlus seansi. Vaata [Kõnede ümbersuunamine](/et/guides/call-transfers), et saada teavet juhtpaneeli ja API seadistamise, suunamise, kontrollimise, tõrgete käsitlemise, piirangute ja testimise kohta. ## `send_keypad_input` Saadab telefoniliinile DTMF-i (telefoniklahvistiku) numbrid `0`–`9`, `*` ja `#`. Mudel kasutab seda IVR-is navigeerimiseks ehk automaatmenüüs, mis palub helistajatel klahve vajutada. See on vaikimisi saadaval ja sellel puudub häälagendi säte. Ütle mudelile, millistes menüüdes ta võib navigeerida ja kust küsitud väärtused pärinevad. Ära palu tal menüüvalikuid oletada: ```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. ``` Platvorm eemaldab toetamata märgid ja saadab sobivad numbrid järjekorras. Kui sobivaid numbreid ei jää või kõne ei saa klahvistikusisendit saata, tagastatakse tõrge häälagendile, et ta saaks olukorra lahendada. ## `no_response` Hoiab häälagendi vaikivana, kui automaatsüsteem räägib veel või palub tal kuulamist jätkata. See ei ole mõeldud elava inimese tervituse, küsimuse ega tegeliku ootejärjekorra jaoks. See on vaikimisi saadaval ja sellel puudub häälagendi säte. Tavaliselt piisab sisseehitatud kirjeldusest. Rohkelt IVR-i kasutavate kõnede puhul rõhuta piiri juhises: ```text Stay silent while a phone menu is still speaking. Answer a live person as soon as they address you. ``` See toiming ei lõpeta kõnet. ## `wait_on_hold` Viib väljuva agendi vaiksesse ooteolekusse, kuni inimene naaseb. Mudel kasutab seda ainult pärast seda, kui teine osapool ütleb selgesõnaliselt, et agent pannakse ootele. See on väljuvatel kõnedel automaatselt saadaval ja sellel puudub juhtpaneelis seadistus. ```text If a person explicitly puts you on hold, wait silently. When they return, continue from the question you were discussing. ``` Ära suuna agenti seda kasutama IVR-i „palun oodake” sõnumi korral. Vaikimisi kestab ootelolek kuni 15 minutit. Tavapäraste väljuvate kõnede puhul aktsepteerib `POST /v1/call` positiivse täisarvuna määratud väärtust `max_hold_seconds`; Realtime’i tekstisisene kasutus piirab `max_hold_seconds` väärtuseni 10–900 sekundit. Kui inimene naaseb, jätkab agent kõnet kõne lõpetamise põhjust muutmata. Kui piirang aegub, lõpetab platvorm kõne väärtusega `end_reason: "ai_hangup"`. ## `search_knowledge_base` Otsib agendile lisatud dokumentidest ja tagastab asjakohased lõigud. Selle lubamiseks lisa teadmistebaas või üksikud teadmiste dokumendid, seejärel ütle mudelile, millised vastused peavad tulema neist allikatest: ```text Search the knowledge base before answering policy questions. If the first search is inconclusive, try once more with different key terms. ``` Kui otsing ebaõnnestub, tagastatakse tulemus agendile. Juhtpaneeli ja API seadistamise kohta vaata [teadmistebaasi](/et/guides/knowledge-base). ## `play_sound` Esitab agendi seadistatud teavitusheli pärast samas voorus toimunud kõnet. Määra juhtpaneelis **Täpsemad → Tööriista heli** väärtuseks **Chime**, **Ding** või **Beep**, seejärel juuruta agent. **None** eemaldab tööriista. [Agents API](/api-reference/agents) abil määra `play_sound_asset` väärtuseks `"chime"`, `"ding"` või `"beep"`, seejärel juuruta. Tööriista keelamiseks määra väärtuseks `""`. ```text After confirming that an appointment was saved, say "You're all set" and play the notification sound. ``` Esituse ebaõnnestumine tagastatakse agendile ega lõpeta kõnet. ## `send_email` Saadab lihttekstiga e-kirja ühele agendi omaniku seadistatud adressaadile. Mudel määrab teema ja sisu. See ei näe kunagi adressaadi parameetrit ega saa aadressi valida või muuta. Luba juhtpaneelis **Täpsemad → Saada e-kiri**, salvesta adressaadi aadress, seejärel juuruta agent. [Agents API](/api-reference/agents) abil määra nii `send_email_enabled: true` kui ka mittetühi `send_email_recipient`, seejärel juuruta. Määra viipas käivitaja ja nõutud sisu: ```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. ``` Ühe kõnega saab proovida saata kuni kolm e-kirja. Iga teema pikkus on piiratud 300 tähemärgiga ja iga sisu 20 000 tähemärgiga. Puuduv seadistus, vigane sisu, kõnepõhine piirang ja edastamise ebaõnnestumised tagastatakse agendile. Ebaõnnestunud edastus kasutab siiski ära ühe kolmest katsest. Testi kontrollitud adressaadiga enne laialdast juurutamist. Brauseri Talk ja simulatsioonid saadavad päris e-kirju; proovikäitusrežiimi pole. ## Ühilduvuse märkus Seadistus **Täpsemad → Katkestamatud teavitused** ja pärandväli `speak_uninterruptible_enabled` jäävad ühilduvuse tagamiseks alles, kuid nende lubamine ei avalda mõju. Jäta seadistus välja; ükski viip ei saa seda tööriista aktiveerida. Nõutava kõne alguse teavituse jaoks kasuta **Nõusolekuteadet**. See esitatakse sõna-sõnalt enne tavapärast vestlust ja seda ei saa katkestada. Vaata [kõne salvestamise nõusoleku seadusi](/et/guides/recording-consent-laws). ## Sisseehitatud tööriistade testimine ja jälgimine Kasuta viipade, teadmiste otsingu, helide ja e-kirjade kontrollimiseks brauseri Talki või simulatsiooni. Need keskkonnad ei suuda taastada telefonivõrgu käitumist. Testi klahvistiku navigeerimist ja ootelolekut väljuval telefonikõnel ning testi täielikku sooja üleandmist päris kõnel sobiva imporditud VoIP-numbri abil. Realtime’i tugi on piiratud, nagu ülaltoodud tabelis näidatud. ## Kõned, hinnakujundus ja veebikonksud Sisseehitatud toimingutel ei ole kasutuspõhist tööriistatasu. Tavapärased kõne- ja teenusepakkujatasud kehtivad endiselt; vaata [Hinnakujundus](/et/guides/pricing). Nende kõned ja tulemused võivad ilmuda lõpetatud transkriptsioonis, kuid need ei väljasta sündmusi `telephony.tool` ega `web.tool`. Need sündmused on mõeldud [kasutaja määratletud funktsioonide](/et/tools/overview) jaoks. Ainult lõpule viidud kõne lõpetamine või ümbersuunamine muudab kõne `end_reason`; muud tõrked tagastatakse agendile. Kõnesalvestise kohta vaata [lõpetamise veebikonkse](/et/webhooks/call-complete).