Перейти к основному содержимому

Расширенные элементы паттернов

$pattern_name

$название-паттерна — ссылка на именованный паттерн.

Использование в сценарии

Объявление паттерна:

patterns:
$thanks = (спасибо [и] [тебе|вам] [большое]|благодар*|спс|супер|супир|ура|отлично|молод*|умни*|пасиб*)
$ok = (окей|ок|okey|okay|o key|ok)
$you = (ты|вы|тебе|вам|тебя|тя|тибя|вас)
$my = (мой|моя|мое|моё|мае|маё|мне|мои|маи|мою|маю|моне|мане|манё|монё|меня|миня|моих|маих|моим|маим|моем|маем|моём|маём|мя|ма|мня|[со] мной)

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

state: Thanks
q!: * $thanks
q!: * $ok *
q!: * {мне (понятно|понятненько|ясно|ясненько) [все|всё]} *
q!: * {(понятно|понятненько|ясно|ясненько) (все|всё)} *
q!: * [премного] благодарн* *
script:
$reactions.answer("Рад помочь.\nОстались ли у вас еще вопросы?")

~lemma

~lemma проверяет все формы слова. Слово после тильды должно стоять в словарной форме.

Например, в паттерн ~яблоко попадут слова: яблоки, яблок и др.

Правило срабатывает на всех словоформах всех омонимов: слов, которые звучат и пишутся одинаково, но имеют разные значения или морфологическую форму.

Например, паттерн ~печь сработает на словоформах существительного печь (печи, печью) и глагола печь (пеку, печешь).

подсказка
Из-за морфологического разнообразия языка использование этого паттерна может приводить к ложноположительным результатам.

Использование в сценарии

state: Delivery
q!: * {(заказать/заказывать/заказ/~доставка/доставляете) [~еда] * [$cafe]} * $City *
q: * $City *
script:
if (!$session.address) {
$session.address = {};
}
$session.address.city = $parseTree.City[0].value.name;
go!: ../../Delivery

$morph

Элемент $morph<свойство> проверяет совпадение по слову с определенными грамматическими свойствами. Список поддерживаемых свойств зависит от того, какой диалоговый движок использует проект.

botEngine: v1

Устарело

На первой версии диалогового движка для морфологического анализа используется парсер AOT. Используйте для грамматических свойств условные обозначения для русского и английского языка. Указывайте их внутри угловых скобок через пробел.

Кроме того, на этой версии $morph позволяет проверить совпадение по одному или сразу по нескольким свойствам. Например, элемент $morph<С им ед> (существительное в именительном падеже и единственном числе) даст совпадения со словами кошка, банк, условие и т. д.

botEngine: v2

На второй версии диалогового движка через элемент $morph можно указать только совпадение по частям речи. Другие грамматические свойства не поддерживаются.

Формат обозначений для частей речи зависит от того, какой движок токенизации использует проект. Обозначения, указанные под один движок, в большинстве случаев не будут работать для другого.

ТокенизаторСсылка на описание формата
kaznlpkaznlp
morphsruspymorphy2
mystemmystem
pinyinДвижок не поддерживает частеречную разметку.
spacyUniversal Dependencies
udpipeUniversal Dependencies

Использование в сценарии

Элемент $morph обычно используется для поиска совпадений по специфическим словосочетаниям. Их сложно описать простым перечислением слов или корней слов, которые могут в них входить.

patterns:
# Паттерн для обозначений улиц
$street = (
# Первая Советская
@duckling.number $morph<П>
# Большая Ордынка
| $morph<П им> $morph<С им>
# 70 лет (Великого) Октября / ВЛКСМ
| @duckling.number лет [$morph<П>] ($morph<рд>/$morph<аббр>)
)

theme: /Jokes

state: Address
q!: * [я] живу на * $street *
a: Здорово! А я на Большой Серверной.

$regexp/regexp_i

$regexp/regexp_i<литералы и метасимволы> — регулярное выражение — шаблон, описывающий некий набор строк. Шаблон состоит из литералов и метасимволов — символов со специальным, а не буквальным значением. В $regexp или $regexp_i будут попадать строки, соответствующие шаблону.

$regexp — чувствительный к регистру букв, $regexp_i — нечувствительный. Оба элемента нечувствительны к использованию буквы е вместо ё и наоборот.

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

Использование в сценарии

Объявление паттерна для обнаружения любого слова в запросе:

patterns:
$anyWord = $regexp<.+>

Объявление паттерна для обнаружения процентного значения:

patterns:
$percent = $regexp<\b([0-9][0-9]?%?)\b|\b100%?\b>

$entity

$entity<именованная сущность> преобразует в паттерн именованную сущность.

Использование в сценарии

Объявление именованного паттерна:

$roamingRegion = $entity<RoamingRegions> || converter = RoamingRegionTagConverter
предупреждение

Если паттерн создан с помощью $entity<> и converter, его название не должно совпадать с названием сущности NLU-ядра. Например, если в проекте есть паттерн $Example и сущность Example, то это может привести к ошибкам при выполнении сценария.

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

state: Проблемы
q!: *{$problems * роуминг*}*
q!: *{$someProblems * $roamingRegion}*
script:
$temp.messageForOperator = 'Пользователь испытывает проблемы с роумингом';
a: По этому вопросу Вас может проконсультировать специалист.
go!: /ПереключениеНаОператора

Здесь RoamingRegions — название справочника, RoamingRegionTagConverter — название конвертера.

предупреждение
При подобном объявлении именованного паттерна в $parseTree появляется элемент value, куда обычно записывается id или значение из справочника.
подсказка
Правило $entity записывает в value только идентификатор сущности, а список ассоциированных значений содержится в справочнике.

$Pattern: Alias

$Pattern::Alias — позволяет задать псевдоним для токена, под которым токен будет помещен в $parseTree.

Использование в сценарии

Рассмотрим пример $Number::Hour: паттерн $Number будет интерпретироваться в parseTree как Hour.

Сценарий:

q!: я приду в $Number::Hour

Запрос пользователя:

Я приду в 7

Дерево разбора:

{
"tag": "root",
"pattern": "root",
"text": "я приду в 7",
"words": [
"я",
"приду",
"в",
"7"
],
"Hour": [
{
"tag": "Hour",
"pattern": "Number",
"text": "7",
"words": [
"7"
]
}
],
"_Hour": "7",
}

Дерево разбора без использования псевдонима для сценария q!: я приду в $Number имеет вид:

{
"tag": "root",
"pattern": "root",
"text": "я приду в 7",
"words": [
"я",
"приду",
"в",
"7"
],
"Number": [
{
"tag": "Number",
"pattern": "Number",
"text": "7",
"words": [
"7"
]
}
],
"_Number": "7",
}

Практичный прием использования $Pattern::Alias:

state: Example
q!: сколько будет $Number::minuend минус $Number::subtrahend
q!: вычти $Number::subtrahend из $Number::minuend
a: {{ $parseTree._minuend - $parseTree._subtrahend }}

Здесь смысл $Number зависит от положения в запросе: вычитаемое может быть названо первым или вторым числом.

(один: 1 | два: 2 …​)

(один:1 | два:2 …​) — соответствие различных семантик, позволяет задать значение для той или иной фразы. Указанное значение записывается в поле value для $parseTree того паттерна, в котором соответствие объявлено.

Использование в сценарии

Объявление паттерна:

$price = ((бесплатн*|ноль|0):0|(семь|7):7|(двести|200):200) [руб*]

Сценарий:

q!: {подключить услугу [за] $price}

Запрос пользователя:

Подключить бесплатную услугу

Дерево разбора:

{
"tag": "root",
"pattern": "root",
"text": "Подключить бесплатную услугу",
"words": [
"подключить",
"бесплатную",
"услугу"
],
"price": [
{
"tag": "price",
"pattern": "price",
"text": "бесплатную",
"words": [
"бесплатную"
],
"value": "0"
}
]
}

$repeat

$repeat<именованный паттерн> — вложенный паттерн может повторяться в тексте неограниченное количество раз.

предупреждение
Использовать можно только именованные паттерны. Иначе будет появляться ошибка: Repeat can contain only named pattern like $repeat<$Number>.

Использование в сценарии

patterns:
$color = (красный/белый/синий/зеленый/желтый/черный)

theme: /
state: asd
q!: (мой/мои) любимы* цвет* это $repeat<$color>
if: $parseTree.color.length > 1
a: Ого! Целых {{ $parseTree.color.length }}
else:
a: Почему именно {{ $parseTree._color }}?

$oneWord

$oneWord — любое слово, число или символ.

Этот именованный паттерн доступен в любом проекте без объявления.

Использование в сценарии

state: Dialog
q!: * $you * [меня] * не (понимае*|поняла|поняли) * !
q!: [$oneWord] не то
go!: /CatchAll/CatchALLState

$nonEmptyGarbage

$nonEmptyGarbage — произвольный текст.

Отличие от паттерна * в том, что текст не может быть пустым, а также знаком препинания.

Этот именованный паттерн доступен в любом проекте без объявления.

Использование в сценарии

$Text = * $nonEmptyGarbage * || converter = $converters.textConverter
state: Action
q: $nonEmptyGarbage
go!: /NextStep