Создание услуги Робота Макса

Оглавление

• Создание услуги
• Воспроизведение и тестирование услуги
• Экспертиза услуги
• Публикация услуги
• Эксплуатация услуги

Общая информация

Робот Макс — цифровой ассистент на Госуслугах, который консультирует пользователей портала и оказывает услуги напрямую в диалоге с пользователем. Переход к оказанию услуги в диалоге осуществляется в тот момент, когда пользователь среди перечисленных помощником вариантов ответа выбирает тот, который запускает услугу. Например, при поиске информации о записи в МВД Робот Макс предлагает пользователю варианты, которые могут быть связаны с его запросом. Кнопка «Записаться на приём» - вариант ответа, который запускает оказание услуги 

Чтобы Робот Макс умел оказывать услугу в диалоговом режиме, сценарий оказания этой услуги нужно настроить в ВКУ. Для оказания в диалоговом режиме рекомендуется настраивать магистральные сценарии несложных услуг, такие как запись в МВД или получение выписки из ЕГРН

Перед проектированием услуги Робота Макса ознакомьтесь с перечисленными ниже материалами:

1. Принципы работы с шаблонами экранов
2. Критерии качества услуги
3. Примеры экранов в услуге Робота Макса
4. Редакционная политика Робота Макса
5. Компоненты и экраны ВКУ для Робота Макса

Создание услуги

Услуга может существовать в виде формы на портале и диалогового сценария в Роботе Максе. Если услуга в виде формы уже доступна на портале, добавьте её в Робота Макса. Если услуги на портале нет, то сначала нужно создать её в визуальном конструкторе услуг (ВКУ)

Услуги нет на портале:

1. Перейдите в ВКУ и войдите под учётной записью сотрудника организации 
2. В каталоге услуги нажмите «Добавить» , чтобы добавить новую услугу
3. В окне «Добавление услуги» на вопрос «Услуга уже зарегистрирована на ЕПГУ?» выберите «Нет»  
4. В окне с настройками укажите: название услуги (будет отображаться в интерфейсе ВКУ) и описание услуги (будет видно при открытии её настроек)
5. Далее выберите команду «Ведомство» и услугу, если хотите создать новую на базе имеющейся 
6. На открывшейся странице с настройками услуги перейдите в «Каталог». Подробнее о разделе можно ознакомиться в статье
7. Заполните все обязательные поля и нажмите «Сохранить» 
8. Нажмите «Назад», появится страница для добавления услуги в Роботе Максе
9. Переключите вид услуги со значения «Стандартная услуга» на «Услуга Робота Макса» и подтвердите создание услуги

Услуга есть на портале:

1. Выберите услугу из списка в каталоге услуг
2. На странице выбранной услуги переключите вид услуги со значения «Стандартная услуга» на «Услуга Робота Макса»
3. Подтвердите создание услуги в Роботе Максе

Добавление экранов и компонентов

1. В окне создания услуги слева добавьте первый экран в услугу, нажав на «+»



2. В открывшемся окне выберите экран, который подходит для вашего компонента. Проверить их совместимость можно в разделе «Компоненты и экраны»
3. В появившейся правой панели в разделе «Компоненты» нажмите «+» и добавьте компонент. На один экран можно добавить несколько компонентов, если тип экрана и совместимость компонентов это позволяет. Подробнее о поддержке нескольких компонентов
4. В разделе «Кнопки» нажмите «+» и добавьте их. При добавлении кнопок нужно вручную настроить логику перехода к следующим экранам или назад
5. В разделе «Правила» нажмите «+» и добавьте правила перехода между двумя и более экранами услуги. Подробнее о правилах перехода можно прочитать в статье

Воспроизведение и тестирование услуги

Работать в ВКУ можно только под учётной записью сотрудника организации. Поэтому после авторизации роль сотрудника сохраняется и на портале. Чтобы протестировать услугу, следует зайти под другой учетной записью. Для удобства можно использовать два браузера или разные окна «Основная сессия» и «Инкогнито»: в одном создавать услугу, а в другом тестировать её

