Вкладка сценария Агента — Agent Designer

Переход в Agent Designer

Для перехода в Agent Designer необходимо на карточке Агента нажать кнопку DESIGN.

После нажатия кнопки DESIGN откроется раздел БотБилдера AGENT DESIGNER и вы увидите Дерево Сценария.

Отображение информации об Агенте

В AGENT DESIGNER на верхней панели отображается следующая информация об Агенте:

1. Название Агента и Проекта, в котором он находится. По клику на названии Проекта происходит переход в Проект.
2. Дата и время последнего Обучения Агента.

Поиск Слотов

Простой поиск

Чтобы совершить поиск по видимым данным Слота (его id, название и тип), необходимо:

1. Найти поле поиска Слотов в БотБилдере (оно находится слева на панели операций).
2. Ввести искомое значение в поле поиска и нажать кнопку поиска (в виде лупы) либо клавишу Enter.

Расширенный поиск

1. Для совершения поиска по нескольким параметрам слотов одновременно необходимо нажать кнопку расширенного поиска.
2. По нажатию кнопки будет развернута панель расширенного поиска.
3. Необходимо ввести искомые данные в поля панели:

   1. Поле Slot type отвечает за искомый(е) тип(ы) слота(ов).

      1. Необходимо нажать на поле и выбрать искомые типы слотов в выпадающем списке.
   2. Фильтр Slot name отвечает за имя слота (поле Name слота).

      1. Необходимо ввести искомые значения в поле текстом.

   3. Фильтр Slot content отвечает за содержимое слота.

      1. Поиск производится по следующим полям слотов, интентов и внешних запросов:

         1. в слоте Attachment – source, caption;

         2. в слоте Incoming Request – context key, request key;

         3. в слоте Text – text list;

         4. в слоте Timer – after, if;

         5. в подслоте condition – condition;

         6. в подслоте button – label;

         7. в слоте Regular Expression – expression;

         8. в подслоте result – value;

         9. в подслоте intent – intent name, request;

         10. в слоте Jump – destination;

         11. в слоте Slot Filling – answer variable, question;

         12. в слоте Memory – key, value;

         13. в слоте Synonym – source, result variable, vocabulary

         14. в слоте External Request – поля внешнего запроса description, endpoint, new name и value на вкладках headers и query parameters, data, new key и name на вкладке response;

      2. Искомые значения вводятся в поле текстом.

   4. Фильтр Slot ID отвечает за id Слота:

      1. Значения вводятся в поле текстом;

      2. Поиск происходит по точному совпадению;

      3. Если указано несколько ID через запятую, это соответствует логическому ИЛИ: результатом поиска становятся все Слоты c ID, перечисленными в поле;

      4. При добавлении в поле фильтра большого количества значений, которые не помещаются в одну строку, поле фильтра становится многострочным и новые значения переносятся на следующую строку. Панель поиска при этом расширяется вниз.

4. После введения данных необходимо нажать кнопку поиска или Search slots.
5. Поиск происходит по сочетанию поисковых параметров: ищутся слоты, в которых выполняются все указанные свойства одновременно.

6. Поиск регистронезависимый.

7. Поиск происходит как по полному, так и по частичному совпадению искомых значений с содержимым полей.

Результаты поиска и навигация

1. Результатом поиска становится один или множество слотов, у которых имя, тип или id частично или полностью совпадают с искомыми значениями, либо отсутствие слотов.
2. Каждому найденному слоту на время отображения результатов поиска присваивается порядковый номер для удобства навигации по слотам. Порядок нумерации найденных слотов – слева направо, сверху вниз.

3. Результаты поиска отображаются в виде строки формата a/b, где a – порядковый номер cлота, находящегося в фокусе, b – количество найденных слотов.
4. Если по заданным условиям не найдено слотов, выводится текст No slots found.
5. Если поле поиска осталось пустым, при нажатии кнопки поиска или Enter ничего не произойдет.

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

   1. кнопка < переносит фокус на предыдущий слот

   2. кнопка << переносит фокус на первый слот

   3. кнопка > переносит фокус на следующий слот

   4. кнопка >> переносит фокус на последний слот

8. Кнопки <, << недоступны для нажатия, когда фокус на первом слоте.
9. Кнопки >, >> недоступны для нажатия, когда фокус на последнем слоте.

Подсветка и центровка результатов поиска

1. Найденные слоты визуально выделены в дереве с помощью затемнения остального дерева.
2. При переключении фокуса на другой слот по нажатию одной из кнопок <, <<, >, >> центровка дерева переносится к данному слоту.

3. После совершения поиска возможно открыть любой слот в дереве, при этом не будет сброшен результат поиска. Если слот был изменен, после его сохранения на нем появляется иконка измененного слота.
4. После совершения поиска возможно добавить новый слот в дереве, при этом не будет сброшен результат поиска. Если был добавлен новый слот, результаты поиска, визуальное выделение слотов в дереве и центровка никак не меняются, даже если данный добавленный слот удовлетворяет условиям поиска. Добавленный слот в дереве затемнен.

5. После совершения поиска возможно удалить слот в дереве, при этом визуальное выделение слотов в дереве и центровка никак не изменяются.

   1. Если удаленный слот был одним из результатов поиска, то при переключении фокуса на порядковый номер этого слота с помощью кнопок его номер будет выделен красным цветом.
   2. При наведении на номер появляется уведомление с текстом Slot #<номер удаленного слота> was deleted from the script. и значком восклицательного знака.
6. После совершения поиска возможно перенести слот в дереве, при этом не будет сброшен результат поиска. Если слот был перенесен, он останется под тем же порядковым номером, который он имел до переноса.

7. Если сценарий был изменен во время отображения результатов поиска, рядом со строкой с результатами поиска будет выведено уведомление Script was edited.

   1. При наведении на него появляется всплывающая подсказка с текстом Search results may be out of date.
8. Если найденный(е) слот(ы) находится в свернутой ветке, визуально выделяется групповой слот. На групповом слоте появляется значок с отображением количества найденных слотов в этой свернутой ветке.
9. При разворачивании визуально выделенного группового слота, найденные слоты в развернутой ветке будут визуально выделены с помощью затемнения остального дерева. При этом центровка дерева не меняется.

   1. Если в развернутой ветке находится групповой слот, содержащий результаты поиска, он будет визуально выделен и на нем будет значок с отображением количества найденных слотов в этой свернутой ветке.
10. При сворачивании ветки, содержащей найденный(е) слот(ы), визуальное выделение переходит к групповому слоту. Если при совершении поиска эта ветка была развернута, то на групповом слоте НЕ появляется значок с отображением количества найденных слотов в этой свернутой ветке. Если при совершении поиска ветка была свернута, затем развернута, то при сворачивании на групповом слоте появится значок с отображением количества найденных слотов. Центровка не меняется.

11. При переключении фокуса между слотами с помощью кнопок <, <<, >, >> фокус переносится на групповой слот, содержащий найденный(е) слот(ы).

12. Разворачивание и сворачивание слотов производится только самим пользователем.

13. Визуальное выделение меняется только при разворачивании группового слота.

14. Центровка дерева изменяется только по переходу на другой слот либо по началу поиска.

Обучение и DEBUG

Также на вкладке AGENT DESIGNER расположена кнопка Train для обучения Агента и DEBUG-виджет. Подробнее об обучении Агента: Требования для успешного обучения Агента