Добавление формы¶

Добавление формы¶

Содержание инструкции:

• Шаг 1. Создание формы
• Шаг 2. Настройка формы
• Шаг 3. Добавление слота в форму
• Шаг 4. Настройка извлечения ответа в форме
• Шаг 5. Настройка валидации ответа в форме
• Шаг 6. Добавление условия для перехода к следующему ответу в форме
• Шаг 7. Добавление формы в историю
• Дополнение. Описание типов условий

Шаг 1. Создание формы¶

Чтобы создать форму:

1. Откройте Wisebot и убедитесь, что настраиваете нужного бота. В боковом меню должно отображаться его имя.

   

2. Откройте раздел Диалоги.

3. Наведите курсор на панель с группой, в которой необходимо создать форму.
4. Отобразятся кнопки действий с группой.

5. Нажмите на кнопку и выберите действие Форма.

   

   Созданная форма отобразится в группе.

   

Шаг 2. Настройка формы¶

1. Откройте созданную форму.
2. Нажмите на первый блок Начало формы.

3. В появившемся окне Настройки формы укажите:

   • Текстовое описание формы в поле Описание,

   • Активируйте переключатель Разрешить контекстные дополнительные вопросы.

     Эта настройка позволит боту принимать и обрабатывать дополнительные вопросы от пользователя в процессе заполнения формы, не прерывая сам процесс заполнения.

   • Активируйте переключатель Собирать в Wisebot.

     Эта функция позволяет системе сохранять информацию, полученную с помощью форм, чтобы потом её можно было экспортировать.

   

Шаг 3. Добавление слота в форму¶

Чтобы добавить слот в форму:

1. Откройте созданную форму.

2. Нажмите на кнопку Добавить в нижней части блока Начало формы.

   

3. Выберите действие Добавить вопрос для создания нового слота или выбора уже созданного.

   Укажите имя слота и нажмите Enter.

   Слот будет создан без назначения типа (text, boolean, float и т.д.). Если необходимо выбрать слот с определённым типом, создайте его в разделе Cлоты, а затем выберите его по кнопке Использовать существующий. Подробнее о создании слотов читайте в инструкции.

   

   Примечание

   Действие Установить слот используется для завершения работы формы.

   Добавляется системный слот requested_slot: null. Слот requested_slot хранит имя слота, запрашиваемого у пользователя в данный момент. Значение null означает, что форма в данный момент не запрашивает у пользователя данные для какого-либо слота.

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

   

Чтобы удалить добавленный блок со слотом, нажмите на блок. Откроется окно с настройками слота. В нижней части окна нажмите на Удалить этот слот и подтвердите действие в модальном окне.

Шаг 4. Настройка извлечения ответа в форме¶

По умолчанию весь ответ пользователя сохраняется в слоте. Для каждого слота можно определить, как данные будут извлекаться из пользовательского ввода.

Чтобы настроить способ извлечения данных:

1. Откройте форму.
2. Нажмите на блок с вопросом бота.
3. Откроется окно с настройками способа извлечения и валидации.

4. На вкладке Извлечение выберите способ извлечения данных:

   • Из сообщения пользователя для сохранения текста, введенного пользователем.
   • В зависимости от намерения для сохранения значения в логические слоты (Boolean Slot), которые принимают значения true или false.
   • Из сущности для извлечения выбранной сущности.

   

Чтобы повысить надёжность извлечения, можно использовать несколько методов одновременно. Например, сначала можно проверить наличие конкретной сущности, а если её нет, то использовать весь ответ или определённое намерение.

Чтобы удалить настроенный способ извлечения, нажмите на кнопку Удалить , расположенную на панели со способом.

Шаг 5. Настройка валидации ответа в форме¶

Валидация необходима для проверки корректности данных, предоставленных пользователем, перед их сохранением в слот. Доступна настройка условий валидации и вывод сообщения об ошибке.

Чтобы настроить валидацию в форме:

1. Откройте форму.
2. Нажмите на блок с вопросом бота.
3. Откроется окно с настройками способа извлечения и валидации.

4. Перейдите на вкладку Валидация.

   

5. Активируйте переключатель Проверить слот.

   Настройка проверяет, соответствуют ли данные, введенные пользователем, определённым критериям. Если данные не проходят проверку, бот может отправить пользователю сообщение с просьбой ввести их снова. В случае успешной проверки, данные сохраняются в соответствующем слоте.

   • Укажите тип условия и значение. Типы условий описаны таблице.
   • В поле Введите сообщение укажите ответ помощника, который будет выведен пользователю, если валидация не пройдена. По умолчанию фразе помощника присваивается тип Текстовое сообщение. Для изменения типа нажмите на Изменить тип ответа. Подробнее про типы читайте в инструкции.

6. Активируйте переключатель Отображать сообщение, когда слот установлен и корректен.

   Настройка отвечает за отправку пользователю подтверждающего сообщения после успешного заполнения и валидации слота. Это сообщение информирует пользователя о том, что его данные были приняты и сохранены.

   • В поле Введите сообщение укажите ответ помощника, который будет выведен пользователю, если валидация пройдена. По умолчанию фразе помощника присваивается тип Текстовое сообщение. Для изменения типа нажмите на Изменить тип ответа. Подробнее про типы читайте в инструкции.

Валидация добавляется автоматически без дополнительного подтверждения.

Шаг 6. Добавление условия для перехода к следующему ответу в форме¶

Чтобы добавить условие:

1. Откройте форму.
2. Наведите курсор на стрелку, которая ведёт к блоку или от блока с вопросом помощника, для которого необходимо добавить условие.

3. Нажмите на появившуюся кнопку .

   

4. Откроется форма добавления условия.

   

5. Нажмите на кнопку:

   • Добавить правило для добавления условия,
   • Добавить группу для добавления группы условий.

6. Укажите логический оператор: и/или, не.

   

7. Выберите сущность, для которой небходимо настроить условие.

8. Выберите тип условия и укажите его значение. Типы условий описаны таблице.

Условие добавляется автоматически без дополнительного подтверждения. На связи между блоками отображается кнопка , обозначающая, что для перехода к следующему шагу в блоке задано условие.

Чтобы удалить конкретное условие, нажмите на кнопку Удалить , расположенную на панели с условием.

Чтобы удалить группу, нажмите на кнопку Удалить , размещенную рядом с кнопкой добавления группы.

Чтобы удалить все условия, нажмите на кнопку Удалить все условия, размещенную в нижней части формы.

Шаг 7. Добавление формы в историю¶

Чтобы добавить форму в историю:

1. Откройте историю, в которую необходимо добавить форму.

2. Добавьте форму одним из способов:

   • Наведите курсор в область редактора истории. Выберите появившуюся кнопку Цикл. В этом случае форма будет добавлена в конце диалога.
   • Если необходимо добавить форму в начале или в середине диалога, наведите курсор это место. Появится кнопка . Нажмите на кнопку и выберите вариант: Цикл.

3. В выпадающем меню выберите действие Активировать цикл и укажите форму, которую необходимо добавить.

   

4. Выбранная форма отобразится в истории.

   

5. После цикла с активацией формы добавьте цикл с завершением формы. Выберите Цикл → Нет активного цикла.

   

Далее обучите и протестируйте помощника для того, чтобы убедиться, что он отвечает правильно.

Чтобы удалить форму из истории нажмите на кнопку Удалить , размещенную на панели с формой. Форма удаляется автоматически без подтверждения.

Дополнение. Описание типов условий¶