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

Agent Designer — вкладка, на которой строится Дерево сценария Агента и тестируется Сценарий агента в Debug-виджете.

## Переход в Agent Designer

1. Для перехода в AGENT DESIGNER необходимо на карточке Агента нажать DESIGN.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-PM9UDsU_38/bb3cd13276969a38c37c9ba64ce0c3e41bdda14fb08f0cb3044b1e01d6b968239fdca94f3a93163a90e887730b035ecfb6e2f025f623b28fe4a91f6843e5f8572759a3ceb1d9724de56475b64ecfcd25f7de015fff40c11f9f2ebda695c40f43b77e8b7f)
2. После нажатия кнопки DESIGN откроется раздел БотБилдера AGENT DESIGNER и вы увидите Дерево сценария.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-nFgPpqvhZ-/796b577138adc2779cf975db7a206d99f991385866e667c7e8f1cd57deeea88ba4d30bbc04b040687c41a60db3b412c4fc3c7503f9db35271634f6c9a1bd840fd67f73de8455cfbf6cb56a75f9c10b885294d18e2146cfd70de9170ad664fd04deafedd1)

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

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

1. Название Агента и Папкаа, в котором он находится. По клику на названии Папкаа происходит переход в Папка.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-q7_tapHzRM/6fab3f4c943953a93394831d584f17dbcfccbc6bad8d27129ebd30c3378fcbb8db3e1956143cc8e527f91f3590aae7889fad0dc32b28590b038b9b6f391b1bf48f698648e21ef08f589fb51b3a86a0a5472769f194e85c086482b7e68facea3d0e4d857b)
2. Дата и время последнего Обучение Агента.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-KewSjDfNXG/e34c02e712e91fbe94a39a899da429e8a47c509e7b9ca77020c460f40ac24dc19cf47b2d033d9537f32ad30920d57ca6e326f7938f1546a26e65f564223a5c9cf64d8554b6ff9b5cd8cef28ee37ad3ed30e6e89e809ae1c3daa73df40fad5bc1805a1fa7)

## Поиск Слотов

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

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

1. Найти поле поиска Слотов в БотБилдере (оно находится  слева на панели операций).\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Q2UvbnEcC7/992e8a7ed2596a39743ced22ac3916b200e96f0cf9d4e5678c069156897b4b3aec3156ccbe3119f75cf2ad907857cd5d8fd3f5a8da96efc89b9b90bb64d121ed1fe884d4f1a22740ea0a303d1f2ac0fc030be1a7ccb87fac254b17cb1cbec7ae84dc3aaf)
2. Ввести искомое значение в поле поиска и нажать кнопку поиска (в виде лупы) либо клавишу Enter.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-lpPqtUs07g/f1e9dbeea0e3447d6c90f119f83be2a5cb61058ab13f108e4e88a5a6aae96cb30da9954b20fac6d0acfed39e4db72e19236f6b77451ca7dad00e74504e5675d59ec4be348b227e264c8659de3015c662e7b8e1c6da42cbba76bd8d104341b31f2b12147d)

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

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

1. Нажать кнопку расширенного поиска.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-66GMhbXQc1/4785b898030865b21706db4c155583e84efd492240d3ca07f1787b22c78342ce946c2b80465c5bd044f14c57d4ff07bccb781f2e7307b12b23bac64b8b46daba2c95b04f10f4f5d7d4a5eb985f90e5cd2b86310485b01827fb0ba66005800e22b1b3cf2b)
2. По нажатию кнопки будет развернута панель расширенного поиска.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-1Ccq2SNSr9/e62d6a5895d3a9d9d021508bf3f6841da400f8e086f7c9ce9a368204b9be25f6116d809633ae7c9e5141b0e0512a93045def00a2110ca15461e824433afca4672ff7ab8a43aba101d49c5a44bc0cfec9b9075397beb154907d11bf806938eccc8b8a6596)
3. Ввести искомые значения в фильтры панели расширенного поиска:
4.
   1. Фильтр Slot type отвечает за искомый(е) тип(ы) Слота(ов).
   2.
      1. Необходимо нажать на поле и выбрать искомые типы Слотов в выпадающем списке.\
         ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-vsTHONm4T9/43263d233a1e9d09e30350d3a2873d900d93b9d54ec95ed028a8d001023ac50d955efb27f656051a813ef2ea24f80c7159a982e030b537966a2228d50b2c99fb03a8bf657ae45d2baad30ed3b6a5dcc1e174488d3c5d8707c79335d5e025b8984c3ac0f4)
   3. Фильтр Slot name отвечает за имя Слота (поле Name).
   4.
      1. Необходимо ввести искомые значения в поле текстом.
   5. Фильтр Slot content отвечает за содержимое Слота.
   6.
      1. Поиск производится по следующим полям Слотов, Внешний запросов и Интентов:
      2.
         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;
      3. Необходимо ввести искомые значения в поле текстом.
   7. Фильтр Slot ID отвечает за ID  Слота:
   8.
      1. Необходимо ввести искомые значения в поле текстом.
      2. Если необходимо найти несколько Слотов, то искомые ID необходимо ввести в поле через запятую.\
         ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-MGQi3aP3C3/95c47d980e9fc5dd7a25371edb92b89c95172094be39eed02566bba9fe2d2d3349d80f3ec8b920688b599b7aee7c76063eb92a95a02b3a09caac107bd4d7840382fa75f603b186fe6f319f4ae1674f64a9a2b478720e1d9503a996247ffb205485bead61)
      3. Поиск происходит по точному совпадению.
