Актуализиране на асистент
Асистенти
Актуализиране на асистент
Актуализиране на конфигурацията на съществуващ AI асистент
PUT
Актуализиране на асистент
Този endpoint ви позволява да актуализирате конфигурацията на съществуващ AI асистент. Всички полета са опционални - предоставете само полетата, които искате да актуализирате.
Параметри в пътя
integer
required
Уникалният идентификатор на асистента за актуализиране
Тяло на заявката
Основни полета
string
Името на асистента (максимум 255 символа)
integer
ID на гласа за използване от асистента. Използвайте endpoint-а Get Voices с параметъра
mode, за да получите съвместими гласове за вашия режим на двигателя.integer
ID на езика за асистента. Използвайте endpoint-а Get Languages, за да получите наличните езици.
string
Типът на асистента. Опции:
inbound, outboundstring
Режимът на двигателя. Опции:
pipeline, multimodal, dualplexstring
Часовата зона за асистента (напр. “Europe/Bucharest”, “America/New_York”)
string
Първоначалното съобщение, което асистентът ще произнесе, когато разговорът започне (максимум 200 символа)
string
Системният prompt, който дефинира поведението и личността на асистента
Полета, специфични за режима
integer
ID на LLM модела за използване. Приложимо само за режим
pipeline.Използвайте endpoint-а Get Models, за да получите наличните модели.integer
ID на multimodal модела. Приложимо само за режими
multimodal и dualplex.Използвайте endpoint-а Get Models, за да получите наличните multimodal модели.integer
Резервен LLM модел ID за извиквания на инструменти в multimodal/dualplex режими. Задайте
null за премахване.number
Чувствителност за разпознаване на реда за multimodal/dualplex режими (0-1). Задайте
null за автоматично.Вторични езици
integer[]
Масив от допълнителни ID на езици, на които асистентът може да говори. Заменя съществуващите вторични езици. Подайте празен масив
[] за премахване на всички вторични езици.Настройки за knowledgebase
integer
ID на knowledgebase за прикачване. Задайте
null за премахване на knowledgebase.string
Как да се използва knowledgebase. Опции:
function_call- AI извиква функция за търсене (необходимо за multimodal/dualplex)prompt- Знанията се инжектират в prompt-а (само pipeline)
Телефонен номер
integer
ID на телефонен номер за назначаване. Задайте
null за отмяна на назначението. Трябва да принадлежи на вашия профил.Персонализирани инструменти по време на разговор
integer[]
Масив от ID на персонализирани инструменти за синхронизиране по време на разговор. Заменя всички съществуващи назначения на инструменти. Подайте празен масив
[] за премахване на всички инструменти. Всеки инструмент трябва да принадлежи на вашия профил.Вградени инструменти
array
Масив от вградени инструменти. Заменя всички съществуващи вградени инструменти. Подайте празен масив
[] за премахване на всички инструменти.Настройки за глас и TTS
boolean
Дали да се активира емоционална text-to-speech синтеза
number
Настройка за стабилност на гласа (0-1). По-високо = по-последователен глас
number
Настройка за приличност на гласа (0-1). По-високо = по-близо до оригиналния глас
number
Множител за скорост на говора (0.7-1.2)
number
Настройка за LLM температура (0-1). По-ниско = по-детерминистично
integer
ID на персонализиран TTS доставчик. Задайте
null, за да използвате езиковия по подразбиране. Използвайте endpoint-а Get Synthesizer Providers, за да откриете наличните доставчици.integer
ID на персонализиран STT доставчик. Само за Pipeline режим. Задайте
null, за да използвате езиковия по подразбиране. Използвайте endpoint-а Get Transcriber Providers, за да откриете наличните доставчици.Настройки за поведение при разговор
boolean
Дали да се позволят прекъсвания от обаждащия се.
boolean
Дали да се използва filler аудио по време на обработка.
object
Персонализирани профили за filler думи по категория. Заменя съществуващата filler конфигурация. Всяка категория е масив от кратки фрази.
positive: Filler думи за позитивни/утвърдителни отговориnegative: Filler думи за негативни/неутрални отговориquestion: Filler думи при обработване на въпросneutral: Filler думи за неутрални потвърждения
boolean
Дали да се записва разговорът
boolean
Дали да се активира потискане на шума
boolean
Ако е true, асистентът чака клиентът първо да заговори
Настройки за време
integer
Максимална продължителност на разговора в секунди (20-1200)
integer
Максимална продължителност на тишината преди повторно ангажиране в секунди (1-360)
integer
Максимална тишина в началото на разговора преди приключване (1-120 секунди). Задайте
null за деактивиране.integer
Максимално време за звънене преди отказване (1-60 секунди)
Настройки за повторно ангажиране
integer
Интервал за повторно ангажиране в секунди (7-600)
string
Персонализиран prompt за съобщения за повторно ангажиране (максимум 1000 символа). Задайте
null, за да използвате по подразбиране.Настройки за гласова поща
boolean
Дали да се приключи разговорът, когато се открие гласова поща
string
Съобщение за оставяне в гласовата поща преди затваряне (максимум 1000 символа). Задайте
null за деактивиране.Разпознаване на край
string
Тип разпознаване на гласова активност. Опции:
vad, ainumber
Ниво на чувствителност за край (0-5)
number
Ниво на чувствителност за прекъсване (0-5)
integer
Минимален брой думи преди разрешаване на прекъсване (0-10). Задайте
null за деактивиране.Фонов звук
string
Фонов звук. Опции:
off, office, city, forest, crowded_room, cafe, naturenumber
Ниво на звука на фоновия звук (0-1)
Конфигурация за webhook
boolean
Дали webhook нотификациите са активирани
string
URL на webhook за нотификации след разговор. Задайте
null за премахване.boolean
Дали да се изпращат webhook-и само при завършени разговори (не неуспешни/без отговор)
boolean
Дали да се включи URL за записа в webhook payload-а
Оценка след разговор
boolean
Дали да се активира AI оценка след разговор
array
Схема за дефиниция за извличане на данни след разговор. Заменя съществуващата схема.
Променливи
object
Ключ-стойност двойки от персонализирани променливи. Заменя всички съществуващи променливи.
Настройки за приключен разговор
integer
Минути на неактивност в чата преди разговорът да се счита за приключен (1-1440). Задайте
null за деактивиране. По подразбиране: 30boolean
Дали да се позволи повторно задействане на разговора след приключване поради неактивност
string
URL на webhook, извикван когато чат разговорът приключи поради неактивност. Задайте
null за премахване. Отделно от основния разговорен webhook.Примерни заявки
Актуализиране на основни настройки
Превключване към Multimodal режим
Актуализиране на инструменти и knowledgebase
Актуализиране на повторно ангажиране и гласова поща
Премахване на опционални настройки
Отговор
string
Съобщение за успех, потвърждаващо актуализацията на асистента
object
Бележки
- Само полетата, които предоставите в тялото на заявката, ще бъдат актуализирани
- За премахване на опционални полета, изрично ги задайте на
null - За изчистване на масиви (инструменти, вторични езици), подайте празен масив
[] - Асистентът трябва да принадлежи на удостоверения потребител
- Използвайте Get Voices endpoint с параметър
modeза получаване на съвместими гласове - За multimodal/dualplex режими,
knowledgebase_modeтрябва да бъдеfunction_call - За multimodal/dualplex режими,
allow_interruptionsне може да се деактивира - Промяната на режима нулира настройките, специфични за режима (LLM модел, multimodal модел, доставчици)

