Ръководства

Гласов агент

Агентът е толкова добър, колкото добре е написан системният му промпт. Тази страница е ръководство как да го напишете, с три готови образеца за копиране и лимитите, които трябва да имате предвид.

1Структура на systemPrompt

Добрият промпт има четири части. Без някоя от тях рано или късно агентът заседава и не знае какво да прави - или мълчи, или си измисля нещо.

• Кой съм - едно до две изречения: име на фирмата, роля, тон на гласа. Агентът трябва да се оправи с това още в първата реплика.
• Какво умея - конкретни задачи, които агентът наистина може да изпълни (поръчка, час, информация) - не общото „ще помогна с всичко“.
• Какво НИКОГА не правя - граници: какво агентът не бива да измисля, да обещава или да съобщава. Тази част най-често се пропуска, а именно тя прави разликата между агент, който измисля цени, и агент, който честно казва „не знам, обадете се на...“.
• Как да завърша разговора - кога и как да приключи разговорът (обобщение, сбогуване) и какво да се прави, когато клиентът иска нещо извън обхвата.

По-дългите инструкции забавят отговора приблизително с една десета от секундата на всеки две хиляди знака - редакторът на агента предупреждава за това от 3000 знака. Твърдият лимит е 6000 знака.

Три пълни образеца - копирайте и допълнете по свой вкус:

Рецепционист с поръчки

Ти си гласовият рецепционист на кафене „Нула“ във Виноград. Говориш спокойно,
приятелски и кратко - както би говорил опитен сервитьор, а не робот.

КАКВО УМЕЕШ
- Приемаш поръчки за взимане от място (кафе, чай, кроасани, сандвичи).
- Съобщаваш актуалното работно време: понеделник до петък 8:00-18:00,
  събота и неделя 9:00-15:00.
- В края на поръчката я повтаряш цялата и потвърждаваш часа за взимане
  (най-рано 15 минути от сега).

КАКВО НИКОГА НЕ ПРАВИШ
- Не измисляш цени или артикули, които не са в менюто - кажи, че точната
  цена ще потвърди персоналът на място.
- Не обещаваш доставка, кафенето не доставя.
- Никога не се преструваш на човек, когато клиентът те попита направо -
  кажи, че си гласов асистент на кафенето.

КАК ДА ЗАВЪРШИШ РАЗГОВОРА
Обобщи поръчката и часа за взимане, пожелай приятен ден и приключи
разговора. Ако клиентът иска нещо, което не можеш да решиш (рекламация,
кетъринг), кажи му да се обади отново в работно време и да говори
директно със собственика.

Проучване на удовлетвореността

Обаждаш се от името на онлайн магазина „Ботаника“ с кратко проучване на
удовлетвореността след скорошна поръчка. Учтива си, преминаваш направо
към въпроса и не протакаш разговора излишно.

КАКВО УМЕЕШ
- Питаш клиента дали има минутка за три кратки въпроса.
- Въпрос 1: Как би оценил удовлетвореността си от поръчката по скала от 1 до 5?
- Въпрос 2: Пристигна ли пратката навреме?
- Въпрос 3: Има ли нещо, което бихме могли да подобрим?
- Запомняш отговорите и в края на разговора ги обобщаваш накратко.

КАКВО НИКОГА НЕ ПРАВИШ
- Не притискаш клиента, ако откаже или каже, че няма време - веднага
  се сбогуваш учтиво.
- Не разглеждаш рекламации и връщане на стоки - те са за линията за
  клиенти, чийто номер продиктуваш на клиента, ако го поиска.
- Не предлагаш отстъпки или купони, нямаш такова право.

КАК ДА ЗАВЪРШИШ РАЗГОВОРА
Благодари за времето и обратната връзка и пожелай приятен ден. Ако
клиентът някога каже, че не иска да продължи, веднага приключи разговора
учтиво, без повече въпроси.

Портиерна / деловодство

Ти си гласовата портиерна на фирма „Нордвекс“ в административна сграда в
Панкрац. На този номер се обаждат куриери, посетители и доставчици.

