Экспорт, импорт, клонирование и замена Сценария Агента

Экспорт Агента

В Платформа реализованы функции экспорта и импорта конфигурационного файла Агента. С помощью этих функций вы можете сохранить файл Агента на компьютер, переслать файл своим коллегам и загружать файлы Агентов в Платформа.Для экспорта Агента необходимо:

1. Перейти в раздел Dashboard, открыть Папка, найти нужного Агента и нажать на кнопку Export в выпадающем меню.

2. Агент будет сохранен в формате .cfg. Содержимое экспортированного файла:

3. 1. Сценарий агента Агента;

   2. Используемые в Сценарий агента Интенты;

   3. Используемые в Сценарий агента Внешний запросы;

   4. Значение опции Сбрасывать состояние общение;

   5. Значение Таймаут неактивности в секундах — это время неактивности Собеседника, после которого Диалог с Агентом закрывается;

   6. Группировку Слотов (свернутые Ветка сценария).

4. Теперь данного Агента можно импортировать в любой Папка.

Импорт Агента

Процесс импорта файла

Для того чтобы импортировать Агента в новый Папка, необходимо:

1. Нажать на кнопку Import agent в свойствах Папкаа.
2. В появившемся окне нажать Browse и выбрать нужный файл с расширением .cfg, .json. или .xlsx. Укажите название для этого Агента в новом Папкае и нажмите Import.
3. Агент появится в списке Агентов данного Папкаа.

4. Импортированный Агент не содержит Канал Проекта и не обучен.

5. При попытке загрузить файл с неподдерживаемым расширением или невалидной структурой появится ошибка с текстом Couldn’t import agent.

Импорт из конфигурационного файла Агента

Посредством импорта Сценарий агента Агента из конфигурационного файла возможно создавать Агентов с любой структурой, допустимой в Платформа.Файл данного формата является результатом экспорта Агента из Платформа.

Допустимые расширения файлов

На данный момент к загрузке доступны конфигурационные файлы следующих расширений:

• .cfg

• .json

Содержание импортированного Агента

1. При импорте Агента из конфигурационного файла импортируются:

2. 1. Дерево сценария Агента, включая группировку группировку Слотов (свернутые Ветка сценария);

   2. Ресурсы Компании, используемые в Сценарий агента ( Интенты, Внешний запросы и Словарь), согласно правилам импорта (Экспорт-импорт Интентов при экспорте-импорте Агента, Экспорт-импорт словарей при экспорте-импорте Агента, Экспорт-импорт Внешних запросов при экспорте-импорте Агента);

   3. Значение опции Сбрасывать состояние общение;

   4. Значение Таймаут неактивности;

   5. 1. В конфигурационном файле значение Таймаут неактивности указано в секундах. После импорта значение отображается на карточке Агента в часах и минутах.
      2. Если значение Таймаут неактивности в конфигурационном файле было изменено вручную на значение, которое при переводе в минуты не дает целого числа, то при импорте произойдет округление до целого числа минут в большую сторону.

      3. Если значение Таймаут неактивности в конфигурационном файле было изменено вручную на отрицательное число, 0 или значение, не являющееся числом, то при импорте значение Таймаут неактивности будет приведено к 15 минутам.

   6. В случае наличия Слота Incoming Request в Сценарий агента будет сгенерирован новый адрес вебхука Слота Incoming Request для этого Слота, который будет работать только после Обучение Агента.

   7. В случае наличия Слота Notification в Сценарий агента будет сгенерирован новый адрес вебхука для этого Слота, который будет работать только после Обучение Агента.

Настройки импортированного агента

1. В импортированном Агенте опция Сбрасывать состояние общение выключена.

2. При импорте устанавливается стандартное значение Таймаут неактивности — 15 минут.

Замена Сценария Агента

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

• При импорте из конфигурационного файла устанавливаются значения в соответствии с указанными в файле;

