Вкладка словарей — Vocabularies

Вкладка VOCABULARIES — вкладка, на которой создаются и редактируются Словарь для дальнейшего их использования в Агентах Компания.Словарь — это функционал, представляющий собой таблицу с данными, загруженную в Платформа, используется в сочетании со Слотом Synonym (подробнее: Распознавание сущностей | Слот Synonym).Словарь представляет собой объект Ресурсы Компании, то есть доступен из всех Агентов данной Компания. При Обучение создается Обученная модель агента, в которой содержится копия всех Словарь, задействованных в Сценарий агента на момент Обучение.

Переход на вкладку Словарей

1. В список Словарь Компания можно перейти двумя способами:

2. 1. перейти на вкладку Resourses (Вкладка ресурсов Компании — Resourses) и нажать кнопку Vocabularies;

   2. перейти в БотБилдер Агента и открыть вкладку Vocabularies.

Список словарей

На вкладке Словарь представлен список всех Словарь Компания:

1. Словарь отсортированы в алфавитном порядке. Сортировку можно изменить: по нажатию данной кнопки сортировка Интентов меняется от начала алфавита к концу и наоборот.

2. Напротив каждого Словарь указан его язык.

3. Напротив каждого Словарь, используемого в Агентах, проставлена галочка и кнопка Clarify;

4. 1. По нажатию кнопки Clarify выводятся иконки Агентов, в которых используется Словарь.

5. Лимит на количество Словарь на Компания — 40 штук. При попытке загрузить 41-й Словарь в Ресурсы Компании возникнет ошибка с текстом You have exceeded the maximum number (40) of vocabularies. и Словарь не будет загружен в Платформа.

6. 

7. 1. При попытке импорта в Компания Агента со Словарь, если сумма количества Словарь в Компания и в импортируемом Агенте превышает 40, произойдет ошибка импорта.

   2. 

Поиск по Словарям

Можно совершать поиск по имени, языку и использованию Словарь в Агентах. Поиск может совершаться как по одному параметру, так и по нескольким параметрам одновременно.

Поиск по имени Словаря

1. Для совершения поиска по имени Словарь необходимо ввести искомое значение в поле поиска.

2. В списке будут выведены только Словарь, содержащие в названии искомую строку.

Поиск по использованию Словаря

Поиск по использованию Словарь в Агентах производится с помощью фильтров In use и Not in use:

1. По нажатию на кнопку In use выводятся только Словарь, которые используются в Агентах:
2. Также по нажатию на кнопку In use вместо фильтра Not in use выводится фильтр Agent — фильтр по Агентам.

3. 1. По нажатию на кнопку Agent открывается панель поиска по Агентам.
   2. Чтобы найти Словарь, которые используются в определенных Агентах, необходимо кликнуть по необходимым Агентам в списке.

4. По нажатию на кнопку Not in use выводятся Словарь, которые не используются в Агентах.

Поиск по языку Словаря

Поиск по языку Словарь производится с помощью фильтра Language.

1. По нажатию на кнопку Language открывается выпадающий список языков Словарь.
2. По клику на элементе/ах списка:

3. 1. язык выделяется галочкой;

   2. Словарь на вкладке фильтруются и отображаются только Словарь на выбранном/ых языке/ах.

Создание, изменение и удаление Словарей

Подготовка таблицы Словаря

Файл, загружаемый в качестве Словарь, должен иметь следующие характеристики:

1. Формат .csv;

2. Содержимое файла:

3. 1. 1-ый столбец — название: ‘entity’, содержимое: названия Сущность (наборов Синонимов);

   2. 2-ой столбец — название ‘synonyms’, содержимое: наборы Синонимов, перечисленных через запятую

4. Названия Сущность могут повторяться.

5. Синонимы в разных Сущность могут повторяться.
6. Регистр Синонимов не влияет на результат распознавания.

7. При наличии в одном Словарь “дубликатов” — строк, в которых совпадают и название Сущность и наборы Синонимов (даже при разном порядке этих Синонимов в строках) — в процессе импорта этого Словарь “дубликаты” не будут импортированы, будет импортирована только первая из “повторяющихся” строк.

8. Распознавание словарных Сущность работает качественно и гибко только на языках, указанных в таблице ниже, т.е. распознаются различные словоформы синонимов, а не только полные совпадения с ними. В остальных языках (если словарь на другом языке или смешаны языки) распознавание будет происходить только по точному совпадению искомой строки с Синонимом в списке Синонимов (без окончаний, склонений и т.п.).

