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

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

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

1. Перейти в раздел Dashboard, открыть Папка, найти нужного Агента и нажать на кнопку Export в выпадающем меню.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl--TQxkTBHUe/89ee399d70abb22105dd585e1637ee0a763177bfb87a529046e85dbea2799fda8bf10c9507ad7d6d2d4e0c67e995dc7a4a74a528f6e1101a1c1426885f0daff4e46c9ffa8412e1a822d11815bde9874c4d29d22d74a869591cfa94b731b7e8e6ebd73117)
2. Агент будет сохранен в формате .cfg. Содержимое экспортированного файла:
3. 1. Сценарий агента Агента;
   2. Используемые в Сценарий агента Интенты;
   3. Используемые в Сценарий агента Внешний запросы;
   4. Значение опции Сбрасывать состояние общение;
   5. Значение Таймаут неактивности в секундах — это время неактивности Собеседника, после которого Диалог с Агентом закрывается;
   6. Группировку Слотов (свернутые Ветка сценария).
4. Теперь данного Агента можно импортировать в любой Папка.

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

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

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

1. Нажать на кнопку Import agent в свойствах Папкаа.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-EZc_bul6ZD/89ae8251a6ceb3de81b1297bf83261003c093a91b78ea8e1b14e671ad32cdc7f8cd2f9b6a302720bda28a376eb20f1cac77ca710e7c5358c26c347ac7942b4975fa94623b7d2d36d876dc4600df6702c1a73be411c5f7071d3b9ca667f6b77f5403e44bc)
2. В появившемся окне нажать Browse и выбрать нужный файл с расширением .cfg, .json. или .xlsx. Укажите название для этого Агента в новом Папкае и нажмите Import.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-dPD_sPP6wW/953f87c5b0a2a9c89530e4691c41f98d178d8d01f9783f63bf6b66becbb49b38dd4b6354a4df558f2b2269ddfeabfd46b08ab0b482c8d652b491f30e850e2f6e2bd31ffc7f641f554da814a76a62afede074ccfc3e904754f99b1eaffb7a98d89da1bece)
3. Агент появится в списке Агентов данного Папкаа.
4. Импортированный Агент не содержит Канал Проекта и не обучен.
5. При попытке загрузить файл с неподдерживаемым расширением или невалидной структурой появится ошибка с текстом Couldn’t import agent.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-B44id2FZw1/c8b3d1d83932aff06ee0a0bc07cada93f83fe7d98e306e9c0d55abb07336e249dfe28fe77d6e32e68bb36ae1a3a833a686e037211e1dc5baa83b3f676ab98b193a522ccfbb1057cd94233bed8215efb0572879e0c697c9c5bcc7e2c05071abede66e91ac)

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

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

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

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

* .cfg
* .json

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

1. При импорте Агента из конфигурационного файла импортируются:
2. 1. Дерево сценария Агента, включая группировку группировку Слотов (свернутые Ветка сценария);
   2. Ресурсы Компании, используемые в Сценарий агента ( Интенты, Внешний запросы и Словарь), согласно правилам импорта (Экспорт-импорт Интентов при экспорте-импорте Агента, Экспорт-импорт словарей при экспорте-импорте Агента, Экспорт-импорт Внешних запросов при экспорте-импорте Агента);
   3. Значение опции Сбрасывать состояние общение;
   4. Значение Таймаут неактивности;
   5. 1. В конфигурационном файле значение Таймаут неактивности указано в секундах. После импорта значение отображается на карточке Агента в часах и минутах.\
         ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-qXlUr0vbvG/ecf1367eb5219f59d5fb06233bdf847a498af76adb0460284ca9a1b10860adeed6641cf6f75ca4f486d092331e39d7fe70966d869978b1130bdc50daf96e3dbfdf13c10317b4281cb62df3b642f40d9df6681edd12d4be06859533b8e8760d7f68da2ff8)
      2. Если значение Таймаут неактивности в конфигурационном файле было изменено вручную на значение, которое при переводе в минуты не дает целого числа, то при импорте произойдет округление до целого числа минут в большую сторону.
      3. Если значение Таймаут неактивности в конфигурационном файле было изменено вручную на отрицательное число, 0 или значение, не являющееся числом, то при импорте значение Таймаут неактивности будет приведено к 15 минутам.
   6. В случае наличия Слота Incoming Request в Сценарий агента будет сгенерирован новый адрес вебхука Слота Incoming Request для этого Слота, который будет работать только после Обучение Агента.
   7. В случае наличия Слота Notification в Сценарий агента будет сгенерирован новый адрес вебхука для этого Слота, который будет работать только после Обучение Агента.

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

