Создание и типы Слотов и Подслотов

Типы Слотов

В каждом Слоте и Подслоте происходит действие, указанное в названии Слота. Из Слотов составляется Сценарий агента, который развивается слева направо, от одного Слота к другому.Существующие на данный момент типы Слотов отражены в таблице Типы слотов ниже.

Самостоятельные и комплексные слоты

Слоты делятся по признаку самостоятельности на две группы: Самостоятельный слот и Комплексный слот. Комплексный слоты состоят из одного Родительский слот и нескольких Дочерний слот (Подслотов). Комплексный слот позволяют разветвить Сценарий агента на две или более Ветка сценария в зависимости от выполнения тех или иных условий.Разделение Слотов по признаку самостоятельности отражено в таблице Типы слотов ниже.

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

Размещение Слотов в Дерево сценария подчиняется определенным правилам, т.к. не все Слоты могут находиться рядом согласно логике, к примеру:

• Слоты Incoming Request и Timer могут находиться только после Слота Start, поскольку они стартуют общение Агента с Собеседником;

• Дочерний слоты могут находиться только после соответствующих Родительский слотов;

• Два Слота Wait For Reaction не могут стоять рядом

• и так далее.

При добавлении Слота в любое место Сценарий агента в выпадающем списке на выбор предлагаются только те Слоты, которые могут находиться в данном месте согласно Правила соседства слотов.Правила соседства слотов отражены в таблице Типы слотов ниже.

Возможные соседи слева	Тип слота	Возможные соседи справа	Описание	Самостоятельность слота
	Start	NLU,Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,Incoming Request,Timer,Change Chat Mode,Synonym,Notification	Стартовый/корневой слот, с которого начинается Сценарий. Работает аналогично слоту Wait For Reaction, принимая сообщения Собеседника.Основная статья: Начало Сценария | Слот Start	Самостоятельный слот