9. Существует Лимит на количество Сущность в Словарь: При попытке загрузить Словарь с более чем 10000 Сущность в Ресурсы Компании возникнет ошибка с текстом Entity count must be less than 10000. и Словарь не будет загружен в Платформа.
10. Существует Лимит на количество Синонимов в одной Сущность в Словарь: При попытке загрузить Словарь с более чем 500 Синонимов в хотя бы одной Сущность в Ресурсы Компании возникнет ошибка с текстом Synonym count must be less than 500 (row <номер ряда, содержащего более 500 синонимов>. и Словарь не будет загружен в Платформа.

Язык	Обозначение в выпадающем списке
Русский
Английский
Португальский
Украинский
Испанский
Тайский

Cоздание нового Словаря в ресурсах компании

Чтобы создать новый Словарь, необходимо:

1. Перейти в список Словарь Компания.

2. Нажать кнопку Create new.
3. Ввести название Словарь в поле Name. Максимальная длина значения поля — 1000 символов. По достижении максимального значения далее символы не вводятся в поле;

4. 
5. 1. Возможно загружать несколько Словарь с одинаковым названием.

6. Указать язык Словарь в поле Language, выбрав его в выпадающем списке.
7. 1. Поле Language станет недоступно для редактирования после сохранения Словарь.

8. Загрузить файл для Словарь, нажав кнопку Upload your vocabulary или перетащив файл в окошко.

9. 1. Возможно загружать один и тот же файл Словарь несколько раз.

10. Сохранить введенные данные, нажав кнопку CREATE.

Редактирование Словаря

В загруженном Словарь можно изменять название, обновлять файл, выбранный язык изменять нельзя. Чтобы изменить Словарь необходимо:

1. Перейти в список Словарь.

2. Открыть настройки Словарь, кликнув по нему в списке Словарь;

3. 
4. Изменение названия возможно в поле Name. Оно доступно для редактирования;

5. Поле Language недоступно для редактирования после сохранения Словарь.

6. Для обновления файла Словарь необходимо загрузить новый файл, нажав кнопку Upload your vocabulary или перетащив файл в окошко.

7. Сохранить введенные данные, нажав кнопку SAVE.

8. Изменения вступят в силу только после Обучение Агента.

Удаление Словаря

Для удаления единичного Словарь необходимо:

1. Перейти в список Словарь.

2. Выбрать Словарь кликом по его названию или через селектор.

3. Нажать на кнопку Delete или Delete vocabulary.
4. Подтвердить действие в модальном окне, нажав кнопку DELETE VOCABULARY.

5. 
6. При попытке удаления Словарь, который задействован в Сценарий агента Агента/ов, появится предупреждение о том, что необходимо сначала удалить его из Сценарий агента:

7. 
8. Если же Словарь не задействован в Агентах, он будет удален.

Выгрузка файла Словаря

Чтобы сохранить на компьютер файл Словарь, необходимо:

1. Перейти в список Словарь.

2. Выбрать Словарь кликом по его названию или через селектор.

3. Нажать на кнопку Download или Download vocabulary.
4. После нажатия кнопки файл Словарь будет загружен на компьютер.

5. Файл имеет название формата vocabulary_<ID Словаря в Платформе>

6. Пример: vocabulary_281

7. Файл имеет расширение .csv.

Массовые действия со Словарями

В Платформа реализован множественный выбор Словарь и массовые действия, применимые к группе Словарь.

Множественный выбор

Множественный выбор Словарь можно осуществить следующими способами:

1. Проставить галочки в соответствующих необходимым Словарь селекторах вручную.

2. 
3. Проставить галочки в селекторе массового выбора — в этом случае будут выделены все Словарь на странице.

4. 
5. Выбор одной из групп Словарь. По клику на стрелочке открывается выпадающий список;

6. 
7. 1. В выпадающем списке представлены варианты, по клику на одном из них будет выбрана соответствующая группа Словарь:

   2. 
   3. 1. All — все Словарь;

      2. In use — только используемые в Агентах Словарь;

      3. Not in use — только неиспользуемые Словарь.

Снятие выделения со Словарей

Снятие выделения с выбранных Словарь осуществляется следующими способами:

1. Удаление галочек из селекторов вручную.

2. Через селектор массового выбора.

3. 
4. Выбор варианта Clear selection в выпадающем списке:

5. 

Массовое удаление Словарей

Чтобы единовременно удалить несколько Словарь, необходимо:

1. Выбрать несколько Словарь, как описано в пункте Множественный выбор;

2. Нажать кнопку Delete vocabularies;

3. 
4. Подтвердить действие в модальном окне, нажав кнопку DELETE VOCABULARIES;

5. 
6. Если в числе выбранных Словарь присутствуют Словарь, которые задействованы в Сценарий агента Агента/ов, то появится предупреждение о том, что данные Словарь не были удалены.

7. 

Экспорт-импорт словарей при экспорте-импорте Агента

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

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

2. Если в Компания есть Словарь с идентичным названием, но отличающимся файлом, произойдет импорт:
3. Если в Компания нет такого Словарь, то он будет импортирован и появится в списке Словарь.

4. Если с учетом п.1-3 общее количество Словарь в Компания после импорта Агента должно будет превысить 40, то произойдет ошибка импорта.

5.