1. В импортированном Агенте опция Сбрасывать состояние общение выключена.
2. При импорте устанавливается стандартное значение Таймаут неактивности  — 15 минут.

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

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

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

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

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

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

1. Нажмите кнопку Replace config в меню настроек Агента.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-1keOVzGv6G/8b1ae516c47bfb29f3682f942664a116c6c1fdadecc4a2e270c9e470ca766e081176141d02cc4c829d4a742156c529c639d631360e1cd12f485e25317b0ca0b160196a9c48518494cdd8af102f559952e9ce6560569130c7855fcb2ecd96a8e6106cfc58)
2. В появившемся окне нажмите Browse и выберите нужный файл с расширением .cfg или .json. Нажмите Replace.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-GaG_fy2RWp/a6b1a9073571e2f2b406a3d2ce722c3b27299ce419f4954569b4e89a828ec8addbe1ef254ef022658a004af0beceecbcf9bf09e3fa91f526458dbcc733b25a0313ddf2516373d6492d70bb790712100cd5fbb7e0e3a2f4985c1955aaaaff1bbe46fc843e)
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. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-grw9eXJGgP/0ddfc07c369068cf1326aa290b7d12ef1e493a192046f760ae379f8247ca28d91ff1d25e920f8f691aa945df4efd8d90e0378531d52fa13022fc7ef0f16c5364f8ad23c698dfd1e849e6937744a92014d509d2ff492501b1d350d5b582c668914ddc5325)
3. Нажать кнопку Duplicate.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-F_eNzA8Wwf/86934ce47067f02f803f596f0841a916fde627750617060177da300c0fcd43af6aa579e0f8e7c2b3aadd501c16e22359d3f3cba542dd36afc69e573d933abe6820584077c86926765379417448edb4cb2db45a1ad1027ece525b16fd8bbbc23249930493)
4. После нажатия кнопки появится диалоговое окно с предупреждением:\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Wjf-2rFOI2/da884d04a3e2b176178d10fe4164fe4a801347a9b8b4d59702f18a5b0b6f4dced71db9ab014c00d5291145ae868d7eb2db05c9bd0fdeb69807b223130a171771bdb3bad43b8f7ee6a5b61bb0fe5bc4a47d6980f1289319c524ccd6fd35f3890076f9d45c)
5. 1. необходимо подтвердить клонирование Агента, нажав кнопку YES, I’M SURE.
6. После клонирования создается новый Агент с именем COPY-\[название клонируемого агента] и со своим уникальным идентификатором agent\_id.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-VaWUdSOyXF/8f0da1eeecf9e6dcd4ee97e475943967f2cd2e145576e1c964840fa8cc4e404cf0ed2d2977736f63979ac3514947b6f07b4ab191721131f09c69abe46780361fcb6154515e6b5029c3f87abd92fd1f0cee2debe6b5fb96ef4ecf99534ccc4404fa599185)
7. При клонировании Агента клонируются Ресурсы Компании, используемые в Сценарий агента, согласно правилам импорта (Экспорт-импорт Интентов при экспорте-импорте Агента, Экспорт-импорт словарей при экспорте-импорте Агента, Экспорт-импорт Внешних запросов при экспорте-импорте Агента).
8. При клонировании Агента сохраняется значение опции Сбрасывать состояние общение.
9. При клонировании Агента сохраняется значение Таймаут неактивности.
10. В случае наличия Слота Incoming Request в Сценарий агента будет сгенерирован новый адрес вебхука для этого Слота.
11. Клонированный Агент не содержит Канал Проекта и не обучен.