КАКВО УМЕЕШ
- Установяваш кой се обажда и с каква цел (куриер с пратка, посетител
  на среща, доставчик).
- При посетител питаш за името и при кого има среща, казваш му да се
  обяви на рецепцията в приземния етаж и да изчака, докато някой дойде
  да го вземе.
- На куриера казваш да остави пратката на рецепцията и да напише там
  името на фирмата и на получателя.
- Приемаш кратко съобщение, когато търсеният не е на разположение.

КАКВО НИКОГА НЕ ПРАВИШ
- Не съобщаваш номера на личните мобилни телефони на служителите -
  предлагаш прехвърляне към рецепцията или съобщение.
- Не пускаш никого „горе сам“ - всички посетители минават през
  рецепцията.
- Не даваш информация кой е в сградата и кога - кажи, че трябва да
  провери на рецепцията.

КАК ДА ЗАВЪРШИШ РАЗГОВОРА
Повтори какво е уговорено (съобщение, изчакване на рецепцията,
прехвърляне), пожелай приятен ден и приключи разговора.

2Шаблони по отрасъл

Не искате да пишете промпт от нулата? В сайта има готови шаблони за шест отрасъла (зъболекарски кабинети, автосервизи, ресторанти, онлайн магазини, агенции за недвижими имоти, майстори) - готов системен промпт, примерен диалог и пример колко би струвал такъв рецепционист. Копирайте и допълнете по свой вкус, както при образците по-горе.

Преглед на шаблоните по отрасъл

3firstMessage

firstMessage е първото изречение, което клиентът чува - при входящо обаждане веднага след вдигането, при изходящо веднага след като извиканият вдигне телефона.

• Кратко, говоримо изразяване - както би го казал човек, а не както би го написал в имейл.
• Кажете веднага кой се обажда или вдига - клиентът трябва за три секунди да знае с кого говори.
• Завършвайте с отворен въпрос („как мога да ви помогна“, „имате ли минутка“) - не с дълъг монолог.
• Прочетете го на глас - което изглежда добре на хартия, може да звучи накъсано на глас.
• При изходящи обаждания се представете веднага и с причината за обаждането - хората неохотно вдигат непознати номера.

4Инструменти

Инструментът е адрес на вашето API, който агентът извиква по средата на разговора и използва отговора веднага в речта си. Без инструмент агентът може само да говори; с инструмент може да провери поръчка, да намери свободен час или да запише резервация.

Инструментите се създават в портала на /agent/nastroje (или чрез POST /v1/tools) и после се включват на агента с отметка в детайла му (в API полето toolIds). Инструментът принадлежи на акаунта, не на агента - един и същ инструмент могат да ползват няколко агента. При него задавате четири неща:

• Име - четливо („Проверка на поръчка“). Името за модела се извежда от него автоматично (overit_objednavku) и се показва под полето.
• Кога агентът да го използва - единственото, по което моделът решава изобщо да извика инструмента. Пишете го като указание: „Използвай, когато обаждащият се пита къде е поръчката му.“
• Адрес и метод - само https, публично достъпен. GET праща параметрите в query, POST в JSON тялото. Към това хедъри, обикновено Authorization.
• Параметри - за всеки посочвате откъде идва стойността: моделът я извлича от разговора, попълва се номерът на обаждащия се или на извиквания, или е фиксирана стойност.

Така изглежда заявката, която пристига на вашия endpoint по време на разговора:

POST https://api.vashetoprilozhenie.bg/porachki
Content-Type: application/json
Authorization: Bearer vash_klyuch

{
  "nomer_na_porachka": "A-42",
  "telefon": "+420777123456"
}

А така отговорът, с който агентът умее да работи - кратък JSON, от който може да се каже едно изречение:

{
  "status": "izpratena",
  "dostavka": "utre predi obed"
}

5Прехвърляне към човек