5. Поиск происходит по сочетанию поисковых параметров: ищутся Слоты, в которых выполняются все указанные свойства одновременно.
6. После введения данных необходимо нажать кнопку поиска или Search slots.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-JyobnCtu6C/16d71efc86d70d39790ea3514aa3ddbc695e35cb3dd12ebabd19d0e9ce94ee3c601e282cc4c03ec0434765cf32484b76af13620159e6f6a924e773d28614c55c83722f871c51e820b3fca37d65f11d2c013bd735f389293e2f6ccce7352d17566c875c51)
7. По нажатию кнопки начнется поиск Слотов, подходящих под заданные параметры поиска.
8. По окончании поиска будут показаны его результаты: Результаты поиска и навигация.
9. Если поля остались пустыми, по нажатию кнопки поиска ничего не происходит.

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

1. Результатом поиска становится один или множество Слотов, у которых параметры частично или полностью совпадают с искомыми значениями, либо отсутствие Слотов, если таковых совпадений нет.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-ReqO8uhwdD/a079d541c74e2bd5409c4a2b2d718b43d4e841386edf650aed7262af37bf9f937bb1dd01852d5878cf55b265b8d122a378f6d35f17a05651a562ae1b8e69511020dc56b08e37338e47daba5a1d0c3066776ad53e643e3f933746eef8fc7da1a7c25807d8)
2. Найденные Слоты визуально выделены в Дерево сценария с помощью затемнения остального Дерево сценария.
3. Если найденный(е) Слот(ы) находится в свернутой Ветка сценария, визуально выделяется Групповой слот. На Групповой слот появляется значок с отображением количества найденных Слотов в этой свернутой ветке.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-67FEbphNRW/ecd1bb66529334f147f9ab5047e52066163d83c2d0b8841ac79df67042ac48472f08fabf375b491116ccce5fd4b67cc48a077f3335e1297aa6794e84b65ea44a2922c955e301ea921b7f528b8cd8e0982023f381028794119e70b449c10dfb09d08bde2a)
4. Каждому найденному Слоту на время отображения результатов поиска присваивается порядковый номер для удобства навигации по Слотам.
5. Навигация по результатам поиска представлена в виде строки формата a/b, где a — порядковый номер Слота, находящегося в фокусе, b — количество найденных Слотов.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-kvvw4-FRsR/97037a4a3f8d4c110f14e4df9cab27e72f17368eff1c985ffeb654f762464228c9130bb17fd873a3777bbbc5a8050d92ebc94e88c84c4a3365b2a13fec9f5f9765e10d2583a51360d928877b7042c617d706127c13df0a10a8665e61441667e8548bee6b)
6. Если по заданным условиям не найдено Слотов, выводится текст No slots found.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-b58XTkZfsa/c5307e6a99c90643c0a876b647930f9c4c25bea7b995e8cc49feaf3b56b2c092242e26511d103386f885415c4f897d1ac349c18c694709e3e571272f195d1e98cf583e2bc078f7c8480ce0cdff6fb6094538901d63d057c8b050400a3e375ebdd3ef1cbc)
7. Если поле поиска осталось пустым, при нажатии кнопки поиска или Enter ничего не произойдет.
8. Слот, находящийся в фокусе, выделен с помощью увеличенного размера.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-svQdefWV8s/3246faf3b3f182ef71c625d12ee4ce2552917c1f899526fea73910cdfc8fde3ff5529f9a3f0fcc9d712fa5bfe9a381af89f107371ffdf2a3ee82e59737608442f7a331b678ebaaa7b6b196703e426324889dbd74cc6cfed7b0149fb8ae320fc07c42ad95)
9. Переключение фокуса между слотами происходит с помощью кнопок <, <<, >, >>:
10.
    1. кнопка < переносит фокус на предыдущий Слот;
    2. кнопка << переносит фокус на первый Слот;
    3. кнопка > переносит фокус на следующий Слот;
    4. кнопка >> переносит фокус на последний Слот.
