Создание и редактирование проекта

Перейдите в раздел Проекты и нажмите Создать проект.

Настройки создания проекта расположены на вкладках:

Наименование.
Размещение.
Классификатор (рассмотрен в отдельной статье).
Настройки NLU (рассмотрены в отдельной статье).

Наименование

Заполните поля:

Имя — название проекта, обязательное поле.
Описание — краткое описание проекта.
Язык NLU — язык, который будет понимать бот.
Шаблон бота — заранее подготовленный пример бота.

Шаблон сразу загрузится в проект и будет доступен для подключения к каналу. Шаблоны отличаются структурой и содержанием: ознакомьтесь с кратким описанием под названием шаблона.

Размещение

JAICP поддерживает два способа размещения проектов: локальное хранилище (способ по умолчанию) или внешний репозиторий.

Локальное хранилище

При выборе локального хранилища проект хранится непосредственно в JAICP.

Локальные проекты создаются быстро и позволяют избежать проблем администрирования внешних репозиториев, однако накладывают ряд ограничений:

Нет полноценного версионирования и возможности вернуться к предыдущим версиям.
Затруднена работа над проектом нескольких разработчиков одновременно.
Сложно поддерживать проекты с объемной кодовой базой.

Если вы выбрали для хранения локальное хранилище, нажмите Создать. После создания проекта вы можете переходить к разработке бота.

Внешний репозиторий

Проект может храниться в репозитории, созданном при помощи системы контроля версий Git.

Другие системы контроля версий, такие как Mercurial или SVN, не поддерживаются.

Использование Git имеет ряд преимуществ:

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

Репозиторий может быть размещен на любом внешнем хостинге, например Bitbucket, GitLab или GitHub.

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

Не рекомендуется использовать внешний репозиторий совместно с созданием проекта из шаблона: в таком случае все данные в репозитории будут перезаписаны кодом шаблона.

Гостевой доступ On-premise

Гостевой доступ может быть предоставлен только для версии платформы JAICP On-premise.

Заполните поля:

Ссылка — ссылка на репозиторий.
Путь — относительный путь к директории, в которой будет храниться контент проекта.

Директорией контента в репозитории считается та, в которой хранится конфигурационный файл chatbot.yaml.

Ветка — ветка с контентом, по умолчанию master.

Эта настройка определяет, содержимое какой ветки будет отображаться в редакторе. Однако в любом канале по-прежнему можно указать любую ветку.

Доступ — выберите Гостевой доступ. Вам необходимо предоставить доступ на запись и чтение аккаунту, указанному в конфигурации платформы.
Ключ — ключ обеспечивает защиту репозиториев с гостевым доступом. Сгенерируйте или придумайте ключ.

Подробнее об использовании ключа

Нажмите Создать. После создания проекта вы можете переходить к разработке бота.

Личная учетная запись

Заполните поля:

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

Нажмите Создать.

Изменение способа размещения

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

Перенос во внешний репозиторий

Чтобы перенести проект из локального хранилища в репозиторий, потребуется:

Экспортировать проект в виде архива и распаковать.
В директории с файлом chatbot.yaml инициализировать новый репозиторий Git.
Сохранить все изменения и загрузить во внешний репозиторий.
Создать новый проект с размещением во внешнем репозитории.

Перенос в локальное хранилище

Для переноса из репозитория в локальное хранилище достаточно:

Экспортировать проект в виде архива.
Создать новый проект с размещением в локальном хранилище.
Импортировать содержимое старого проекта в новый.

Удаление диалогов

Платформа предоставляет возможность удалять логи диалогов клиентов по истечении заданного времени.

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

Редактирование проекта

После создания проекта вы можете отредактировать его настройки:

Нажмите Проекты на боковой панели, чтобы перейти к странице с вашими проектами.
Нажмите на иконку напротив названия проекта > Редактировать.
Внесите изменения на тех же вкладках, что и при создании проекта, и нажмите Сохранить.