Агентът може да предаде разговора на ваш номер, когато обаждащият се поиска човек или попадне на нещо, което агентът не може да реши. Включва се в детайла на агента (в API полето transferTo), условието пишете като указание за модела в transferCondition. Без него поставяме изречение по подразбиране.

На собствения гласов двигател на volai

На собствения гласов двигател на volai прехвърлянето става чрез мост: агентът казва, че ви свързва, обаждащият се чува сигнал за свободно и човекът на вашия номер вижда номера на агента. След вдигането агентът замълчава и разговорът продължава между вас двамата през volai. Ако някой от вас затвори, разговорът приключва и за двамата. Ако не вдигнете до 25 секунди, агентът се извинява на обаждащия се, предлага съобщение и продължава.

Прехвърляне към собствен номер на volai не е възможно - разговорът би се връщал сам към себе си, докато свърши балансът. Премиум линиите (90x) са забранени по същата причина.

Агент, който използва номер за обаждания и SMS, прехвърля само към чешки номера (+420): обажданията от този номер вървят само към чешки номера, затова номер за прехвърляне извън +420 не се запазва при такъв агент и API връща destination_not_allowed.

6Какво да се запише от разговора

Вместо да четете целия запис, можете да кажете какво точно искате от разговора - име, брой бройки, дали въпросът е спешен. Агентът го попълва след разговора и вие го получавате като JSON.

Всяко поле има ключ, тип и описание. Най-много десет полета на агент:

• Ключ (key) - малки латински букви, цифри и долна черта, до 40 знака - трябва да започва с малка буква. Под това име ще намерите стойността в резултата.
• Тип (type) - string, number или boolean.
• Описание (description) - какво точно да извлече моделът, от 5 до 500 знака. Напишете и какво да направи, ако в разговора не прозвучи.
• Възможности (enumValues) - незадължителен списък, само при текстово поле. Моделът тогава избира само от предложените стойности, така че резултатът може веднага да се филтрира. Най-много 20 възможности, всяка до 60 знака.

curl -X PATCH https://volai.eu/v1/agents/ag_kx91fa2b \
  -H "Authorization: Bearer vk_VASHIYAT_KLYUCH" \
  -H "Content-Type: application/json" \
  -d '{
    "dataFields": [
      {"key": "ime", "type": "string", "description": "Името на обаждащия се, което сам е казал. Ако не е споменато, остави празно."},
      {"key": "broy_kafeta", "type": "number", "description": "Колко кафета е поръчал обаждащият се."},
      {"key": "spechnost", "type": "string", "description": "Колко спешен е бил случаят.", "enumValues": ["niska", "obichayna", "visoka"]}
    ]
  }'

Резултатът се появява на три места: в детайла на обаждането в портала като карта „Записани данни“, в полето data при обаждането (GET /v1/calls и GET /v1/calls/{id}) и в тялото на webhook call.completed.

{
  "call": {
    "id": "c_8f2ac1d4",
    "status": "completed",
    "hasRecording": true,
    "data": {
      "ime": "Мария Николова",
      "broy_kafeta": 2,
      "spechnost": "obichayna"
    }
  }
}

Стойност null означава „в разговора не прозвуча“ - също и когато моделът отговори с празен текст. Ако нямате полета при агента, ключът data в отговора изобщо го няма.

7Цел на агента и оценка

Целта е едно изречение какво трябва да постигне разговорът - „уговаряне на час за оглед“, „установяване дали клиентът се интересува от офертата“. Попълвате я в портала в полето „Цел на агента“ (при създаване на агента и по всяко време по-късно в редакцията му) или през REST API и MCP с полето goal в POST/PATCH /v1/agents и create_agent/update_agent (най-много 300 знака).

Целта отива към агента като критерий за оценка на разговора: след края на разговора моделът чете записа и решава дали целта е изпълнена, неизпълнена или от разговора не може да се определи. Резултатът ще видите при обаждането в портала - в детайла и в списъка с обаждания - и в имейла след разговора, до обобщението.

Какво знае агентът (материали)

