Создание Агента в Excel

Импорт из файла Excel

Посредством импорта Сценарий агента Агента из файла Excel возможно создавать FAQ-Агентов со структурой “вопрос-ответ”, в т.ч. ответ Агента может состоять из нескольких подряд идущих сообщений.

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

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

• .xlsx

Формат файла Excel

Загружаемый файл Excel должен иметь следующие характеристики:

1. Структура файла:

2. 1. 1-я строка:

   2. 1. значение ячейки А1 — текст language;

      2. значение ячейки B1 — код языка для NLU-модели Агента (язык, который будет распознаваться Слотом NLU ). Код может быть прописан в любом регистре. Подробнее в таблице Доступные для распознавания языки и их код).

   3. 2-я строка обязательно пустая. В ином случае произойдет ошибка импорта: будут выведены сообщения об ошибке и Агент не будет импортирован в Платформа.

   4. Начиная с 3-ей строки располагается таблица с данными для создания FAQ-Бота: Обучающая выборка для Интентов, которые будут включены Сценарий агента Агента, названия Интентов и ответы на них:

   5. 1. Столбец A:

      2. 1. название: intent в ячейке А3;

         2. содержимое: названия Интентов, которые будут включены в Сценарий агента Агента.

      3. Столбец B:

      4. 1. название: examples в ячейке B3;

         2. содержимое: Обучающая выборка для Интентов. Обучающая фраза прописываются начиная с ячейки напротив названия Интента и ниже.

      5. Столбец C:

      6. 1. название: message в ячейке C3;

         2. содержимое: ответы Агента на Интенты. Содержит любые текстовые данные, включая ссылки на файлы, которые служат контентом для ответов Агента, также поддерживается рандомизация ответов Агента (подробнее: Логика создания ветки подслота Intent).

      7. Столбцы D и E:

      8. 1. опциональные поля. Если Агент должен давать ответ в нескольких сообщениях, а не в одном, то можно указать от 1 до 3х последовательных сообщений.

         2. заполняются аналогично столбцу C.

      9. Для указания ответа Агента на fallback (в случае, если не распознан ни один из Интентов. Подробнее: Распознавание намерений | Слот NLU и под-слоты Intent и Fallback)

      10. 1. в столбце intent прописывается значение ячейки fallback;

          2. ячейки в столбце examples остаются пустыми. В случае, если ячейки заполнены, при импорте файла их значения игнорируются;

          3. в столбце/столбцах message указывается ответ Агента на fallback.

Язык	Код языка для создания Агента через Excel
Русский	ru
Английский	en
Португальский	pt
Украинский	uk
Испанский	es
Вьетнамский	vi
Тайский	th
Индонезийский	id
Малайский	ms
Филиппинский	tl
Сербский	sr
Немецкий	de
Польский	pl
Французский	fr
Пакистанский (урду)	ur
Киргизский	ky
Арабский	ar

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

Общий принцип построения СценарияПри импорте файла в Платформа создается Агент со следующей структурой Сценарий агента:

1. Слот Start;

2. Затем Слот NLU с Подслотами intent для каждого Интента из загружаемого файла и Подслотом fallback;

3. После Подслотов intent и fallback следуют Слоты с сообщениями/ответами Агента, если они указаны в загружаемом файле в колонке message. В ином случае Слоты с сообщениями/ответами Агента не будут созданы;

4. На конце каждой Ветка сценария стоит Слот Wait For Reaction.

Логика создания ветки подслота intentДля каждого Интента из загружаемого файла:

1. Создается Интент в Ресурсы Компании с прописанной в файле Обучающая выборка;

2. 1. Интенты создаются с соответствии с правилами импорта Интентов.

   2. Интенты, содержащие менее 2х строк в Обучающая выборка, при импорте будут игнорироваться: они не появятся в Ресурсы Компании и для них не будут созданы соответствующие Подслоты с Ветка сценария.

3. В Подслоте intent устанавливается данный Интент;

4. Создаются от 1 до 3х Слотов Text или Attachment с сообщениями/ответами Агента, следующих за данным Подслотом intent. Контент данных Слотов Text или Attachment соответствует контенту столбцов message (C,D,E колонки) для данного Интента:
5. 1. если ячейки в столбцах message пустые, то Слоты Text или Attachment не создаются после Подслота intent;

   2. если напротив одного Интента в файле заполнено несколько ячеек в одном столбце message, то создается Слот Text и содержимое каждой ячейки импортируется в качестве одного из рандомных ответов Агента (подробнее про рандомизацию ответов: Текстовые ответы бота | Слот Text).
   3. 1. в Слоте по умолчанию выключен Markdown, опция Точка сохранения выключена.

   4. ячейки в столбцах message, содержащие текст, соответствующий шаблону <ссылка на файл> + текст или текст + <ссылка на файл>, будут импортированы в виде Слотов Attachment, поля которых заполнены следующим образом:
   5. 1. поле Name — заполняется первыми 40 символами текста из ячейки, сопровождающим ссылку

      2. поле Source — заполняется ссылкой из ячейки

      3. поле Caption — заполняется текстом из ячейки, сопровождающим ссылку

      4. поле Primary type — тип файла устанавливается согласно расширению в ссылке:

      5. 1. Image — jpg, jpeg, png, gif, bmp

         2. Audio — mp3, wav, wma, aac, ogg

         3. Video — mp4, mov, avi, wmv, flv, mkv

      6. Примеры:

      7. 1. 
         2. 
         3. 
         4. 
      8. в Слоте по умолчанию выключен Markdown, опция Точка сохранения выключена.

   6. остальные ячейки в столбцах message импортируются в качестве Слотов Text.

Логика создания ветки подслота fallbackСоздается Подслот fallback;

1. Если файл содержит ответ на fallback, за Подслотом fallback создаются Слоты Text или Attachment в соответствии с порядком от столбца С к столбцу Е в таблице;
2. Если файл содержит несколько строк fallbackа, то при импорте файла текст для ответа переносится из первого из них, остальные строки fallback игнорируются;
3. Если в файле нет fallback или не заполнены соответствующие ему ячейки в столбце message, то при импорте создается Подслот fallback со следующим за ним Слотом Wait For Reaction.