{ "componentChunkName": "component---src-templates-doc-page-js", "path": "/docs/ru/NLU_core/slot_filling/", "result": {"data":{"site":{"siteMetadata":{"title":"Gatsby-doc-engine"}},"markdownRemark":{"id":"ee7f961f-a0d8-5578-8ed7-74ba9ff3b3bc","excerpt":"Slot Filling Slot Filling (слот-филлинг) — процесс дозапроса информации для выполнения запроса клиента. Полученные данные в ходе дозапроса доступны для…","html":"

Slot Filling

\n
\n

Slot Filling (слот-филлинг) — процесс дозапроса информации для выполнения запроса клиента. Полученные данные в ходе дозапроса доступны для использования в сценарии.

\n

Slots (слоты) — данные, которые клиент передает с запросом или в процессе дозапроса. У каждого слота есть обязательные атрибуты: Имя, Тип.

\n

В данной статье рассматриваются вопросы:

\n\n
\n

Заполнение слотов из запроса

\n

Подробнее о заполнении слотов в интерфейсе

\n

Если рассматривать интент как функцию, которую клиент может вызвать, слот является переменной, параметром этой функции.

\n

Например, для интента /Погода примером фразы может быть Погода в Лондоне сегодня и два слота City и Date.\r\nДля примера фразы в слот City попадет — Лондон, в слот Date — сегодня.

\n

При этом заполненные слоты будут переданы в сценарий в переменной $parseTree._<ИмяСлота>. В значении переменной будет ассоциированное значение, при его отсутствии — текст.

\n

Использование заполненных слотов в сценарии:

\n
    state:\r\n        intent!: /Погода\r\n        a: Погода в {{ $parseTree._City }} на {{ $parseTree._Date }}
\n
\n
Атрибут Тип
\n

Каждый слот должен иметь Тип, который соответствует сущности Тип = сущность. Этот тип определяет тип данных, которые попадут в слот. Вы можете использовать как системные, так и кастомные сущности.

\n

Например, для слота Date с типом @zb.datetime: слово \"сегодня\" из запроса клиента попадет в сущность @zb.datetime и будет помещено в слот Date.

\n

Если в интенте присутствует несколько слотов с одинаковым типом, то они будут заполнены последовательно.

\n

При необходимости обработать произвольное количество слотов одного типа в запросе или переменные с разными типами сущностей, обращайтесь к структуре $entities, в которую будут переданы все найденные сущности в исходном виде.

\n
\n
Атрибут Обязательность
\n

Каждый слот имеет атрибут Обязательность:

\n\n

Перед переходом к процессу слот-филлинга ознакомьтесь подробнее с заполнением слотов

\n
\n
Массивы в слотах
\n

Для обработки запросов с повторяющимися сущностями в сценарии необходимо в заполненном слоте $parseTree._<ИмяСлота> иметь массив.

\n

Переведите переключатель Массив в активное положение, чтобы в слот помещались все сущности данного типа, оформленные как массив:

\n

\n \n \n

\n

Если переключатель Массив:

\n\n
\n

Подключение модуля слот-филлинга

\n

Для подключения модуля слот-филлинга укажите в сценарии в файле main.sc:

\n
require: slotfilling/slotFilling.sc\r\n  module = sys.zb-common
\n
\n

Механизм обработки уточняющих вопросов

\n

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

\n

В ответах клиента будет производиться поиск сущностей, соответствующих слотам. Если подходящие сущности были найдены, то соответствующий слот будет заполнен.

\n

После того, как все слоты были заполнены, управление передается в основной сценарий со всеми заполненными слотами в $parseTree.

\n

Выйти из сценария слот-филлинга возможно только, либо ответив на все вопросы, либо командой /start.

\n

Рассмотрим сценарий:

\n
    state:\r\n        intent!: /Погода\r\n        a: Погода в {{ $parseTree._City }} на {{ $parseTree._Date.value }}
\n

При этом слоты заполнили следующим образом:

\n

\n \n \n

\n

Здесь @City — кастомная сущность, в которой мы указали все города, доступные для прогноза погоды.

\n

Запросы клиента:

\n
    \n
  1. Погода на завтра в Москве: слоты заполнены, бот сразу предоставит ответ.
    2. \n
  2. Погода на завтра: слот City не заполнен, будут заданы уточняющие вопросы. Как только будет дан корректный ответ, управление перейдет в сценарий, бот даст ответ.
    3. \n
  3. Погода в Москве: слот Date не заполнен, будут заданы уточняющие вопросы. Как только будет дан корректный ответ, управление перейдет в основной, бот даст ответ.
    4. \n
\n
\n

Прерывание слот-филлинга

\n

Условия прерывания процесса слот-филлинга вы можете сконфигурировать в файле chatbot.yaml в секции injector:

\n
injector:\r\n    slotfilling:\r\n        maxSlotRetries: 1\r\n        stopOnAnyIntent: true\r\n        stopOnAnyIntentThreshold: 0.2
\n

Здесь параметры:

\n\n
Прерывание по интенту
\n

Если stopOnAnyIntent: true и запросу клиента соответствует интент с параметром confidence выше, чем stopOnAnyIntentThreshold, слот-филлинг будет прерван по интенту.

\n

Параметр confidence — степень уверенности платформы JAICP, что введенная фраза относится к определенному интенту.

\n

Обратите внимание, что важно учитывать контекст начала слот-филлинга. Например, если при прерывании в стейт с соответствующим интентом невозможно попасть (например, тег intent не глобальный), то запрос попадет в event!: noMatch.

\n

Если параметры для прерывания в конфигурационном файле chatbot.yaml не указаны, слот-филлинг будет прерываться согласно параметрам по умолчанию:

\n
injector:\r\n    slotfilling:\r\n        maxSlotRetries: 2\r\n        stopOnAnyIntent: false\r\n        stopOnAnyIntentThreshold: 0.2
","frontmatter":{"title":"","description":null},"headings":[{"value":"Slot Filling"}]}},"pageContext":{"slug":"/docs/ru/NLU_core/slot_filling/","previous":{"fields":{"slug":"/docs/ru/NLU_functions/NLU_functions/"},"frontmatter":{"title":"","description":null}},"next":{"fields":{"slug":"/docs/ru/NLU_core/rule_activation/"},"frontmatter":{"title":"","description":null}}}}, "staticQueryHashes": ["1209419333"]}