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

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

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

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. Клонированный Агент не содержит Канал Проекта и не обучен.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://chatme-ai-4.gitbook.io/docs/proekty-na-platforme/proekt-i-ego-soderzhimoe/agenty-na-platforme/eksport-import-klonirovanie-i-zamena-scenariya-agenta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.