Start	Incoming Request	NLU,Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,Change Chat Mode,Synonym	Слот Incoming Request позволяет Агенту писать первым в Чат Собеседнику при закрытых Диалогах.Основная статья: Рассылки и уведомления | Слот Incoming Request	Самостоятельный слот
Start	Timer	NLU,Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,Change Chat Mode,Synonym	Слот Timer предназначен для запуска Сценарий Агента по истечение заданного времени после наступления определенных условий в конкретном Чате.Основная статья: Запуск сценария по таймеру | Слот Timer	Самостоятельный слот
Text,Wait For Reaction,Attachment,Memory,External Request,Slot Filling,Start,intent,fallback,button,condition,result,Incoming Request,Timer,Synonym,Notification fail,Notification no account,Notification success	NLU	intent,fallback	Слот NLU предназначен для обработки реплик на естественном языке с целью определить высказанное намерение (Интент) Собеседника и в зависимости от него выполнить переход в соответствующую Ветка сценария.Основная статья: Распознавание намерений | Слот NLU и под-слоты Intent и Fallback	Комплексный слот: родительский слот
Wait For Reaction,Attachment,Memory,External Request,Slot Filling,Start,intent,fallback,button,condition,result,Text,Incoming Request,Timer,Notification fail,Notification no account,Notification success	Text	Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Change Chat Mode,Synonym	Слот Text позволяет выводить на экран Собеседника текстовое сообщение, содержащееся в поле TEXT LIST этого Слота.Основная статья: Текстовые ответы бота | Слот Text	Самостоятельный слот
Start,Text,Attachment,Memory,External Request,result,condition,button,fallback,intent,Incoming Request,Timer,Synonym,Notification fail,Notification no account,Notification success	Wait For Reaction	Text,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Change Chat Mode,Synonym	Слот Wait For Reaction переводит Агента в режим ожидания сообщения отСобеседника и сохраняет полученное сообщение в Контекстная переменная client_messageОсновная статья: Ожидание сообщения Собеседника | Слот Wait for reaction	Самостоятельный слот
Incoming Request,Timer,Text,Wait For Reaction,Attachment,Memory,External Request,Slot Filling,result,condition,button,fallback,intent,Start,Synonym,Notification fail,Notification no account,Notification success	Jump		Слот Jump позволяет осуществить переход в другой слот Сценарий.Основная статья: Переходы к произвольным шагам сценария | Слот Jump	Самостоятельный слот
Wait For Reaction,Attachment,Memory,External Request,Slot Filling,Start,intent,fallback,button,condition,result,Text,Incoming Request,Timer,Synonym,Notification fail,Notification success,Notification no account	Attachment	Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Change Chat Mode,Synonym	Слот Attachment предназначен для отправки файлов-вложений указанного типа от Агента Собеседнику. Например, с помощью этого слота можно отправить Собеседнику аудио, видео или изображение, которое отобразится корректно в мессенджере с предпросмотром.Основная статья: Отправка файлов Собеседнику | Слот Attachment	Самостоятельный слот
Wait For Reaction,Attachment,Memory,External Request,Slot Filling,Start,intent,fallback,button,condition,result,Text,Incoming Request,Timer,Synonym,Notification fail,Notification no account,Notification success	Memory	Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Change Chat Mode,Synonym	Слот Memory позволяет записывать данные в Пользовательские контекстные переменные.Основная статья: Создание и сохранение переменных контекста | Слот Memory	Самостоятельный слот
Wait For Reaction,Attachment,Memory,External Request,Slot Filling,Start,intent,fallback,button,condition,result,Text,Incoming Request,Timer,Synonym,Notification fail,Notification no account,Notification success	Language	Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Change Chat Mode	Слот Language позволяет определить язык из входящей строки.Основная статья: Слот распознавания языка | Слот Language	Самостоятельный слот
Wait For Reaction,Attachment,Memory,External Request,Slot Filling,Start,intent,fallback,button,condition,result,Text,Timer,Incoming Request,Synonym,Notification fail,Notification no account,Notification success	External Request	Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Change Chat Mode,Synonyme,Synonym	Слот External Request предназначен для интеграции Агента c внешними ИТ системами по протоколу HTTP. При обработке данного слота в Сценарий происходит выполнения HTTP-запроса к API внешней системы, а также получение и обработка ответа на этот запрос.Основная статья: Запросы во внешние системы | Слот External Request	Самостоятельный слот
Wait For Reaction,Attachment,Memory,External Request,Slot Filling,Start,intent,fallback,button,condition,result,Text,Timer,Incoming Request,Synonym,Notification fail,Notification no account,Notification success	Slot Filling	Text,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Change Chat Mode,Synonym	Слот Slot Filling позволяет собрать ответы Собеседника на конкретные вопросы и сохранить эти ответы в Пользовательские контекстные переменные. В отличие от связки “Text - Wait For Reaction — Memory“, Slot Filling позволяет собрать несколько ответов Собеседника на несколько вопросов Агента используя только один слот.Основная статья: Сбор данных от собеседника | Слот Slot Filling	Самостоятельный слот
Wait For Reaction,Attachment,Memory,External Request,Slot Filling,Start,intent,fallback,button,condition,result,Text,Timer,Incoming Request,Synonym,Notification fail,Notification no account,Notification success	Button Menu	button,fallback	Слот Button Menu объявляет блок кнопок button, которые определяются после этого Слота.Основная статья: Использование кнопок в сообщениях бота | Слот Button Menu и под-слот Button	Комплексный слот: родительский слот
Wait For Reaction,Attachment,Memory,External Request,Slot Filling,Start,intent,fallback,button,condition,result,Text,Timer,Incoming Request,Synonym,Notification fail,Notification no account,Notification success	Transition Rule	condition	Слот Transition Rule позволяет делать разветвления Сценарий Агента в зависимости от указанных условий.Основная статья: Разветвление сценария в зависимости от условий | Слот Transition Rule и под-слот Condition	Комплексный слот: родительский слот
Wait For Reaction,Attachment,Memory,External Request,Slot Filling,Start,intent,fallback,button,condition,result,Text,Timer,Incoming Request,Synonym,Notification fail,Notification no account,Notification success	Regular Expression	result	Слот Regular Expression позволяет проверить введенное Собеседником сообщение на соответствие формату, заданному посредством регулярного выражения, и в зависимости от соответствия выполнить переход в соответствующую Ветка сценария.Основная статья: Проверка формата введенных собеседником данных | Слот Regular Expression и под-слот Result	Комплексный слот: родительский слот
Start,Incoming Request,Text,Wait For Reaction,Attachment,Memory,External Request,Slot Filling,result,condition,button,fallback,intent,Timer,Synonym,Notification fail,Notification no account,Notification success	Change Chat Mode		Слот Change Chat Mode предназначен для перевода Диалога на оператора, если омниканальная платформа предоставляет операторский софт. При этом Диалог завершается. Для омниканальных платформ, не предоставляющих операторский софт, произойдет только закрытие Диалога.Основная статья: Перевод диалога на оператора | Слот Change Chat Mode	Самостоятельный слот
Regular Expression	result	Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Change Chat Mode,Synonym	Дочерний слот в Комплексный слот Regular Expression + result, в который переходит Агент в том случае, если результат проверки сообщения Собеседника на регулярное выражение соответствует содержанию Подслота.Основная статья: Проверка формата введенных собеседником данных | Слот Regular Expression и под-слот Result	Комплексный слот: дочерний слот
Transition Rule	condition	Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Change Chat Mode,Synonym	Дочерний слот в Комплексный слот Transition Rule + condition, который содержит в себе условие, при значении true которого, Агент перейдет в Ветка сценария, идущую после этого Подслота condition. Основная статья: Разветвление сценария в зависимости от условий | Слот Transition Rule и под-слот Condition	Комплексный слот: дочерний слот
Button Menu	button	Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Change Chat Mode,Synonym	Дочерний слот в Комплексный слот Button Menu + button + fallback, в который переходит Агент в том случае, если Собеседником была нажата одна из кнопок, выведенных на экран.Основная статья: Использование кнопок в сообщениях бота | Слот Button Menu и под-слот Button	Комплексный слот: дочерний слот
Button Menu,NLU	fallback	Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Change Chat Mode,Synonym	В NLU: Дочерний слот в Комплексный слот NLU + intent + fallback, в который переходит Агент в том случае, если ни один Интент не распознан с достаточной долей уверенности.В Button Menu: Дочерний слот в Комплексный слот Button Menu + button + fallback, в который переходит Агент в том случае, если Собеседником не была нажата ни одна кнопка.Основные статьи: Распознавание намерений | Слот NLU и под-слоты Intent и Fallback Использование кнопок в сообщениях бота | Слот Button Menu и под-слот Button	Комплексный слот: дочерний слот
NLU	intent	Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Change Chat Mode,Synonym	Дочерний слот в Комплексный слот NLU + intent + fallback, в который переходит Агент в том случае, если Реплика Собеседника была отнесена (распознана) Слотом NLU к соответствующему ему Интенту.Основная статья: Распознавание намерений | Слот NLU и под-слоты Intent и Fallback	Комплексный слот: дочерний слот
Start,Incoming Request,Timer,Text,Wait For Reaction,Attachment,Memory,External Request,Slot Filling,result,condition,button,fallback,intent,Synonym,Notification fail,Notification no account,Notification success	Synonym	NLU,Text,Wait For Reaction,Jump,Button Menu,External Request,Regular Expression,Memory,Slot Filling,Transition Rule,Synonym,Attachment,Change Chat Mode	Слот Synonym позволяет совершать поиск по таблице с данными — Словарь — и сохранять найденную информацию в Контекстная переменная.Основная статья: Распознавание сущностей | Слот Synonym	Самостоятельный слот
Start	Notification	Notification fail,Notification no account,Notification success	Слот Notification предназначен для отправки рассылочных сообщений. Слот позволяет отправить сообщение в случае, когда Чат с Собеседником еще не создан (нет chat_id ), или Чат создан, но Агенту нельзя писать в Чат первым после определенного таймаута (ограничение некоторых каналов). Слот позволяет обработать статусы, пришедшие в ответ на рассылочное сообщение.Основная статья: Рассылки в WhatsApp| Слот Notification	Комплексный слот: родительский слот
Notification	Notification fail	NLU,Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,Change Chat Mode,Synonym	Подслот Notification fail предназначен для продолжения Сценарий, если не удалось отправить рассылку в Конечный канал.Основная статья: Рассылки в WhatsApp| Слот Notification	Комплексный слот: дочерний слот
Notification	Notification no account	NLU,Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,Change Chat Mode,Synonym	Подслот Notification no account предназначен для продолжения Сценарий после рассылки, которая была успешно отправлена в Конечный канал, но Конечный канал сообщил, что получатель не найден (например, у получателя нет аккаунта WhatsApp при рассылках через Whatsapp (360dialog)).Основная статья: Рассылки в WhatsApp| Слот Notification	Комплексный слот: дочерний слот
Notification	Notification success	NLU,Text,Wait For Reaction,Jump,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,Change Chat Mode,Synonym	Подслот Notification success предназначен для продолжения Сценарий после рассылки, которая была успешно отправлена в Конечный канал и был получен успешный статус либо ответ Собеседника.Основная статья: Рассылки в WhatsApp| Слот Notification	Комплексный слот: дочерний слот
Start,Incoming Request,Timer,Text,Wait For Reaction,Attachment,Memory,External Request,Slot Filling,result,condition,button,fallback,intent,Synonym,Notification fail,Notification no account,Notification success	Repeat	Repeat Next,Repeat End,Repeat Error,Repeat Limit	Слот Repeat запускает цикл из N итераций, N задается в настройках слота. Каждая итерация начинается с перехода в слот Repeat Next.Основная статья: Реализация циклов в сценарии | Слот Repeat	Комплексный слот: родительский слот
Repeat	Repeat Next	Text,Wait For Reaction,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Synonym,Change Chat Mode	Подслот Repeat Next начинает очередную итерацию цикла, увеличивая счетчик цикла на 1Основная статья: Реализация циклов в сценарии | Слот Repeat	Комплексный слот: дочерний слот
Repeat	Repeat End	Text,Wait For Reaction,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Synonym,Change Chat Mode	Подслот Repeat End предназначен для продолжения сценария, когда закончился цикл — выполнено установленное количество итераций, а также для выхода из цикла, если в процессе его выполнения поступило сообщение Собеседника, а в цикле нет Слота, который может его обработать.Основная статья: Реализация циклов в сценарии | Слот Repeat	Комплексный слот: дочерний слот
Repeat	Repeat Error	Text,Wait For Reaction,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Synonym,Change Chat Mode	Подслот Repeat Error предназначен для ошибки выполнения цикла — перехода из Repeat, когда установили невалидное количество итераций (строку).Основная статья: Реализация циклов в сценарии | Слот Repeat	Комплексный слот: дочерний слот
Repeat	Repeat Limit	Text,Wait For Reaction,Attachment,Memory,External Request,Slot Filling,Button Menu,Transition Rule,Regular Expression,NLU,Synonym,Change Chat Mode	Подслот Repeat Limit предназначен для выхода из цикла при достижении Лимит на количество итераций цикла одного слота Repeat или Лимит на количество итераций цикла в минуту на компанию Основная статья: Реализация циклов в сценарии | Слот Repeat	Комплексный слот: дочерний слот

