AMUP

AMUP - Artificial Machine Understanding Plataform is a project that modifies the entire NLP.js implementation to create conversational contexts. Making it easy to develop and create chatbots that support process, tokenize, categorize intents, and extract text entities in multiple languages. The project supports multiple levels of conversational context through the synthesis of multiple agents.

Currently supporting:

• Guess the language of a phrase
• Fast Levenshtein distance of two strings
• Search the best substring of a string with less Levenshtein distance to a given pattern.
• Get stemmers and tokenizers for several languages.
• Sentiment Analysis for phrases (with negation support).
• Named Entity Recognition and management, multi-language support, and acceptance of similar strings, so the introduced text does not need to be exact.
• Natural Language Processing Classifier, to classify an utterance into intents.
• NLP Manager: a tool able to manage several languages, the Named Entities for each language, the utterances, and intents for the training of the classifier, and for a given - utterance return the entity extraction, the intent classification and the sentiment analysis. Also, it is able to maintain a Natural Language Generation Manager for the answers.
• 40 languages natively supported.
• Any other language is supported through tokenization, even fantasy languages

Installation

Clone project

git clone github.com/maximilianoveiga/amup

Install dependencies

npm install

Usage

Contents

• Intent
• Response

Intent

{
    "id": "QzsqN5RrljKxCdyBq1iacz",
    "name": "Welcome Intent",
    "slug": "welcome",
    "webhookUsed": false,
    "fallbackIntent": false,
    "endInteraction": false,
    "priority": 500000,
    "utterances": [
        "Olá",
        "Oi",
        "Eaí",
        "Eae",
        "Bom dia",
        "Boa tarde",
        "Boa noite"
    ],
    "inputContexts": [],
    "outputContexts": [],
    "responses": [
        {
            "parameters": [],
            "message": [
                {
                    "type": "message",
                    "platform": "telegram",
                    "text": [
                        "Olá, $name! Seja bem-vindo(a) ao chatbot! Como posso te ajudar hoje?"
                    ]
                }
            ]
        }
    ]
}

This document represents an intention. It has several tags that help the library process and create the intent responses.

Example

Request

curl --location --request GET 'localhost:3000/detectIntent?text=olá&sessionId=xbwpe1ns8XyDbQBZ35Jp3r'

Session is optional, if passed it is used by the project to determine conversation state in conversational contexts.

Response

{
    "id": "oSU8T5Hsp6oH8JMdiDMEVN",
    "endInteraction": false,
    "fulfillmentText": "Olá, Max! Seja bem-vindo(a) ao chatbot! Como posso te ajudar hoje?",
    "utterance": "Olá!",
    "languageCode": "br",
    "confidence": 1,
    "entities": [],
    "webhook": {
        "webhookUsed": false
    },
    "parameters": {},
    "inputContexts": [],
    "outputContexts": [],
    "messages": [
        {
            "text": "Olá, Max! Seja bem-vindo(a) ao chatbot! Como posso te ajudar hoje?"
        }
    ],
    "sentimentAnalysisResult": {
        "queryTextSentiment": {
            "score": 0,
            "type": "afinn",
            "vote": "neutral"
        }
    },
    "intent": {
        "isFallback": false,
        "displayName": "Welcome Intent",
        "endInteraction": false,
        "id": "rDXkEvyke4rDLg15dbyFdy"
    }
}