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

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

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

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

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

    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. При импорте Агента из конфигурационного файла импортируются:

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

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

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

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

      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. В процессе замены из конфигурационного файла будут импортированы:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  3. Нажать кнопку Duplicate.

  4. После нажатия кнопки появится диалоговое окно с предупреждением:

    1. необходимо подтвердить клонирование Агента, нажав кнопку YES, I’M SURE.

  6. После клонирования создается новый Агент с именем COPY-[название клонируемого агента] и со своим уникальным идентификатором agent_id.

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

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

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

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

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

PreviousСоздание Агента в ExcelNextОбзор конструктора сценария Агента и вкладок

Last updated