# Основные термины
| Термин | Определение |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Платформа | Система для создания, эксплуатации и управления чат-ботами. |
| Собеседник | Участник Общение с ботом. Может быть как живой человек, так и автоматическая система, имитирующая человека |
| Агент | Сценарий Проекта или его часть, отвечающая за определенную самодостаточную часть/логику. В конкретный момент времени в Активный чат работает конкретный Агент из подключенного в Чат Проекта — Подключенный к чату Агент |
| Бот | Виртуальный участник Общение в каналах коммуникаций (Конечные каналы и Коннекторы ) |
| Общение | Процесс обработки Событие в Чате
- Процесс обмена информацией между Собеседник и Агентом
- Наличие запросов\реплик Собеседника не обязательно, так же, как и отправка сообщений Агента собеседникам - общение может состоять только из технических событий, например, оправка запросов в цикле, таймеры, вычисления
|
| Конечный канал | Софт, в котором происходит Общение между Бот и Собеседник (мессенджеры, соцсети, омниканальные платформы и тд.) |
| Канал Проекта | Настройка Проекта - настроенное в платформе подключение Проекта к Конечный канал (мессенджер, соцсети, виджеты) |
| Коннектор | Функционал Платформа и набор правил, драйвер для подключения Агента в определенный Конечный канал |
| Универсальный коннектор | открытый 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 | |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://chatme-ai-4.gitbook.io/docs/kak-nachat-rabotu-s-platformoi/osnovnye-terminy.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.