Skip to main content
PUT
Актуализиране на асистент
Този endpoint ви позволява да актуализирате конфигурацията на съществуващ AI асистент. Всички полета са опционални - предоставете само полетата, които искате да актуализирате.

Параметри в пътя

integer
required
Уникалният идентификатор на асистента за актуализиране

Тяло на заявката

Основни полета

string
Името на асистента (максимум 255 символа)
integer
ID на гласа за използване от асистента. Използвайте endpoint-а Get Voices с параметъра mode, за да получите съвместими гласове за вашия режим на двигателя.
integer
ID на езика за асистента. Използвайте endpoint-а Get Languages, за да получите наличните езици.
string
Типът на асистента. Опции: inbound, outbound
string
Режимът на двигателя. Опции: pipeline, multimodal, dualplex
Промяната на режима ще нулира настройките, специфични за режима, към настройките по подразбиране за новия режим.
string
Часовата зона за асистента (напр. “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 за отмяна на назначението. Трябва да принадлежи на вашия профил.
За inbound асистенти телефонният номер не може да бъде от тип Caller ID и не може да бъде вече назначен към друг inbound асистент.

Персонализирани инструменти по време на разговор

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
Дали да се позволят прекъсвания от обаждащия се.
Не може да се деактивира за режими multimodal и dualplex.
boolean
Дали да се използва filler аудио по време на обработка.
Налично само за режим pipeline.
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, ai
number
Ниво на чувствителност за край (0-5)
number
Ниво на чувствителност за прекъсване (0-5)
integer
Минимален брой думи преди разрешаване на прекъсване (0-10). Задайте null за деактивиране.

Фонов звук

string
Фонов звук. Опции: off, office, city, forest, crowded_room, cafe, nature
number
Ниво на звука на фоновия звук (0-1)

Конфигурация за webhook

boolean
Дали webhook нотификациите са активирани
string
URL на webhook за нотификации след разговор. Задайте null за премахване.
boolean
Дали да се изпращат webhook-и само при завършени разговори (не неуспешни/без отговор)
boolean
Дали да се включи URL за записа в webhook payload-а

Оценка след разговор

boolean
Дали да се активира AI оценка след разговор
array
Схема за дефиниция за извличане на данни след разговор. Заменя съществуващата схема.

Променливи

object
Ключ-стойност двойки от персонализирани променливи. Заменя всички съществуващи променливи.

Настройки за приключен разговор

integer
Минути на неактивност в чата преди разговорът да се счита за приключен (1-1440). Задайте null за деактивиране. По подразбиране: 30
boolean
Дали да се позволи повторно задействане на разговора след приключване поради неактивност
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 модел, доставчици)