Создание Слота

1. Выберите Ветка сценария, в которой нужно создать Слот.

2. Нажмите + для того, чтобы добавить Слот — такая кнопка отображается везде, где возможно добавить Слот.
3. Выберите подходящий тип Слота из выпадающего списка. В выпадающем списке предлагаются только те Слоты, которые могут находиться в данном месте Сценарий агента согласно Правила соседства слотов.

Удаление Слотов

Удаление отдельного Слота

1. Для того чтобы удалить отдельный Слот, необходимо нажать правой кнопкой мыши по нужному Слоту и в выпадающем меню выбрать функцию Remove slot.
2. После нажатия кнопки появится модальное окно для подтверждения действия:
3. Нажмите кнопку OK, чтобы подтвердить удаление, и кнопку Cancel, чтобы отменить удаление.

4. Если для удаления выбран Слот, на который ссылается Слот Jump, то после нажатия кнопки появится модальное окно:
5. • В таком случае, необходимо будет найти Слоты Jump, ссылающиеся на удаляемый Слот, и изменить поле Destination в этих Слотах, либо же удалить сами Слоты Jump. Для этого в модальном окне находится кнопка SHOW THESE JUMPS, по нажатию которой происходит расширенный поиск перечисленных в модальном окне Слотов.

6. Для некоторых Слотов недоступна функция удаления. В выпадающих меню таких Слотов кнопка Remove slot недоступна для нажатия. Невозможно отдельно удалить:

7. 1. Слоты, расположенные между такими Слотами, которые не могут находиться рядом согласно правилам соседства Слотов;

   2. Комплексный слоты: как Родительский слоты, так и Дочерний слоты.

Удаление ветки Сценария

1. Для того чтобы удалить всю Ветка сценария, идущую за определенным Слотом, необходимо нажать правой кнопкой мыши по этому Слоту и в выпадающем меню выбрать функцию Remove branch.
2. После нажатия кнопки появится модальное окно для подтверждения действия:
3. Нажмите кнопку OK, чтобы подтвердить удаление, и кнопку Cancel, чтобы отменить удаление.

4. Кнопка Remove branch всегда доступна для нажатия, однако выполнить удаление Ветка сценария возможно только в следующих случаях:

5. 1. Возможно удалить Ветка сценария, следующие за любыми Самостоятельный слотами и любыми Родительский слотами;

   2. Возможно удалить Ветка сценария, следующие за созданными вручную Подслотами result (подробнее в статье Проверка формата введенных собеседником данных | Слот Regular Expression и под-слот Result);
   3. Возможно удалить Ветка сценария, следующие за любыми Подслотами button, при условии что после удаления у Button Menu останется хотя бы один Подслот button (подробнее в статье Использование кнопок в сообщениях бота | Слот Button Menu и под-слот Button);
   4. Возможно удалить Ветка сценария, следующие за любыми Подслотами condition, кроме Подслота со значением true, при условии что после удаления у Transition Rule останется не менее двух Подслотов condition (подробнее в статье Разветвление сценария в зависимости от условий | Слот Transition Rule и под-слот Condition).
   5. Возможно удалить Ветка сценария, следующие за любыми Подслотами intent, если после удаления у NLU останется не менее двух Подслотов intent (подробнее в статье Распознавание намерений | Слот NLU и под-слоты Intent и Fallback).
   6. Возможно удалить Ветка сценария, если ни на один Слот в ее составе не ссылается Слот Jump. Иначе после нажатия кнопки появится модальное окно:
   7. • В таком случае, необходимо будет найти Слоты Jump, ссылающиеся на удаляемый Слот, и изменить поле Destination в этих Слотах, либо же удалить сами Слоты Jump. Для этого в модальном окне находится кнопка SHOW THESE JUMPS, по нажатию которой происходит расширенный поиск перечисленных в модальном окне Слотов.

6. В случаях, помимо вышеперечисленных, при попытке удаления Ветка сценария появится следующая ошибка по центру снизу: