Advanced pattern elements
$pattern_name
$pattern-name references a named pattern.
How to use
Pattern declaration:
patterns:
$thanks = (thank* [$you]|thx|great|hurray)
$ok = (okey|okay|o key|ok)
$you = (you|u)
Pattern usage in a script:
state: Thanks
q!: * $thanks
q!: * $ok *
q!: * everything is clear *
q!: i see [$thanks] *
script:
$reactions.answer("You are welcome.\nDo you have other questions?")
~lemma
~lemma checks all word forms. The word after the tilde should be in its dictionary form.
For example, the ~make pattern will match the words: make, makes, making, and made.
The rule is applied to all word forms of all homonyms: words that are spelled and pronounced alike but different in meaning or grammatical forms.
For example, the ~base pattern will match the noun and verb word forms (base, bases and based, basing).
How to use
state: Delivery
q!: * {(order/deliver/delivery) * [food|~dinner] * [$cafe]} * $City *
q: * $City *
script:
if (!$session.address) {
$session.address = {};
}
$session.address.city = $parseTree.City[0].value.name;
go!: ../../Delivery
$morph
The $morph<feature> element matches against a word with specific grammatical features.
The list of supported features depends on the bot engine used by the project.
botEngine: v1
Deprecated
The first version of the bot engine uses the AOT parser for morphological analysis. Use the tags for English and Russian to denote grammatical features. They should be put inside angle brackets and separated with spaces.
In this version, $morph also allows matching against one or several grammatical features at once.
For example, $morph<NOUN sg> (a singular noun) will match against words like cat, bank, or condition.
botEngine: v2
The second version of the bot engine only allows the $morph element to match against parts of speech.
Other grammatical features are not supported.
The format for part-of-speech tags depends on the tokenizer engine used by the project. In most cases, tags intended for one engine will not work properly for another.
| Tokenizer | Link to format description |
|---|---|
kaznlp | kaznlp |
morphsrus | pymorphy2 |
mystem | mystem |
pinyin | This engine does not support part-of-speech tagging. |
spacy | Universal Dependencies |
udpipe | Universal Dependencies |
How to use
Usually, the $morph element is employed to find matches against specific word combinations.
They can be hard to pin down with a simple enumeration of all their constituent words or word stems.
patterns:
# A pattern for street names like “Oxford street”
$street = $morph<PROPN> (st/str/street)
theme: /Jokes
state: Address
q!: * I live on * $street *
a: Why, really! And I live in the Server Quarter.
$regexp and $regexp_i
With $regexp<expression> or $regexp_i<expression>, you can use regular expressions.
In the element, specify an expression that describes a certain set of strings. The expression consists of literals and metacharacters. They are characters with special, not literal meaning.
The elements are triggered by all strings that match the expression. The features of the elements:
$regexpis case-sensitive. It is also available as$regex.$regexp_iis case-insensitive.- By default, the elements ignore the special characters and punctuation marks before and after the expression.
For example, the
$regexp<Hello>element will be triggered byHello!. You can change this behaviour in thechatbot.yamlconfiguration file.
How to use
Declaration of a pattern to match any word in the request:
patterns:
$anyWord = $regexp<.+>
Declaration of a pattern to match percentages:
patterns:
$percent = $regexp<\b([0-9][0-9]?%?)\b|\b100%?\b>
$entity
$entity<named entity> converts a named entity into a pattern.
How to use
Named pattern declaration:
$roamingRegion = $entity<RoamingRegions> || converter = RoamingRegionTagConverter
If a pattern is created with $entity<> and converter, its name must not match the name of an NLU core entity.
For example, if a project has an $Example pattern and an Example entity, it might cause errors during the script execution.
How to use in a script:
state: Problems
q!: * {$problems * roaming} *
q!: * {$someProblems * $roamingRegion} *
script:
$temp.messageForAgent = 'The client has some problems with roaming';
a: Please, wait a moment. I will call a specialist to answer your question.
go!: /TransferToAgent
Here, RoamingRegions is a dictionary name, RoamingRegionTagConverter is a converter name.
$parseTree gets the value property which is usually used to hold a dictionary identifier or value.$entity rule writes only the entity identifier into value. The list of associated values is stored in the dictionary.$Pattern: Alias
$Pattern::Alias allows you to specify an alias for the token, under which the token will be placed in $parseTree.
How to use
Consider the $Number::Hour example: the $Number pattern will be interpreted as Hour in parseTree.
Script:
q!: I’ll come at $Number::Hour
User request:
I’ll come at 7
Parse tree:
{
"tag": "root",
"pattern": "root",
"text": "I’ll come at 7",
"words": [
"i",
"’ll",
"come",
"at",
"7"
],
"Hour": [
{
"tag": "Hour",
"pattern": "Number",
"text": "7",
"words": [
"7"
]
}
],
"_Hour": "7",
}
The parse tree without using an alias for the q!: I’ll come at $Number script is:
{
"tag": "root",
"pattern": "root",
"text": "I’ll come at 7",
"words": [
"i",
"’ll",
"come",
"at",
"7"
],
"Number": [
{
"tag": "Number",
"pattern": "Number",
"text": "7",
"words": [
"7"
]
}
],
"_Number": "7",
}
An example of $Pattern::Alias usage:
state: Example
q!: $Number::minuend minus $Number::subtrahend
q!: subtract $Number::subtrahend from $Number::minuend
a: {{ $parseTree._minuend - $parseTree._subtrahend }}
Here, the meaning of $Number depends on the position in the query: either the first or the second number can be a subtrahend.
(one: 1 | two: 2 …)
(one:1 | two:2 …) is a mapping of different semantics. It allows you to set a value for a particular phrase.
This value is written in the value property of $parseTree for the pattern that has been used to declare the mapping.
How to use
Pattern declaration:
$price = ((free|zero|0):0|(seven|7):7|(two hundreds|200):200) [dollars]
Script:
q!: {activate service ([for] $price)}
User request:
Activate free service
Parse tree:
{
"tag": "root",
"pattern": "root",
"text": "Activate free service",
"words": [
"activate",
"free",
"service"
],
"price": [
{
"tag": "price",
"pattern": "price",
"text": "free",
"words": [
"free"
],
"value": "0"
}
]
}
$repeat
$repeat<named pattern> is a nested pattern that can be repeated in a text for an unlimited number of times.
Repeat can contain only named pattern like $repeat<$Number> error.How to use
patterns:
$color = (red/white/blue/green/yellow/black)
theme: /
state: asd
q!: my favorite color* (is/are) $repeat<$color>
if: $parseTree.color.length > 1
a: Wow! You like {{ $parseTree.color.length }} colors
else:
a: Why {{ $parseTree._color }}?
$oneWord
$oneWord is any word, number, or character.
This named pattern is available in any project without declaration.
How to use
state: Dialog
q!: * $you * not ~understand * !
q!: [$oneWord] is not what i [have] ~mean
go!: /CatchAll/CatchALLState
$nonEmptyGarbage
$nonEmptyGarbage is arbitrary text.
It differs from the * pattern in that the text must contain at least one character and it cannot be a punctuation mark.
This named pattern is available in any project without declaration.
How to use
$Text = * $nonEmptyGarbage * || converter = $converters.textConverter
state: Action
q: $nonEmptyGarbage
go!: /NextStep