# Основные термины
| Термин | Определение |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Платформа | Система для создания, эксплуатации и управления чат-ботами. |
| Собеседник | Участник Общение с ботом. Может быть как живой человек, так и автоматическая система, имитирующая человека |
| Агент | Сценарий Проекта или его часть, отвечающая за определенную самодостаточную часть/логику. В конкретный момент времени в Активный чат работает конкретный Агент из подключенного в Чат Проекта — Подключенный к чату Агент |
| Бот | Виртуальный участник Общение в каналах коммуникаций (Конечные каналы и Коннекторы ) |
| Общение | Процесс обработки Событие в Чате
- Процесс обмена информацией между Собеседник и Агентом
- Наличие запросов\реплик Собеседника не обязательно, так же, как и отправка сообщений Агента собеседникам - общение может состоять только из технических событий, например, оправка запросов в цикле, таймеры, вычисления
|
| Конечный канал | Софт, в котором происходит Общение между Бот и Собеседник (мессенджеры, соцсети, омниканальные платформы и тд.) |
| Канал Проекта | Настройка Проекта - настроенное в платформе подключение Проекта к Конечный канал (мессенджер, соцсети, виджеты) |
| Коннектор | Функционал Платформа и набор правил, драйвер для подключения Агента в определенный Конечный канал |
| Универсальный коннектор | открытый API для интеграции с произвольным Конечный канал с целью вывода Агента в этот канал для Общение, универсальны коннектор устанавливает собственную спецификацию API, требования которой должны удовлетворить Конечный каналы при интеграции, интегратор соглашается и принимает правила работы универсального коннектора. |
| Брендовый коннектор | коннектор для подключения Агента к конкретному Конечный канал (например, Telegram или Jivo), такой коннектор выполняет требования API целевого канала. |
| Синхронный коннектор | Коннектор, работающий по синхронному принципу: получает на свой API Request с событием\сообщением из Конечный канал и отправляет Response с ответом Агента |
| Асинхронный коннектор | Коннектор, работающий по синхронному принципу: отправляет ответы Агента в собственных Request в сторону Конечный канал , а не в Response, как это делает Синхронный коннектор |
| Чат | Cущность в Платформе - “Контейнер”, хранящий все Общение (диалоги) между Собеседником и Агентом в уникальном Конечный канал |
| Блокирующий слот | слот, по которому Агент встает в ожидание входящего сообщения из Канал Проекта |
| Диалог | отрезок Общение Собеседника и Агента в Чате - хронологический порядок сообщений. |
| Папка | это папка для группировки Проектов. |
| Компания | это рабочее пространство данного пользователя для задач создания и управления Агентами, просмотра аналитики общения Агентов и управления пользователями Компания. |
| Ресурсы Компании | интенты и внешние запросы, существующие в Компания |
| Контекстная переменная | переменные, хранящиеся в Чате и доступные для чтения и изменения системой по заложенной в Сценарий агента или Платформа логике |
| Контекст Чата | Весь набор контекстных переменных чата |
| Пользовательские контекстные переменные | переменные, которые определяются Диалог Дизайнером на определенных участках Сценарий агента, доступны всегда для редактирования в Сценарий агента. |
| Системная контекстная переменная | переменные создаваемые в Чате платформой для служебных целей и обеспечения работы Сценарий |
| Маппинг канальных переменных | Соотношение данных из входящего из Конечный канал в Коннектор запроса и Канальные переменные , доступных в сценарии - правило по которым значение из определенного key в body приходящего из мессенджера запроса по падет в переменную в сценарии |
| Канальные переменные | Переменные, доступные в Сценарий агента, получаемые с каждым сообщением, приходящим из Конечный канал, как правило содержат техническую или метаинформацию о собеседнике, чате, диалоге в Конечный канал (например логин пользователя в телеграме, id чата в мессенджере и пр) |
| Поддерживаемое Каналом Агента событие из Канала | Событие в Конечный канал, которое может быть обработано в Чате, например, Сообщение собеседника или Сервисные сообщения из каналов (присоединение оператора в чатплатформе, присоединение нового пользователя ТГ в группу и тд.) |
| Сценарий агента | Сценарий агента - логика работы Агента, включающая Дерево сценария, Настройки сценария агента, Используемые в Агенте Ресурсы Компании |
| Слот | визуальный элемент Сценарий агента в БотБилдере, содержащий действие Агента |
| Подслот | несамостоятельный Слот, является Комплексный слот: Потомок по отношению к Комплексный слот: Родитель, за которым он расположен |
| БотБилдер | инструмент для построения Сценарий агента |
| Правила соседства слотов | правила, согласно которым Слоты могут находиться рядом друг с другом в Дерево сценария |
| Входящий запрос | HTTP-запрос отправленный на REST API вебхук Агента с целью активации ветки сценария, следующей после Link, в определенном Чате данного агента |
| Обучение | Процесс проверки и конвертации визуального Сценарий в исполняемую\работающюю модель Агента (Обученная модель агента ) |
| Обученная модель агента | Скомпилированный программный код, созданный из Черновик сценария в процессе Обучение, который обеспечивает работу заложенной в Сценарий логики. Данную версию можно протестировать в Дебаг виджете и опубликовать для работы в Конечный канал (см. Публикация проекта и версии ) |
| Обучающая выборка | это фразы с одинаковым или близким смыслом, с помощью которых человек может высказать конкретное намерение (Интент), и на которых обучается модель NLU с целью распознавания (классификации) этих и всех прочих вариантов высказывания того же намерения (Интента) |
| Внешний запрос | REST HTTP запрос из Платформы (Чата ) во внешнюю систему |
| Ветка сценария | Участок сценария после разветвления одного из Комплексный слот: Родитель, либо слота Start |
| Состояние общения | Нахождения Агента на определенном Слоте (ноде в дереве сценария) Сценарий агента в Обученная модель агента в текущий момент времени. Изменение состояние общения - переход на другой Слот (ноду) сценария в процессе общения по инициативе Агенти или Собеседника |
| Открытие диалога | первое сообщение, событие Timer или Incoming Request в Чате при отсутствии в данный момент активного диалога в этом Чате. Первое сообщение в диалоге может быть как от Собеседника, так и от Агента, за исключение первого диалога в Чате, в этом случае первое сообщение может быть только от Собеседника (оно и создает Чат) |
| Закрытие диалога | системная отметка в БД (в аналитике) - факт окончания Диалога в Чате по определенному событию - Триггеру закрытия |
| Закрытие диалога по сценарию | |
| Закрытие диалога по сбросу чата | |
| Сброс Чатов | набор операций производимых системой над Чатами определенного Агента в результате действий пользователя - Триггер сброса чатов - над этим Агентом |
| Триггер закрытия диалога | событие, приводящее к установлению системной отметки “диалог закрыт” и временной отметки. |
| Триггер сброса чатов | |
| Таймаут неактивности | Настройка Агента — промежуток времени (в секундах), по истечении которого при отсутствии Событие в Чате происходит Закрытие диалога Значение по умолчанию для новых Агентов — 15 минут |
| Перевод общения на оператора | Событие сценария, при котором происходит Закрытие диалога и его последующий перевод на оператора через слоты Change Chat Mode или External Request (в зависимости от возможностей канала). |
| Активный диалог | |
| Состояние диалога | |
| Таблица связки чатов и каналов | |
| Активный чат | |
| Неактивный чат | |
| Таймер | |
| Триггер запуска таймера | |
| Заведенный таймер | |
| Запуск таймера | |
| Дополнительное условие запуска таймера | |
| Срабатывание таймера | |
| Активный канал | Активированный в настройках Агент Канал Проекта |
| Интент | Намерение Собеседника в сказанной Боту реплике, которое тот должен распознать. |
| Реплика | |
| Логическое выражение | Логическое выражениеー любая операция сравнения, проверка соответствия регулярному выражению в Condition или проверка на наличие переменной в контексте |
| Операнд | Аргумент логической операции |
| Валидация сценария | проверка при создании Обученная модель агента на то, что все требования системы к Агент удовлетворены. |
| Таблица диалогов | Таблица, содержащая список всех диалогов компании и метаинформацию по ним |
| Таблица реплик | Таблица, содержащая список всех Реплика компании и метаинформацию о них |
| Итоговый URL внешнего запроса | |
| Сообщение бота | |
| Сообщение собеседника | |
| Сервисные сообщения канала | технические сообщения, формируемые Конечный канал при каких-либо событиях в нем, сообщение попадает в client\_message в определенном формате, если включен проброс сервисных сообщений в настройках канала |
| Сбрасывать состояние общение | Опция, предназначенная для того, чтобы после завершения Диалога с Ботом новый Диалог начинался не того места, на котором остановилось Общение в прошлом Диалоге при завершении его по Таймаут неактивности, а с начала Сценарий |
| Threshold | это выраженное в процентах минимальное значение уверенности в распознанном намерении, при котором Интент считается распознанным, и Общение может перейти в его ветку (ветку под-слота intent). Значение может быть целым числом от 0 до 100. |
| Фоллбэк | |
| Точка сохранения | |
| Дерево сценария | |
| Групповой слот | |
| Канвас | |
| Родитель ветки сценария | Слот, с которого начинается определенная Ветка сценария |
| Debug-виджет | виджет в БотБилдере, позволяющий протестировать и отладить работу Проекта. |
| User Console | интерфейс Пользователя, фронтовое приложения для создания и управления Агентами и для ведения личного кабинета в целом |
| Панель информации об аккаунте | панель, на которой доступна для просмотра общая информация об Аккаунт пользователя и список доступных ему Компания. |
| Аккаунт пользователя | это учетная запись в Платформа, привязанная к адресу уникальному электронной почты пользователя как к уникальному идентификатору. |
| Основная компания | Созданная в Платформа при регистрации Аккаунт пользователя Компания, в которой пользователь является Владелец компании. |
| Панель настроек аккаунта и компании | это панель, на которой доступны просмотр и редактирование общей информации об аккаунте и Компания. |
| Владелец компании | Аккаунт пользователя, при регистрации которого была создана Компания. |
| Приглашенный пользователь | Зарегистрированный в системе Аккаунт пользователя, имеющий доступ в Компания, но не являющийся Владелец компании. |
| NLU трафик | |
| Скриптовый трафик | |
| Первоначальный тариф | |
| Подписка | доступ Пользователя к Платформа и функционирование Аккаунт пользователя в течение определенного периода с ограничениями согласно установленному для данной подписки тарифу Тарифу. |
| Расчетный период | период, в начале которого Счетчик трафика в расчетном периоде сбрасывается на ноль |
| Оплаченный период | непрерывный период, в течение которого полноценно доступны все возможности выбранного Платный тариф. |
| Тариф | совокупность условий доступа к функционалу Платформа и сервисам компании: стоимость, ограничения, возможности и пр. |
| Тарифный план | |
| Ключевой объект учета трафика | объект трафика, по которому введен Лимит трафика в расчетном периоде. |
| Лимит трафика в расчетном периоде | ограничения в Тарифе по трафику в Расчетный период при достижении которого наступает Блокировка Общения Агентов в Аккаунте. |
| Функциональные возможности тарифа | возможности и ограничения функционала Платформа, предусмотренные Тарифом. |
| Дата начала подписки | дата и время начала подписки |
| Окончание подписки | дата и время окончания подписки (не путать с окончанием Оплаченный период ) — устанавливается, когда начинается новая Подписка |
| Период подписки | |
| Бесплатный тариф | |
| Платный тариф | |
| Расчетная дата | дата обнуления Счетчик трафика в расчетном периоде, завершения одного и начала нового Расчетный период для данного Аккаунт пользователя |
| Расчетный период | период, в начале которого Счетчик трафика в расчетном периоде сбрасывается на ноль. |
| Счетчик трафика в расчетном периоде | механизм отслеживания достижения Лимит трафика в расчетном периоде — значение показателя на текущий момент времени. |
| Вторичные лимиты тарифа | количественные ограничения некоторых Функциональные возможности тарифа в Расчетный период, при достижении этих лимитов работа Агентов в Аккаунт пользователя не ограничивается. Например, количество Приглашенный пользователь, Лимиты. |
| Вторичные счетчики подписки | механизм отслеживания достижения Вторичные лимиты тарифа — значения достигнутых показателей на текущий момент времени |
| Блокировка Общения Агентов в Аккаунте | приостановка Общение всех Агентов в Компания, принадлежащей данному Аккаунт пользователя. |
| Пакет пополнения трафика | определенное количество трафика (см. Ключевые объекты тарификации) |
| Возобновление подписки | происходит, когда пользователь “возобновляет” Платная подписка с тем же Тариф после паузы, технически - это активация новой Подписка на том же Тарифе, после Блокировка Общения Агентов в Аккаунте по причине Завершение оплаченного периода |
| Неактивная подписка | |
| Активация подписки | начало работы Подписка по Тарифу |
| Пакет доступа | право использовать Платформа с возможностями и ограничениями определенного Платный тарифа в течение Расчетный период |
| Разблокировка Общения Агентов в Аккаунте | отмена блокировки Общение всех Агентов в Компания, принадлежащей данному Аккаунт пользователя. |
| Текущий расчетный период | |
| Актуализация подписки | периодическая задача, в процессе которой происходит следующее в указанном порядке:
- Проверка оплаты: Проверяется статус Оплаченный период
- Сбор статистики: Подсчет трафика всех Агентов в Компания с начала Текущий расчетный период до текущего момента
- Обновление Счетчик трафика в расчетном периоде;
- Проверка лимитов: Сравнение Счетчик трафика в расчетном периоде и Лимит трафика в расчетном периоде.
|
| Алерты подписки | |
| Баланс подписки | |
| Платежный провайдер | Внешний сервис, который обрабатывает платежи (Юкасса, PayPal и прочие) |
| Уведомление от провайдера об оплате | Событие, которое Платежный провайдер посылает в платформу при успешной транзакции (оплате) от клиента в пользу его аккаунта в платформе |
| Платная подписка | подписка на Платный тариф |
| Бесплатная подписка | подписка на Бесплатный тариф |
| Основная ветка | |
| Пачка сообщений | последовательно идущие сообщения Агента в Сценарий агента, собранные вместе для передачи в Коннектор, который отрвить сообщения в Конечный канал |
| Задержка отправки внешнего запроса | |
| Слот ожидания ввода | |
| Обучающая фраза | |
| Markdown | язык разметки текста, предназначенный для обозначения форматирования. |
| Реферальная ссылка | |
| Реферал | |
| Реферер | |
| Партнерский идентификатор | |
| Выражение | |
| Выражение с управляющей конструкцией | |
| Словарь | |
| Синоним | |
| Референс | |
| Сущность | |
| Шаблон | |
| Проверяемая строка | |
| Запрос на рассылку | |
| Идентификатор задачи на рассылку | Пример: "task\_id": "e7ec4e956b3e4619b9661e732f59e64b" |
| Задача на рассылку | |
| Идентификатор рассылки | |
| Технический статус рассылки | Статус рассылки (в т.ч. ошибки), полученный от конечного канала |
| Позитивное событие | |
| Негативное событие | |
| Очередь задач на рассылку | |
| Порог уверенности в определении языка | |
| Вебхук слота Incoming Request | |
| Очередь входящих запросов | |
| Количество итераций цикла | |
| Зарезервированные методы объектов | |
| Сброс состояния цикла | |
| Степень уверенности в определении языка | |
| Инициация цикла | |
| Новый уникальный собеседник | это собеседник с определенным идентификатором в конечном канале, с которым еще нет чата в Платформе. |
| Threshold | это выраженное в процентах минимальное значение уверенности в распознанном намерении, при котором Интент считается распознанным, и Общение может перейти в его ветку (ветку под-слота intent). |
| Подсистема отправки писем | |
| Идентификатор задачи на отправку письма | |
| Итоговый список получателей письма | |
| Комплексный слот | |
| Самостоятельный слот | |
| Родительский слот | |
| Дочерний слот | |
| Проект | Уникальный объект в Платформа — конфигурация Бота — сценарии работы и настройки. |
| Событие в Чате | Определенный набор действия, которые должны быть обработаны в Чате по сценарию: сообщения от Собеседника или Агента, таймеры, входящие и исходящие запросы и т.д,События в чатах и их приоритеты |
| Черновик сценария | Данная версия предназачена для непосредственного проектирования логики работы Агента в БотБилдере. Все изменения, вносимые диалог дизайнером в Дерево сценария в БотБилдере, вносятся как раз в Черновик сценария |
| Опубликованная версия агента | Версия Сценарий агента, созданная в момент Публикация Проекта путем копирования Обученная модель агента, отвечающая на сообщения Собеседника в Конечный канал (см. Публикация проекта и версии ) |
| Опубликованный проект | |
| Публикация Проекта | |
| Публикация Агента | |
| Канальный идентификатор собеседника | например номер телефона или другой внутренний идентификатор собеденика внутри Конечный канал |
| Подключенный к чату Агент | |
| Сценарий проекта | Совокупность Сценарий агента одного Проекта |
| Перехват состояния общения | |
| Стандартное движение по сценарию | |
| Очередь событий | |
| Диалоговый сервис | |
| Ресурсы Проекта | общие элементы, такие как Интенты, Словарь , Внешний запрос, доступные всем Агентам Проекта |
| Слот отправки пачки сообщений | |
| Язык NLU | |
| Очередь несрочных событий | |
| Очередь несрочных входящих запросов | |
| Очередь несрочных запросов на рассылку | |
| Оркестрация Агентов | |
| Data source | |