NER component </components/ner>
Based on neural Named Entity Recognition network. The NER component reproduces architecture from the paper Application of a Hybrid Bi-LSTM-CRF model to the task of Russian Named Entity Recognition which is inspired by Bi-LSTM+CRF architecture from https://arxiv.org/pdf/1603.01360.pdf.
| Dataset |
|
Persons-1000 dataset with additional LOC and ORG markup <ner/ner_rus.json> |
|
DSTC 2 <ner/ner_dstc2.json> |
|
OntoNotes <ner/ner_ontonotes.json> |
|
Slot filling components </components/slot_filling>
Based on fuzzy Levenshtein search to extract normalized slot values from text. The components either rely on NER results or perform needle in haystack search.
| Dataset |
|
DSTC 2 <ner/slotfill_dstc2.json> |
|
Classification component </components/classifiers>
Component for classification tasks (intents, sentiment, etc) on word-level. Shallow-and-wide CNN, Deep CNN, BiLSTM, BiLSTM with self-attention and other models are presented. The model also allows multilabel classification of texts. Several pre-trained models are available and presented in Table below.
| Dataset | Model | Task | Lang | Metric | Valid | Test |
| DSTC 2 | DSTC 2 on DSTC 2 embeddings <classifiers/intents_dstc2.json> |
28 intents | En | Accuracy | 0.7732 | 0.7868 |
| DSTC 2 | DSTC 2 on Wiki embeddings <classifiers/intents_dstc2_big.json> |
28 intents | En | Accuracy | 0.9602 | 0.9593 |
| SNIPS-2017 | SNIPS on DSTC 2 embeddings <classifiers/intents_snips.json> |
7 intents | En | F1 | 0.8664 |
|
| SNIPS-2017 | SNIPS on Wiki embeddings <classifiers/intents_snips_big.json> |
7 intents | En | F1 | 0.9808 |
|
| Insults | InsultsKaggle on Reddit embeddings <classifiers/insults_kaggle.json> |
Insult detection | En | ROC-AUC | 0.9271 | 0.8618 |
| AG News | AG News on Wiki embeddings <classifiers/topic_ag_news.json> |
5 topics | En | Accuracy | 0.8876 | 0.9011 |
| Twitter mokoron | Twitter on RuWiki+Lenta embeddings without any preprocessing <classifiers/sentiment_twitter.json> |
Sentiment | Ru | Accuracy | 0.9972 | 0.9971 |
| Twitter mokoron | Twitter on RuWiki+Lenta embeddings with preprocessing <classifiers/sentiment_twitter_preproc.json> |
Sentiment | Ru | Accuracy | 0.7811 | 0.7749 |
| RuSentiment | RuSentiment on RuWiki+Lenta embeddings <classifiers/rusentiment_cnn.json> |
Sentiment | Ru | F1 | 0.6393 | 0.6539 |
As no one had published intent recognition for DSTC-2 data, the comparison of the presented model is given on SNIPS dataset. The evaluation of model scores was conducted in the same way as in [3] to compare with the results from the report of the authors of the dataset. The results were achieved with tuning of parameters and embeddings trained on Reddit dataset.
+------------------------+-----------------+------------------+---------------+--------------+--------------+----------------------+------------------------+ | Model | AddToPlaylist | BookRestaurant | GetWheather | PlayMusic | RateBook | SearchCreativeWork | SearchScreeningEvent | +========================+=================+==================+===============+==============+==============+======================+========================+ | api.ai | 0.9931 | 0.9949 | 0.9935 | 0.9811 | 0.9992 | 0.9659 | 0.9801 | +------------------------+-----------------+------------------+---------------+--------------+--------------+----------------------+------------------------+ | ibm.watson | 0.9931 | 0.9950 | 0.9950 | 0.9822 | 0.9996 | 0.9643 | 0.9750 | +------------------------+-----------------+------------------+---------------+--------------+--------------+----------------------+------------------------+ | microsoft.luis | 0.9943 | 0.9935 | 0.9925 | 0.9815 | 0.9988 | 0.9620 | 0.9749 | +------------------------+-----------------+------------------+---------------+--------------+--------------+----------------------+------------------------+ | wit.ai | 0.9877 | 0.9913 | 0.9921 | 0.9766 | 0.9977 | 0.9458 | 0.9673 | +------------------------+-----------------+------------------+---------------+--------------+--------------+----------------------+------------------------+ | snips.ai | 0.9873 | 0.9921 | 0.9939 | 0.9729 | 0.9985 | 0.9455 | 0.9613 | +------------------------+-----------------+------------------+---------------+--------------+--------------+----------------------+------------------------+ | recast.ai | 0.9894 | 0.9943 | 0.9910 | 0.9660 | 0.9981 | 0.9424 | 0.9539 | +------------------------+-----------------+------------------+---------------+--------------+--------------+----------------------+------------------------+ | amazon.lex | 0.9930 | 0.9862 | 0.9825 | 0.9709 | 0.9981 | 0.9427 | 0.9581 | +------------------------+-----------------+------------------+---------------+--------------+--------------+----------------------+------------------------+ +------------------------+-----------------+------------------+---------------+--------------+--------------+----------------------+------------------------+ | Shallow-and-wide CNN | 0.9956 | 0.9973 | 0.9968 | 0.9871 | 0.9998 | 0.9752 | 0.9854 | +------------------------+-----------------+------------------+---------------+--------------+--------------+----------------------+------------------------+
Goal-oriented bot </skills/go_bot>
Based on Hybrid Code Networks (HCNs) architecture from Jason D. Williams, Kavosh Asadi, Geoffrey Zweig, Hybrid Code Networks: practical and efficient end-to-end dialog control with supervised and reinforcement learning – 2017. It allows to predict responses in goal-oriented dialog. The model is customizable: embeddings, slot filler and intent classifier can be switched on and off on demand.
Available pre-trained models:
| Dataset & Model | Valid turn accuracy | Test turn accuracy |
|---|---|---|
DSTC2, bot with slot filler & intents <go_bot/gobot_dstc2.json> |
0.5288 | 0.5248 |
DSTC2, bot with slot filler & embeddings & attention <go_bot/gobot_dstc2_best.json> |
|
0.5551 |
Other benchmarks on DSTC2 (can't be directly compared due to dataset modifications </skills/go_bot>):
| Dataset & Model | Test turn accuracy |
|---|---|
| DSTC2, Bordes and Weston (2016) | 0.411 |
| DSTC2, Perez and Liu (2016) | 0.487 |
| DSTC2, Eric and Manning (2017) | 0.480 |
| DSTC2, Williams et al. (2017) | 0.556 |
Seq2seq goal-oriented bot </skills/seq2seq_go_bot>
Dialogue agent predicts responses in a goal-oriented dialog and is able to handle multiple domains (pretrained bot allows calendar scheduling, weather information retrieval, and point-of-interest navigation). The model is end-to-end differentiable and does not need to explicitly model dialogue state or belief trackers.
Comparison of deeppavlov pretrained model with others:
| Dataset & Model | Valid BLEU | Test BLEU |
|---|---|---|
Kvret, KvretNet <go_bot/gobot_dstc2.json> |
0.1319 | 0.1328 |
| Kvret, KvretNet, Mihail Eric et al. (2017) | -- | 0.132 |
| Kvret, CopyNet, Mihail Eric et al. (2017) | -- | 0.110 |
| Kvret, Attn Seq2Seq, Mihail Eric et al. (2017) | -- | 0.102 |
| Kvret, Rule-based, Mihail Eric et al. (2017) | -- | 0.066 |
- :doc:Automatic spelling correction component </components/spelling_correction>
Pipelines that use candidates search in a static dictionary and an ARPA language model to correct spelling errors.
Comparison on the test set for the SpellRuEval competition on Automatic Spelling Correction for Russian:
| Correction method | Precision | Recall | F-measure | Speed (sentences/s) |
|---|---|---|---|---|
| Yandex.Speller | 83.09 | 59.86 | 69.59 | 5. |
Damerau Levenshtein 1 + lm<spelling_correction/levenshtein_corrector_ru.json> |
53.26 | 53.74 | 53.50 | 29.3 |
Brill Moore top 4 + lm<spelling_correction/brillmoore_kartaslov_ru.json> |
51.92 | 53.94 | 52.91 | 0.6 |
| Hunspell + lm | 41.03 | 48.89 | 44.61 | 2.1 |
| JamSpell | 44.57 | 35.69 | 39.64 | 136.2 |
Brill Moore top 1 <spelling_correction/brillmoore_kartaslov_ru_nolm.json> |
41.29 | 37.26 | 39.17 | 2.4 |
| Hunspell | 30.30 | 34.02 | 32.06 | 20.3 |
Ranking component </components/neural_ranking>
Based on LSTM-based deep learning models for non-factoid answer selection. The model performs ranking of responses or contexts from some database by their relevance for the given context.
Available pre-trained models for ranking:
| Dataset | Model config | Validation (Recall@1) | Test1 (Recall@1) |
|---|---|---|---|
| InsuranceQA V1 | ranking_insurance_interact <ranking/ranking_insurance_interact.json> |
|
|
| Ubuntu V2 | ranking_ubuntu_v2_interact <ranking/ranking_ubuntu_v2_interact.json> |
|
|
| Ubuntu V2 | ranking_ubuntu_v2_mt_interact <ranking/ranking_ubuntu_v2_mt_interact.json> |
|
|
Available pre-trained models for paraphrase identification:
| Dataset | Model config | Val (accuracy) | Test (accuracy) | Val (F1) | Test (F1) | Val (log_loss) | Test (log_loss) |
|---|---|---|---|---|---|---|---|
| paraphraser.ru | paraphrase_ident_paraphraser <ranking/paraphrase_ident_paraphraser_interact.json> |
|
|
|
|
|
|
| Quora Question Pairs | paraphrase_ident_qqp <ranking/paraphrase_ident_qqp_bilstm_interact.json> |
|
|
|
|
|
|
| Quora Question Pairs | paraphrase_ident_qqp <ranking/paraphrase_ident_qqp_interact.json> |
|
|
|
|
|
|
Comparison with other models on the InsuranceQA V1:
| Model | Validation (Recall@1) | Test1 (Recall@1) |
|---|---|---|
| Architecture II (HLQA(200) CNNQA(4000) 1-MaxPooling Tanh) | 61.8 | 62.8 |
| QA-LSTM basic-model(max pooling) | 64.3 | 63.1 |
ranking_insurance <ranking/ranking_insurance_interact.json> |
72.0 | 72.2 |
Question Answering component </components/squad>
Based on R-NET: Machine Reading Comprehension with Self-matching Networks. The model solves the task of looking for an answer on a question in a given context (SQuAD task format).
|
Model config |
|
|
| SQuAD-v1.1 | squad <squad/squad.json> |
|
|
|
squad_ru <squad/squad_ru.json> |
|
|
In the case when answer is not necessary present in given context we have squad_noans <squad/multi_squad_noans.json> model. This model outputs empty string in case if there is no answer in context.
Morphological tagging component </components/morphotagger>
Based on character-based approach to morphological tagging Heigold et al., 2017. An extensive empirical evaluation of character-based morphological tagging for 14 languages. A state-of-the-art model for Russian and several other languages. Model takes as input tokenized sentences and outputs the corresponding sequence of morphological labels in UD format. The table below contains word and sentence accuracy on UD2.0 datasets. For more scores see full table </components/morphotagger>.
Frequently Asked Questions (FAQ) component </skills/faq>
Set of pipelines for FAQ task: classifying incoming question into set of known questions and return prepared answer. You can build different pipelines based on: tf-idf, weighted fasttext, cosine similarity, logistic regression.
eCommerce bot </skills/ecommerce_bot_skill>
The eCommerce bot intends to retrieve product items from catalog in sorted order. In addition, it asks an user to provide additional information to specify the search.
ODQA </skills/odqa>
An open domain question answering skill. The skill accepts free-form questions about the world and outputs an answer based on its Wikipedia knowledge.
| Dataset |
|
|
SQuAD (dev) <odqa/en_odqa_infer_wiki.json> |
enwiki (2018-02-11) |
|
Hyperparameters optimization </intro/hypersearch>
Hyperparameters optimization (either by cross-validation or neural evolution) for DeepPavlov models that requires only some small changes in a config file.
Pre-trained embeddings for the Russian language </intro/pretrained_vectors>
Word vectors for the Russian language trained on joint Russian Wikipedia and Lenta.ru corpora.
Run goal-oriented bot with Telegram interface:
python -m deeppavlov interactbot deeppavlov/configs/go_bot/gobot_dstc2.json -d -t <TELEGRAM_TOKEN>Run goal-oriented bot with console interface:
python -m deeppavlov interact deeppavlov/configs/go_bot/gobot_dstc2.json -dRun goal-oriented bot with REST API:
python -m deeppavlov riseapi deeppavlov/configs/go_bot/gobot_dstc2.json -dRun slot-filling model with Telegram interface:
python -m deeppavlov interactbot deeppavlov/configs/ner/slotfill_dstc2.json -d -t <TELEGRAM_TOKEN>Run slot-filling model with console interface:
python -m deeppavlov interact deeppavlov/configs/ner/slotfill_dstc2.json -dRun slot-filling model with REST API:
python -m deeppavlov riseapi deeppavlov/configs/ner/slotfill_dstc2.json -dPredict intents on every line in a file:
python -m deeppavlov predict deeppavlov/configs/classifiers/intents_snips.json -d --batch-size 15 < /data/in.txt > /data/out.txt
View video demo of deployment of a goal-oriented bot and a slot-filling model with Telegram UI.