Проверка услуги на наличие ошибок

Чтобы проверить услугу на наличие ошибок, ее нужно воспроизвести. Для этого:

1. Перейдите в "Действия" и выберите "Воспроизвести"
2. Укажите тестовый стенд SVCDEV
3. Нажмите "Воспроизвести"

Если ошибок нет, в левом нижнем углу экрана появится сообщение об успешном воспроизведении услуги на SVCDEV. Если услуга содержит ошибки, то они появятся в красном окне. Исправьте ошибки и повторите воспроизведение услуги

Тестирование услуги

1. Перейдите на SVCDEV и войдите под тестовой учётной записью
2. Нажмите на ссылку из окна, которое появится при воспроизведении услуги, она скопируется
3. Вставьте ссылку в строку браузера. Откроется интерфейс Робота Макса с созданной услугой, в котором автоматически отправится запрос с ключевым словом daserviceplayer_********, где ******** это serviceCode созданной услуги
   

   

4. Пройдите все сценарии услуги, чтобы заметить возможные ошибки. Если появились трудности, напишите на электронную почту support@pro.gosuslugi.ru

На этапе тестирования веб-версии проверьте отображение услуги на мобильных устройствах, правила описаны в разделе «Поддержка адаптивности». Протестировать услугу желательно в нескольких браузерах и платформах:

• веб - Chrome, Яндекс Браузер
• iOS - Safari
• Android - Chrome

Экспертиза услуги

После тестирования услуги отправьте её на экспертизу в соответствии с пунктом 3.3 Технических Требований. В описании заявки дополнительно укажите наличие услуги Робота Макса

В чек-листе самопроверки, прикладываемом к заявке, укажите:

• наличие услуги Робота Макса
• кто и в каких ситуациях будет получать данную услугу
• охват аудитории у услуги, которую планируете вывести
• контактные данные ответственного от ведомства: телеграм или номера телефона

Если стандартная услуга ранее успешно прошла экспертизу, в чек-листе самопроверки в поле «Список изменений» укажите «Добавлена услуга Робота Макса» и остальные изменения в стандартной услуге, если они есть

Публикация услуги

После успешной проверки услуги, её можно выводить в продуктивную среду. Процесс вывода услуги Робота Макса аналогичен процессу выводу стандартной услуги из ВКУ

При первичном выводе стандартной услуги и услуги Робота Макса необходимо направить письмо в Минцифры России (п. 3.6 ТТ). Если стандартная услуга уже размещена в продуктивной среде ЕПГУ, а услуга Робота Макса нет, необходимо направить заявку в СЦ по процессу обновления услуги (п. 3.7 ТТ). При выводе в продуктивную среду услуги Робота Макса также будет выведена в прод/обновлена стандартная портальная услуга той же версии. Поэтому перед публикацией услуги Робота Макса проверьте, что портальная услуга является работоспособной

Чтобы услуга стала доступна пользователям, командой Робота Макса будет создан квиз - ответ Робота Макса с вариантами для выбора, один из которых служит точкой входа в услугу. Квиз направляется по мере вывода услуги в продуктивную среду в ответ на заявку

Эксплуатация услуги

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

Что передать для мониторинга услуги:

1. Идентификатор услуги в Роботе Максе serviceCode услуги в формате 600*****, отображается в адресной строке браузера в ВКУ
2. Код получения услуги daserviceplayer_600*****, в адресной строке браузера в ВКУ
3. Идентификатор начального экрана услуги в экране услуги в ВКУ, с флажком в поле «Признак первого экрана»
4. Идентификатор финального экрана услуги в экране услуги в ВКУ, с флажком в поле «Признак последнего экрана»
5. Идентификатор ошибочного экрана в экране услуги ВКУ для отображения ошибки

Доступные метрики:

• Процент дизлайков позволяет определить, какие шаги услуги вызывают недовольство
• Конверсия на финальном экране доля аудитории, которая получила услугу
• Распределение аудитории по экранам помогает выявить проблемные шаги услуги, с которых уходят пользователи