Open in
Вградени инструменти
Давайте указания на агентите на ThunderPhone да приключват разговори, да прехвърлят обаждащи се, да навигират чрез клавиатури, да изчакват на задържане, да търсят в базата знания, да възпроизвеждат звуци, да изпращат имейли и да изчисляват суми.
Вградените инструменти позволяват на агента да изпълнява често срещани действия при обаждания, без да свързвате собствен API. Повечето са налични автоматично; имейлът, звуците, калкулаторът и търсенето в базата знания се показват едва след като конфигурирате съответната настройка или източник. Укажете на агента в подканата му кога да използва всяко действие.
| Инструмент | Използвайте го за | Как да го активирате | Поддържани разговори |
|---|---|---|---|
end_call | Приключване на завършен разговор | Включен по подразбиране; system_tool_settings може да го изключи | Телефон, Talk в браузъра, уиджет, симулация и Realtime |
transfer_call | Пренасочване на обаждащ се по телефона | Конфигурирайте маршрутизирането в подканата | Обикновени телефонни разговори; вграден Realtime с call_events може да използва непрехвърлен трансфер. Realtime за запазен агент не го включва. |
send_keypad_input | Натискане на клавиши в телефонно меню | Включен по подразбиране за изходящи разговори; system_tool_settings може да го включва или изключва | Телефонни разговори; вграден изходящ Realtime с call_events. Realtime за запазен агент не го включва. |
no_response | Продължаване на слушането, докато автоматизирано меню говори или обаждащ се мисли на глас; обаждащ се, който поиска от агента да изчака, получава само „Разбира се.“ | Винаги наличен | Всички видове разговори |
wait_on_hold | Безшумно изчакване човек да се върне | Включен по подразбиране за изходящи разговори; system_tool_settings може да го включва или изключва | Телефонни разговори и изходящи вградени Realtime сесии |
search_knowledge_base | Отговор от прикачени източници | Прикачете знания към агента | Разговори със запазен агент с прикачени знания |
play_sound | Възпроизвеждане на конфигуриран звук за известие | Разширени → Звук на инструмента | Разговори със запазен агент |
send_email | Изпращане на имейл до един фиксиран получател | Разширени → Изпращане на имейл | Разговори със запазен агент |
calculate | Точно изчисляване на суми, такси и ресто | Разширени → Калкулатор | Разговори със запазен агент |
end_call
Прекратява текущото обаждане, когато подканата указва на модела да го направи. Активирано е по подразбиране. Агент, който никога не трябва да затваря сам, например преводач, предаващ разговор между двама души, които сами прекратяват обаждането, може да го изключи чрез полето system_tool_settings на агента ({"end_call": false}). Тогава обаждането приключва, когато някой затвори, или чрез ограниченията за тишина и време.
Запишете условието и всяко необходимо сбогуване в подканата:
When the caller confirms they need nothing else, say goodbye and end the call.Обаждане, прекратено от модела, има end_reason: "ai_hangup", включително такова, което приключва
след предупреждението за ограничението на продължителността. Обаждането приключва с max_duration само ако
ограничението на продължителността бъде достигнато първо, с balance_exhausted, когато предплатеният
баланс се изчерпи, и с price_cap_reached, когато обаждането достигне твърдия ценови лимит на агента
(агентът първо казва кратко довиждане).
transfer_call
Прехвърля обаждащ се по телефон към фиксиран номер, предоставен от модела. Студеният трансфер е незабавен. Топъл трансфер с предварителна проверка се обажда насаме до дестинацията, преди да свърже страните. Топлият трансфер изисква потвърден импортиран VoIP номер, който може да извършва изходящи обаждания.
Поставете номера на дестинацията и точното условие за маршрутизиране в подканата:
If the caller asks for billing, transfer them to +15551234567.Успешният студен трансфер има end_reason: "ai_transfer"; завършеното топло прехвърляне има end_reason: "ai_warm_transfer". Неуспешният топъл опит връща контрола на агента, така че последващото приключване на разговора определя причината за прекратяването му. При сесии извън телефонни разговори заявката за трансфер вместо това прекратява сесията.
Вижте Прехвърляне на разговори за настройка в таблото и чрез API, маршрутизиране, проверка, обработка на неуспехи, ограничения и тестване.
send_keypad_input
Изпраща DTMF цифри от телефонната клавиатура 0–9, * и # към телефонна линия. Моделът го използва, за да навигира в IVR — автоматизираното меню, което подканва обаждащите се да натиснат клавиши. По подразбиране е включено за изходящи обаждания и изключено за входящи; задайте "send_keypad_input": true или false в system_tool_settings на агента, за да промените това за всяко обаждане.
Укажете на модела в кои менюта може да навигира и откъде идват поисканите стойности. Не му казвайте да отгатва опциите в менюто:
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.Платформата премахва неподдържаните знаци и изпраща валидните цифри по ред. Ако не останат валидни цифри или разговорът не може да изпрати въвеждане от клавиатурата, неуспехът се връща към агента, за да може той да се възстанови.
no_response
Запазва мълчанието на агента, докато автоматизирана система все още говори или го моли да продължи да слуша, както и когато обаждащият се мисли на глас („ъъ, я да видя“) или се обръща към друг човек. Когато обаждащият се поиска от агента да изчака, докато направи нещо („една секунда“, „нека проверя“, „можете ли да изчакате за секунда?“), и не му даде нищо друго, на което да отговори, агентът казва само „Разбира се.“ (не „Не бързайте“) и изчаква обаждащият се да проговори отново. Проверките на агента при мълчание продължават да се изпълняват и винаги се изговарят, ако линията остане тиха. Това не е предназначено за поздрав от реален човек, въпрос или действителна опашка за изчакване. Налично е по подразбиране и няма настройка на агента.
Ако вашият промпт указва на агента какво да каже, когато обаждащият се поиска малко време, промптът има предимство.
Обикновено вграденото описание е достатъчно. При разговори с много IVR подсилете границата в подканата:
Stay silent while a phone menu is still speaking. Answer a live person as soon
as they address you.Това действие не прекратява разговора.
wait_on_hold
Поставя изходящ агент в безшумно състояние на изчакване, докато човек на живо се върне.
Моделът го използва само след като другата страна изрично каже, че агентът е
поставен на изчакване. По подразбиране е включено за изходящи обаждания; задайте "wait_on_hold" в system_tool_settings на агента, за да го включите или изключите за всяко обаждане.
If a person explicitly puts you on hold, wait silently. When they return,
continue from the question you were discussing.Не подканвайте агента да го използва за съобщение „моля, изчакайте“ от IVR. По
подразбиране изчакването продължава до 15 минути. При обичайни изходящи обаждания POST /v1/call
приема положително цяло число за max_hold_seconds; вградената Realtime версия ограничава
max_hold_seconds до 10–900 секунди. Ако човекът
се върне, агентът продължава, без да променя причината за приключване на обаждането. Ако лимитът
изтече, платформата приключва обаждането с end_reason: "ai_hangup".
search_knowledge_base
Търси в документите, прикачени към агента, и връща подходящи откъси. Прикачете база знания или отделни документи от база знания, за да я активирате, след което кажете на модела кои отговори трябва да идват от тези източници:
Search the knowledge base before answering policy questions. If the first
search is inconclusive, try once more with different key terms.Ако търсенето е неуспешно, резултатът се връща на агента. Вижте База знания за настройка в таблото и чрез API.
play_sound
Възпроизвежда конфигурирания звук за известяване на агента след всяка реч в същия ход. В таблото задайте Разширени → Звук на инструмента на Камбанка, Звън или Бип, след което публикувайте агента. Няма премахва инструмента.
С Agents API задайте play_sound_asset като
"chime", "ding" или "beep", след което публикувайте. Задайте "", за да деактивирате
инструмента.
After confirming that an appointment was saved, say "You're all set" and play
the notification sound.Грешка при възпроизвеждане се връща на агента и не приключва обаждането.
send_email
Изпраща обикновен текстов имейл до единствения получател, конфигуриран от собственика на агента. Моделът предоставя темата и текста. Той никога не вижда параметър за получател и не може да избира или променя адреса.
В таблото активирайте Разширени → Изпращане на имейл, запазете адрес на получател,
след което публикувайте агента. С Agents API задайте и двете
send_email_enabled: true и непразен send_email_recipient, след което публикувайте.
Определете задействането и необходимото съдържание в подканата:
When the caller asks to leave a message, collect their name, callback number,
and message. Read the details back for confirmation, then email them.Едно обаждане може да направи най-много три опита за изпращане на имейл. Всяка тема е ограничена до 300 знака, а всеки текст — до 20 000 знака. Липсваща конфигурация, невалидно съдържание, лимитът за обаждане и грешките при доставяне се връщат на агента. Неуспешното доставяне все пак използва един от трите опита.
Тествайте с контролиран получател, преди да публикувате широко. Talk в браузъра и симулациите изпращат реални имейли; няма режим за пробно изпълнение.
calculate
Изчислява аритметичен израз точно и връща резултата, така че агентът
да не събира цени наум. По подразбиране е изключен. В таблото за управление
активирайте Разширени → Калкулатор, след което внедрете агента. С API за
агенти задайте calculator_enabled: true, след което внедрете.
Моделът записва израза, например 2*23.5 + 16.5 + 4, и прочита
резултата на обаждащия се. Изразите могат да използват числа, +, -, *, / и
скоби. Едно извикване може да съдържа до 10 израза, разделени с ;, например
междинна сума и общата сума с такса за доставка, с обща дължина до 500 знака.
Резултатите се закръгляват до 10 знака след десетичната запетая. Изчисленията са с точна десетична аритметика, така че
0.1 + 0.2 връща 0.3. Делението на нула и всичко останало в израза
се връщат на агента като грешка за коригиране. Изпълнява се в ThunderPhone и
отговаря незабавно, без допълнителна реплика или звук от писане.
Включете го за агенти, които съобщават общи суми за поръчки, такси или ресто. Не е необходима промяна в подканата.
Бележка за съвместимост
Настройката Разширени → Непрекъсваеми оповестявания и наследеното
поле speak_uninterruptible_enabled остават за съвместимост, но активирането им
няма ефект. Оставете настройката изключена; никаква подкана не може да активира този инструмент.
За задължително оповестяване при начало на обаждане използвайте Съобщение за съгласие. То се възпроизвежда дословно преди обичайния разговор и не може да бъде прекъснато. Вижте Закони за съгласие за записване на обаждания.
Тествайте и наблюдавайте вградените инструменти
Използвайте Talk в браузъра или симулация, за да проверите подканите, търсенето в база знания, звуците и имейла. Тези среди не могат да възпроизведат поведението на телефонната мрежа. Тествайте навигацията с клавиатурата и изчакването при изходящо телефонно обаждане, както и пълно топло прехвърляне при реално обаждане с подходящ импортиран VoIP номер. Поддръжката на Realtime е ограничена, както е показано в таблицата по-горе.
Обаждания, ценообразуване и уебхукове
Вградените действия нямат такса за инструмент за всяко използване. Обичайните такси за обаждания и доставчик
продължават да се прилагат; вижте Ценообразуване. Техните обаждания и резултати могат да се показват
в завършения транскрипт, но не генерират telephony.tool или web.tool.
Тези събития са за дефинирани от потребителя функции. Само завършено
прекратяване на разговора или прехвърляне променя end_reason на обаждането; другите неуспехи се връщат
към агента. Вижте Уебхукове при завършване за записа на обаждането.