Освен инструкциите можете да дадете на агента материали - работно време, ценова листа, често задавани въпроси. Попълвате ги в портала в полето „Какво знае агентът“ (раздел Разширени), през API с полето knowledge в POST/PATCH /v1/agents. Текстът се добавя в края на промпта, побира се в 20000 знака, а PATCH с празна стойност го изтрива. За разлика от инструмента материалите не се променят по време на разговора - онова, което се променя (статус на поръчка, свободни часове), е за инструмент, не за тук.

8Имейл след разговора

След края на разговор с агента volai ви изпраща имейл с обобщение и връзка към детайла на разговора в портала - същото обобщение, което виждате и в API в полето summary. Пристига при агенти, работещи на собствения гласов двигател на volai (поле provider: "engine"); агент на ElevenLabs (provider: "elevenlabs") засега не го получава.

Превключвателят „Имейл след всеки разговор“ ще намерите на страницата Настройки - с изключването му го спирате наведнъж за целия акаунт. На отделен агент го изключвате поотделно с отметката „Изпращай ми имейл след всеки разговор“ в детайла му (в API полето notifyEmail: false). За разговор идва най-много един имейл, а разговор, за който няма какво да се докладва (без обобщение, без записани данни и без причина за прекратяване), имейл не задейства.

9Записи

Разговорите на агента се записват и в портала ги пускате направо в детайла на разговора - с кликване в записа се придвижвате до точното място. Можете да ги изтеглите или пуснете другаде от GET /v1/calls/{id}/recording (със същия API ключ) - форматът се определя от хедъра content-type на отговора: при агент на ElevenLabs audio/mpeg (MP3), при агент на двигателя на volai в момента audio/ogg. Дали разговорът има запис, казва полето hasRecording.

• Пазим ги 90 дни от разговора, после се изтриват. Преписът и обобщението запазваме, те не се изтриват със записа. След деветдесет дни endpoint-ът връща recording_expired.
• Могат да се изключат при всеки агент поотделно - с превключвател в детайла му, в API с полето recordCalls: false. Запис не се създава при разговори, започнали от този момент нататък; разговор, който вече звъни или тече, се подчинява на настройката от момента, в който е започнал (изходящият - от момента на набирането), така че още ще се запише.
• Записват се само разговорите на вградения агент. Директната връзка между два номера (bridge), relay и разговор през SIP не се записват.

Всяка грешка на API носи cause (кой я отстранява) и action (какво да се направи) - вижте Формат на грешките в справочника за REST API.

10Лимити

• Разговорът трае най-много 10 минути (600 секунди), после агентът сам го прекратява.
• Ако обаждащият се мълчи 20 секунди, агентът приема това за край на разговора и затваря.
• Отговорът на агента идва приблизително 1 секунда след като приключите да говорите - в реална експлоатация леко варира според натоварването.

11Езици

Агентът може да говори на пет езика - чешки (по подразбиране), словашки, английски, немски и полски - езикът се задава в детайла на агента (полето language в POST/PATCH /v1/agents, create_agent/update_agent) - отделен глас за всеки език (Cartesia) има само собственият гласов двигател на volai (вижте глава Гласове по-долу), агент на ElevenLabs говори на избрания език с гласа Анет.

12Пробно обаждане

Бутонът „Обади ми се за проба“ в детайла на агента в портала стартира от агента истинско обаждане на номера, който зададете - бързо изпитване как звучи агентът и как реагира на вашия системен промпт, без да се налага да звъните ръчно на номера му.

Таксува се като обикновено изходящо обаждане с агент, включително надбавката за агент (вижте глава Цени по-долу) - без отстъпка и без специална тарифа.

Агент на собствения гласов двигател на volai може да направи пробно обаждане и без собствен телефонен номер - използва се споделената линия на volai, така че извикваният на дисплея вижда номера на volai, не на агента. Агент на ElevenLabs без собствен номер не може да стартира пробно обаждане, докато не му зададете номер.

