Graph экспортирует проект в виде zip-архива с файлами проекта Code.
Архив с проектом можно импортировать как в Graph, так и в Code.
Сценарии проектов Graph размечены с помощью мета-тегов. Для корректной работы проектов в Code, теги требуется удалить.
Экспорт проекта
Чтобы экспортировать проект:
- Выберите проект в личном кабинете.
- Перейдите в раздел Настройки.
- Выберите вкладку Экспорт / Импорт.
- Нажмите кнопку Экспорт проекта.
Браузер загрузит zip-архив проекта.
Импорт проекта
Перед импортом убедитесь, что структура проекта соответствует стандартной, а все необходимые файлы и папки упакованы непосредственно в архив.
Обратите внимание: при импорте проекта происходит сброс текущей обученной модели классификатора на модель Brain, поэтому после завершения импорта рекомендуются обязательно пересобрать сценарий или запустить тестирование в разделе Интенты или Сущности.
Размер архива импортируемого проекта должен быть меньше 260 Мб.
При импортировании в сущеcтвующий проект он заменяется на импортируемый.
Чтобы импортировать проект:
- Создайте новый проект.
- Перейдите в раздел Разработка → Настройки чат-бота.
- Выберите вкладку Экспорт / Импорт.
- Выполните одно из действий:
- перетащите zip-архив с проектом в область Импорт проекта;
- нажмите на область Прикрепите файл или перетащите его сюда и выберите архив на компьютере.
Файлы будут импортированы в проект.
Работа с проектами Graph в Code
Если вы изначально создали свой сценарий в Graph, а потом решили его расширить его возможности через разработку, возможно сохранить проект Graph и импортировать его в Code. Обратите внимание, что в этом случае часть конструкций будет работать по-другому.
Работа с кодом из Graph усложняется тем, что в нем есть вспомогательные конструкции, которые нужны визуальному редактору, но не нужны в Code.
В этом разделе приведен список вспомогательных конструкций, которые можно встретить в сценарии, если открыть в Code проект из Graph.
Мета-теги
Мета-теги необходимы Graph для построения некоторых блоков.
Описание блока в сценарии включает мета-тег и содержание блока в фигурных скобках:
@InputText
{
"boundsTo" : "/newNode_0",
"actions" : [
{
"type" : "buttons",
"buttons" : [
{
"name" : "Акции",
"transition" : ""
},
{
"name" : "Перейти на сайт",
"transition" : "",
"url" : "https://mysite.com/home"
}
]
}
],
"prompt" : "Введите текст",
"varName" : "text",
"then" : "/newNode_13"
}
Удалите мета-теги из сценария, если планируете продолжать работу только в Code.
Мета-теги описывают:
@InputText— блок ввода текста;@InputNumber— блок ввода чисел;@InputPhoneNumber— блок ввода телефонного номера;@IntentGroup— блок интенты;@EndSession— блок завершения сценария;@HttpRequest— блок HTTP-запроса;@Transition— блок переход.
Системныe интенты
Graph использует вспомогательный набор системных интентов, в основе которых лежат заранее подготовленные шаблоны.
Интенты Graph определены в библиотеке zfl-common, которую можно использовать в любом проекте.
Чтобы подключить библиотеку zfl-common в проект, откройте файл сценария и укажите следующее:
require: zenflow.sc;
module = sys.zfl - common;
Список системных интентов библиотеки zfl-common:
$TEXT— срабатывает на любой текстовый ответ пользователя и сохраняет его в переменную;$NUMBER— срабатывает, если пользователь указал число, и сохраняет его в переменную;$CITY— распознает город из сообщения пользователя. Распознание городов работает на основе системного справочника;$NAME— распознает имя из сообщения пользователя. Распознание имен работает на основе системного справочника;$COUNTRY— распознает страну из сообщения пользователя. Распознание стран работает на основе системного справочника;$WHERE— срабатывает при вводе страны или города;$EMAIL— распознает почтовый адрес, который указал пользователь;$PHONE— распознает введенный пользователем мобильный телефонный номер для России;$AGREEMENT— распознает согласие пользователя. Например, если сообщение пользователя содержит «да», «ок» или «хорошо»;$NEGATION— распознает отрицательный ответ. Например, если сообщение пользователя содержит «нет», «не надо» или «отменить»;$HELLO— распознает приветствие. Например, если сообщение пользователя содержит фразы вида «добрый день» или «привет»;$PARTING— распознает прощание. Например, если сообщение пользователя содержит фразы вида «пока», «прощай» или «увидимся»;$THANKS— распознает благодарность пользователя. Например, если сообщение пользователя содержит фразы вида «спасибо» или «благодарю»;$UNCERTAINTY— распознает сомнение пользователя. Например, если сообщение пользователя содержит фразы вида «может быть» или «вроде бы»;$INSULTS— распознает нецензурную лексику или оскорбления. Например, если сообщение пользователя содержит мат или слова вроде «дурак»;$APPROVAL— распознает одобрение от пользователя. Например, если сообщение пользователя содержит слова вида «хорошо» или «нравится»;$NEGATIVE— распознает негативную оценку пользователя. Например, если сообщение пользователя содержит слова вида «плохо» или «не очень»;$NORMAL— распознает нейтральную оценку пользователя. Например, если сообщение пользователя содержит слова вида «нормально» или «сойдет»;$GENDER— распознает пол пользователя. Этот интент принимает значения вида «мужчина», «женщина», «девочка» и другие.
Пример использования в сценарии:
state: Подтверждение
q: $AGREEMENT
a: Ваш заказ оформлен! Спасибо!
Чат-бот проверит реплику пользователя на наличие выражающих согласие слов и оформит заказ, если они есть.
Подключение готовых сценариев
Во время работы чат-бот может обмениваться различными данными с внешними системами: CRM, интернет-магазинами, контакт-центрами.
Готовые сценарии упрощают настройку взаимодействия чат-ботов и внешних систем.
Список доступных готовых сценариев зависит от подключенного тарифа.
Чтобы использовать готовые сценарии:
Откройте сценарий проекта в Graph.
В подходящем месте сценария добавьте новый экран и выберите блок Готовые сценарии.
В окне Добавить готовый сценарий выберите систему, с которой нужно настроить интеграцию, и нажмите кнопку Далее.
Если подходящей системы нет в списке, вы можете предложить добавить ее.
Выберите готовый сценарий для взаимодействия с системой.
Список готовых интеграций и доступных для них сценариев ищите в описании блока Готовые интеграции.