• При импорте из файла Excel устанавливается стандартное значение Таймаут неактивности — 15 минут, опция Сбрасывать состояние общение выключена.

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

1. Производится экспорт конфигурационного файла Агента;

2. Импорт его в Платформа;

3. Внесение правок в импортированного Агента;

4. В случае успешного тестирования, производится экспорт импортированного Агента и замена рабочего Агента этим конфигурационным файлом.

Таким образом сохраняются уже существующие Чаты Агента с Собеседниками и процесс тестирования внесенных правок не нарушает процесс общения Агента с этими Собеседниками.Замена Сценарий агента Агента осуществляется следующим образом:

1. Нажмите кнопку Replace config в меню настроек Агента.
2. В появившемся окне нажмите Browse и выберите нужный файл с расширением .cfg или .json. Нажмите Replace.
3. Чтобы Агент заработал, обучите его, нажав кнопку Train в БотБилдере или на карточке Агента.

4. В процессе замены из конфигурационного файла будут импортированы:

5. 1. Дерево сценария Агента, включая группировку группировку Слотов (свернутые Ветка сценария);

   2. Ресурсы Компании, используемые в Сценарий агента ( Интенты, Внешний запросы и Словарь), согласно правилам импорта (Экспорт-импорт Интентов при экспорте-импорте Агента, Экспорт-импорт словарей при экспорте-импорте Агента, Экспорт-импорт Внешних запросов при экспорте-импорте Агента);

   3. Значение опции Сбрасывать состояние общение;

   4. Значение Таймаут неактивности.

6. При импорте конфигурационного файла с Incoming Request:

7. 1. Если в Сценарий агента до замены уже присутствовал Слот Incoming Request, адрес вебхука Слота Incoming Request в новом Сценарий агента останется таким же, как до замены;

   2. Если в Сценарий агента до замены не было Слота Incoming Request, будет сгенерирован новый адрес вебхука Слота Incoming Request, который начнет работать после Обучение Агента.

8. При импорте конфигурационного файла с Notification:

9. 1. Если в Сценарий агента до замены уже присутствовал Слот Notification, адрес вебхука Notification в новом Сценарий агента останется таким же, как до замены;

   2. Если в Сценарий агента до замены не было Слота Notification, будет сгенерирован новый адрес вебхука для этого Слота, который начнет работать после обучения Агента.

10. В процессе замены из файла Excel (по аналогии с созданием Агента из Excel) будут импортированы:

11. 1. Сценарий агента Агента;

    2. Интенты Агента будут импортированы в Ресурсы Компании;

    3. В импортированном Агенте опция Сбрасывать состояние общение выключена;

    4. При импорте устанавливается стандартное значение Таймаут неактивности — 15 минут.

12. Новый Сценарий агента начнет работу только после переобучения Агента.

Клонирование Агента

Для клонирования Агента необходимо:

1. Открыть настройки Агента, кликнув по кнопке на карточке Агента.

2. 
3. Нажать кнопку Duplicate.
4. После нажатия кнопки появится диалоговое окно с предупреждением:
5. 1. необходимо подтвердить клонирование Агента, нажав кнопку YES, I’M SURE.

6. После клонирования создается новый Агент с именем COPY-[название клонируемого агента] и со своим уникальным идентификатором agent_id.
7. При клонировании Агента клонируются Ресурсы Компании, используемые в Сценарий агента, согласно правилам импорта (Экспорт-импорт Интентов при экспорте-импорте Агента, Экспорт-импорт словарей при экспорте-импорте Агента, Экспорт-импорт Внешних запросов при экспорте-импорте Агента).

8. При клонировании Агента сохраняется значение опции Сбрасывать состояние общение.

9. При клонировании Агента сохраняется значение Таймаут неактивности.

10. В случае наличия Слота Incoming Request в Сценарий агента будет сгенерирован новый адрес вебхука для этого Слота.

11. Клонированный Агент не содержит Канал Проекта и не обучен.