Най-много 3 опита за пробно обаждане на ден на акаунт, за всички агенти заедно - брои се всеки опит, който действително е набран, дори никой да не е вдигнал; опит, който се е провалил още преди набирането (недостатъчен баланс, заета линия), не се брои в лимита. Обикновените обаждания през POST /v1/calls този по-строг лимит нямат.

13Гласове

Изборът на доставчик при създаване има три състояния: useForOutboundTasks: true в POST /v1/agents или create_agent избира собствения гласов двигател на volai, false започва на стандартната платформа (ElevenLabs), дори да зададете едновременно и прехвърляне, а пропуснато поле използва текущата настройка по подразбиране на инсталацията, която зависи от включването на двигателя и разрешените езици. Само cs или sk не гарантират двигателя; при изключен двигател по подразбиране агентът се създава на ElevenLabs. Когато изричното false отмени двигателя по подразбиране за езика, отговорът при създаване носи предупреждение elevenlabs_by_explicit_choice; затова агент само за входящи обаждания създавайте без полето. Когато на агент на ElevenLabs включите transferTo, volai се опитва да го премести на двигателя след запазването. Опитът може да е спрян, недостъпен или да се провали, затова винаги проверявайте резултата: при REST със следващ GET /v1/agents/{id}, при MCP във върнатия агент. Коя платформа използва агентът, казва полето provider; докато остава на ElevenLabs, прехвърлянето не работи. При успех гласът може да се промени. Същия опит задейства и промяната на language при агент на ElevenLabs от език, на който новите агенти се създават на ElevenLabs (днес en, de, pl), към език, на който се създават на двигателя (cs, sk); агентът тогава получава гласа по подразбиране на двигателя за новия език (Милена, Катарина). Промяната между cs и sk нищо не премества. Иначе между платформите превключва volai (поддръжката). Агент на ElevenLabs приема само katty или суров ElevenLabs voice id; останалите гласове от каталога работят само на двигателя.

voiceId при create_agent/update_agent (и едноименното поле в POST/PATCH /v1/agents) избира гласа на агента. Нефилтрираният списък GET /v1/voices (MCP list_voices без аргумент provider) не показва гласа на ElevenLabs katty - REST го връща едва с ?provider=elevenlabs, MCP с аргумент provider: "elevenlabs". Гласовете на Cartesia (Милена, Ян и гласове на други езици) са за агенти на собствения двигател на volai, Кати за агенти на ElevenLabs (за това на коя платформа работи агентът има бележка по-горе). По-старият глас anet остава само на агентите, които вече го имат - ElevenLabs от 12. 9. 2026 не го дава на нови агенти и volai отхвърля такава заявка с обяснение. При създаване с изрично useForOutboundTasks: true познат глас, който двигателят не поддържа, включително katty, се заменя с гласа по подразбиране на двигателя за избрания език; ако двигателят бъде избран едва от настройката по подразбиране при пропуснато поле, същият несъвместим глас се отхвърля. Суров ElevenLabs ID двигателят отхвърля винаги. Без voiceId агентът получава гласа по подразбиране на своя доставчик - при двигателя Милена, при ElevenLabs гласа на шаблона (Кати).

Каталогът предлага за всеки език поне един женски и един мъжки глас (при чешкия днес четири): cs: Milena, Jan, Tereza, Marek; sk: Katarina, Peter; en: Skylar, Daniel; de: Alina, Lukas; pl: Ewa, Kacper; nl: Ariel, Alexander; pt: Christine, Filipe; sl: Sarah, Daniel; ro: Mikidutza, Oliver; da: Isabella, Søren; et: Alice, Chris; lv: Matilda, George; bg: Yoana, Peter K; fi: Soili, Jussi; el: Crhysa, Iordanis; fr: Natasha, Max; it: Rossana, Marco; hu: Zsófia, Gábor; lt: Sarah, Daniel; sv: Sanna, Filip. Порталът предлага само гласове на избрания език на агента - превключват се заедно (вижте глава Езици по-горе).

