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

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

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

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

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

  • .xlsx

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

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

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

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

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

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

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

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

      1. Столбец A:

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

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

      2. Столбец B:

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

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

      3. Столбец C:

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

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

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

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

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

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

        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. Создается Интент в Ресурсы Компании с прописанной в файле Обучающая выборка;

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

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

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

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

    1. если ячейки в столбцах message пустые, то Слоты Text или Attachment не создаются после Подслота intent;

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

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

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

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

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

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

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

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

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

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

      5. Примеры:

      6. в Слоте по умолчанию выключен Markdown, опция Точка сохранения выключена.

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

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

  1. Если файл содержит ответ на fallback, за Подслотом fallback создаются Слоты Text или Attachment в соответствии с порядком от столбца С к столбцу Е в таблице;

  2. Если файл содержит несколько строк fallbackа, то при импорте файла текст для ответа переносится из первого из них, остальные строки fallback игнорируются;

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

Last updated