11. При переключении фокуса на другой Слот по нажатию одной из кнопок <, <<, >, >> центровка Дерево сценария переносится к данному Слоту.

### Действия со Слотами в режиме отображения результатов поиска

1. После совершения поиска возможно открыть любой Слот в Дерево сценария, при этом не будет сброшен результат поиска. Если Слот был изменен, после его сохранения на нем появляется иконка измененного Слота.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-PSKpT68m4F/8612e65366a87c12196982de79a6ee1a00a63c1e07f471921ed14966690270c7c87357a214b90339084d5f6bf872681079b16c87f1bda60f72f0eec6be19979969bea316f04cd35973f3990e81bbd60ef8dfcea472a8dac33e23a79e94f4c0f0b69e21f4)
2. После совершения поиска возможно добавить новый Слот в Дерево сценария, при этом не будет сброшен результат поиска. Если был добавлен новый слот, результаты поиска, визуальное выделение слотов в дереве и центровка никак не меняются, даже если данный добавленный слот удовлетворяет условиям поиска. Добавленный слот в дереве затемнен.
3. После совершения поиска возможно удалить Слот в Дерево сценария.
4.
   1. Если удаленный Слот был одним из результатов поиска, то при переключении фокуса на этот Слот с помощью кнопок его номер будет выделен красным цветом.\
      ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Y88tkZNDA2/d97a4e2ae6d8a31d11a59ffbfbf873faafe9b8c67cbeb378836cd421c73536f80aa219534a679e05a2ef5db830ca73602127e9b53c3a1b4dfb18d10e228c9b0d32d6092759c3e5a3653aee9bb79c84ed50384f4692760be3495ae23450e7893c5efeda35)
   2. При наведении на номер появляется уведомление с текстом Slot #<номер удаленного слота> was deleted from the script.\
      ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-497leu-wcW/a7bc19af57c848c2b3ebb0bcce54cc7525a5458687a164017c82414421c1f906968021e111df472ec8174043659b37a0d92ebad25c4669e384cad4876435ad030e4ac3e03669896b869e9f69cc3ab42ae52afc94bf2ffebb938f9300578d972205eb593d)
5. После совершения поиска возможно перенести Слот в Дерево сценария, при этом не будет сброшен результат поиска. Если слот был перенесен, он останется под тем же порядковым номером, который он имел до переноса.
6. Если был изменен во время отображения результатов поиска, рядом со строкой с результатами поиска будет выведено уведомление Script was edited.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-7SRxwsjBn_/e0c8e209bf6783a2b0b4254d60423fcb6a7074bf38050cbf0bfbc08cd580e930d362735bbfac4197d7beb6aa5e634e6ddbf9634353607834802c880a4696ce34333494017fb0b9366bd3b551bb6fedfe5fd4a4db3090f89d7a11708d98a954a7b68cd411)
7.
   1. При наведении на него появляется всплывающая подсказка с текстом Search results may be out of date.\
      ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-bwpl_sS0YT/275dc4356a2015d1264ad459cbb0204320b365e885479cee3ccce3dc19221e986dd1bcd599ffc383f436f9be912d9e0e02087ffffa5994434e18fb2cd16b4c97748d0e7b9ad875e74ceaef869d42440b085aef5ae4712bf1910bf6c0f0a8e1064d48a1e1)

## Обучение и DEBUG

Также на вкладке AGENT DESIGNER расположена кнопка Train для обучения Агента и Debug-виджет. Подробнее об Обучение Агента: Требования для успешного обучения Агента.![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-RB3MYI5IPs/3d8e4aa7efa4033ffcb448308b2c582b7a65eadfe03300d8d63f81fb3058a48cd1e623d32e54cbece282a9554acf27cf60d7a5d91a6b16c43153c9d38501084b60c59d5cdf3ca70142488bb9557b163c6e26aca887b1a44aad9a2c0d892c122a84553554)\
![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-hPx90LwjfD/a2b920f5f88662d55df738501fb1fb155f404603c916669a39b12ca7b782f7d17af0ad6f53810f00bab874cca61c227df5a2b9c4aa76d72db0a6d168c01553b533ff35de837b51e146f665bfb7989158340503f84bb08b13485a3ad5f9b87444ae661de2)