Всички гласове в таблицата принадлежат на собствения гласов двигател на volai. На агент на ElevenLabs API ги отхвърля с грешка 400 - той взема от каталога само katty (скрит в нефилтрирания списък) и суров ElevenLabs voice id.

voiceId приема и суров ElevenLabs ID, но само за агент на стандартната платформа (provider: "elevenlabs"). За агент на двигателя използвайте id на глас от каталога. Непозната или несъвместима с доставчика стойност връща грешка, която изброява валидните възможности.

14Статистики

Детайлът на агента в портала показва броя на вдигнатите обаждания, средната и най-дългата им продължителност и броя за последните 30 дни - собствено API за това няма, числата можете да изчислите и сами върху изхода на GET /v1/calls.

15Цени

Гласовият агент се таксува допълнително към цената на обаждането, по секунди - без закръгляне до цели минути. Тарифите са без ДДС, както цялата ценова листа.

Подробна ценова листа с примери има на страницата Цени.

16Преписи и webhook

След края на разговора вземате преписа и обобщението чрез GET /v1/calls/{id} (полета transcript и summary) - или volai сам ги изпраща на вашия URL като събитие call.completed, щом са готови. Форматът на преписа, проверката на подписа и поведението при грешка са описани на страницата Webhooks.

17Гласов двигател volai

Част от агентите днес работят на собствения гласов двигател на volai вместо на ElevenLabs. Превключването променя маршрутизирането на разговора и с него се пренася цялата конфигурация на агента - инструкции, първо изречение, полета за събиране, цел на разговора, знания, инструменти и прехвърляне към човек. Какво се променя при превключването и какво не:

• Гласове агент, който е имал избран глас на ElevenLabs (Кати или по-старият Анет), получава след превключването гласа по подразбиране на двигателя за своя език - при чешкия Милена. Двигателят не предлага гласа на ElevenLabs като основен свой глас, ElevenLabs при него остава само резерва при срив на Cartesia. В настройките на агента после избирате всеки друг глас от каталога за езика на агента, при чешкия например Ян. Глас, който агентът вече има от каталога на двигателя, не се променя при превключването.
• Време за отговор остава същото както при ElevenLabs - около 1 секунда след като приключите да говорите.
• Записи без промяна - пак се пазят 90 дни и могат да се изключат по същия начин в детайла на агента.
• Предупреждение за записване без промяна - ако имате при агента включено изречение за записване (`recordingNotice`), volai и тук добавя към първото изречение на агента кратко изречение, че разговорът се записва (вижте раздел Записи по-горе). Без тази опция или с изключено записване изречението изобщо не се добавя.
• Съобщение, че говори ИИ без промяна - първото изречение го изпращаме на доставчика така, както сте го написали. Не го налагаме: когато липсва съобщение, че обаждащият се говори с дигитален асистент, само ви предупреждаваме (европейски AI Act, чл. 50), запазването не се спира. Отговорността за съобщението остава ваша и при двата доставчика еднакво.
• Инструменти и прехвърляне на разговор преминават с агента - успешното превключване изпраща на двигателя и инструментите му, и зададеното прехвърляне към човек, не е нужно да ги въвеждате отново. На собствения гласов двигател на volai прехвърлянето работи чрез мост (както описва глава Прехвърляне към човек по-горе) - мостът е проверен в обичайна експлоатация и порталът при агент на двигателя показва пълния формуляр за прехвърляне. При агент на стандартната платформа (ElevenLabs) включването на прехвърляне веднага след запазването стартира опит за преминаване на собствения двигател; проверете резултата в полето `provider`, защото при спиране, недостъпност на двигателя или грешка може да остане на ElevenLabs и прехвърлянето там не работи. При успешно преминаване гласът му може да се смени с гласа по подразбиране на двигателя. Масовата миграция на номера на вълни затова пропуска агентите със зададено прехвърляне.
• Гласова поща при изходящи обаждания умее да разпознава само собственият гласов двигател на volai - в рамките на няколко секунди след вдигането разпознава секретар вместо човек и според настройката само го отбелязва, затваря или изчаква сигнала и чете съобщение. Настройва се в детайла на агента (само агент на двигателя), в API и MCP с полето `voicemail`. Списъкът с обаждания тогава при изходящо обаждане с гласова поща показва „Вдигна гласова поща“ вместо обичайния резултат. Стандартната платформа (ElevenLabs) няма разпознаване.
• Напомняне при мълчание възпроизвежда само собственият гласов двигател на volai - когато обаждащият се мълчи дълго, агентът веднъж пита дали още е там. Настройката (включено/изключено, брой секунди от 3 до 25) се запазва при двата доставчика - при агент на стандартната платформа (ElevenLabs) полето в детайла на агента е сиво и стойността прозвучава едва след преминаване на двигателя. Собствен текст на подканата (`silencePromptText`, до 80 знака, вместо подразбиращото се „Там ли сте?“) се запазва по същия начин.
• Защита на първото изречение умее само собственият гласов двигател на volai и само при изходящи обаждания: докато първото изречение се възпроизвежда (зададен брой секунди, от 0 до 20), кратка реакция на онзи, който е вдигнал („Ало?“, „Да?“), не го прекъсва. Репликата на извиквания без прекъсвач (стоп, не, момент, стига, изчакайте) в защитения прозорец се отхвърля: изречението не се прекъсва, в преписа я няма и агентът не реагира на нея, докато с прекъсвач изречението се прекъсва винаги. Полето `firstMessageProtectSecs` без наложена стойност по подразбиране се запазва при двата доставчика - при агент на стандартната платформа (ElevenLabs) е сиво в детайла на агента и прозвучава едва след преминаване на двигателя. В преписа на разговора репликата на агента, която обаждащият се е прекъснал, носи флага `interrupted`.
• Смях на агента само собственият гласов двигател на volai умее да реагира със смях, когато вие или обаждащият се се засмеете или се пошегувате - и то само при чешки глас на Cartesia (Милена, Ян и други от каталога). Стандартната платформа (ElevenLabs) смях не умее изобщо, дори да зададете полето. В настройките на агента избирате Автоматично (двигателят сам изключва смяха при чувствителни теми, например дългове, здравеопазване, институции или погребални услуги), Включено (отменя това разпознаване) или Изключено. Промяната важи от следващия разговор.

18Календар и срещи

Агент на собствения гласов двигател на volai умее направо в разговора да установи свободен час във вашия Google или Apple календар и да запише срещата веднага - казва на обаждащия се дали времето е свободно, предлага най-близките свободни часове и след потвърждаване на името записва срещата. Включва се в редактора на агента в раздел Календар: избирате връзка (Данни и интеграции), конкретен календар и правила за достъпност.

• Правила за достъпност прозорци по дни от седмицата (кога агентът изобщо предлага часове), продължителност на срещата, резерв между срещите, минимален срок преди уговореното време и хоризонт - докъде напред агентът търси. Стойностите по подразбиране редакторът попълва сам, но могат да се променят за всеки агент поотделно.
• Вградени инструменти календарът използва два вградени инструмента, check_availability и book_appointment - за разлика от собствените инструменти от глава Инструменти по-горе не се създават ръчно, включват се сами заедно с календара и не се броят в лимита на инструментите на акаунт.
• Само собственият двигател на volai работи изключително при агент на собствения гласов двигател на volai. Когато включите календара при агент на стандартната платформа (ElevenLabs), настройката се запазва и агентът веднага след запазването се опитва да премине на двигателя на volai - както при прехвърлянето към човек.
• Какво агентът казва и какво не агентът никога не чете какво е записано в календара - само дали даденото време е свободно. Телефонът на обаждащия се се записва в събитието само когато агентът го знае (скрит номер означава събитие без телефон).
• И извън разговор същото търсене на свободни часове и записване на среща е възможно и извън разговор през REST (POST /v1/integrations/{id}/availability, POST /v1/integrations/{id}/events) и MCP (find_free_slots, create_calendar_event) - подробности в раздел Календари в справочника за REST API и в справочника за MCP.