Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- wiki:software:beuthbot:registry [23.01.2020 11:02]
Timo Bruns
+++ wiki:software:beuthbot:registry [23.01.2020 15:32] (aktuell)
Timo Bruns
@@ Zeile 1: / Zeile 1: @@
 ===== Registry  =====
-The **gateway** itself is the core microservice of our application. It represents the top (first) layer in our system architecture and has a direct bidirectional interface to [[https://telegram.org/|Telegram]]. The main functionality of the gateway is to receive and handle all incoming user requests. Once a user is interacting with our bot - doesn't matter whether the user communicates via text or voice message - all requests are going to be passed on to the gateway.
+The **registry** is part of the BeuthBot microservice system.Here the evaluated messages arrive and it is decided which service should be used. The reply from the service is forwarded to the gateway.
 ==== Table Of Content ====
+   - [[wiki:software:beuthbot:registry#registry|Registry]]
-	- [[wiki:software:beuthbot:gateway#gateway|Gateway]]
+   - [[wiki:software:beuthbot:registry#table of content|Table Of Content]]
-	- [[wiki:software:beuthbot:gateway#table of content|Table Of Content]]
+   - [[wiki:software:beuthbot:registry#getting_started|Getting Started]]
-	- [[wiki:software:beuthbot:gateway#getting started|Getting Started]]
+    - [[wiki:software:beuthbot:registry#prerequisites|Prerequisites]]
-		- [[wiki:software:beuthbot:gateway#prerequisites|Prerequisites]]
+    - [[wiki:software:beuthbot:registry#cloning|Cloning]]
-		- [[wiki:software:beuthbot:gateway#setup|Setup]]
+    - [[wiki:software:beuthbot:registry#installing|Installing]]
-		- [[wiki:software:beuthbot:gateway#references|References]]
+   - [[wiki:software:beuthbot:registry#overview|Overview]]
-	- [[wiki:software:beuthbot:gateway#overview|Overview]]
+   - [[wiki:software:beuthbot:registry#structure|Structure]]
-	- [[wiki:software:beuthbot:gateway#structure|Structure]]
+   - [[wiki:software:beuthbot:registry#functionalities|Functionalities]]
-	- [[wiki:software:beuthbot:gateway#functionalities|Functionalities]]
+   - [[wiki:software:beuthbot:registry#further_development|Further Development]]
-		- [[wiki:software:beuthbot:gateway#variables|Variables]]
+   - [[wiki:software:beuthbot:registry#further_reading|Further Reading]]
-		- [[wiki:software:beuthbot:gateway#api-call|API-Call]]
+   - [[wiki:software:beuthbot:registry#built_with|Built With]]
-		- [[wiki:software:beuthbot:gateway#microsoft azure - cognitive services - headers|Microsoft Azure - Cognitive Services - Headers]]
+   - [[wiki:software:beuthbot:registry#versioning|Versioning]]
-		- [[wiki:software:beuthbot:gateway#server|Server]]
+   - [[wiki:software:beuthbot:registry#authors|Authors]]
-	- [[wiki:software:beuthbot:gateway#further development|Further Development]]
-	- [[wiki:software:beuthbot:gateway#further reading|Further Reading]]
-	- [[wiki:software:beuthbot:gateway#built with|Built With]]
-	- [[wiki:software:beuthbot:gateway#Versioning|Versioning]]
-	- [[wiki:software:beuthbot:gateway#Authors|Authors]]
 ==== Getting Started ====
-The following sections will give an overview how the gateway was created. It is strongly recommended to read [[https://core.telegram.org/bots|Telegrams bot introduction for developers]] to get a better insight what we are talking about in this context.\\
-\\
-Every time a [[https://telegram.org/|Telegram]] bot receives a message, the bot forwards this message in form of an API call to a corresponding server that handles all incoming messages. Once this is done, the server processes the request and a response will be generated that will go back to the user. In general there are two ways to get notified about incoming messages:\\
-\\
-. //Long polling//\\
-. //Webhooks//
-Within this project we are going to use webhooks.
 === Prerequisites ===
-Since the gateway is built from scratch there are no specific requirements or dependencies.
+- [[https://nodejs.org/en/|node.js]] \\
+- [[https://expressjs.com/|express.js]]\\
+- [[https://www.npmjs.com/package/axios| axios]]
-[//Appendum:// We decided to establish the server using [[https://nodejs.org/en/|node.js]]. That's why an installation of node and npm is necessary.]
+=== Cloning ===
-:!: FIXME FIXME FIXME
+Get the source code by cloning its repository via https: [[https://github.com/beuthbot/registry|Registry]]
-=== Telegram Bot ===
-As mentioned [[wiki:software:beuthbot:gateway#gateway|here]] our gateway is directly connected to the bot. Therefore the creation of a Telegram bot is necassary before it comes to the actual implementation. For test purposes an onw [[https://telegram.org/|Telegram]] has been created as part of preparing the gateway implementation. It is reachable via ''cbeuthbot'' on [[https://telegram.org/|Telegram]]. The created bot does not have any kind dependecies to the productive ''BeuthBot'' and is completely autonomous. This means that the system architecture is intended to be as flexible as possible to enable a simple addition or removel of different types of bots.
+=== Installing ===
-=== Set Up ===
+After cloning the repository, you will need to make sure that you have node and npm installed on your working system. To check if you already have node installed, try
-Once a [[https://telegram.org/|Telegram]] bot has been created and configured, we started to initialize a local project in a first step. Therefore a project directory has been set up as well as a ''> npm init'' has been executed in this directory. After this step a ''package.json'' has been created automatically. On top of that, ''express'', ''axios'' and ''body-parser'' have been installed via ''> npm install''. In this context ''express'' is our application server, ''axios'' is an ''HTTP'' client and ''body-parser'' helps to parse the response body received from each request. As soon as these components have been succesfully installed we created our actual **gateway** - first simply named ''index.js''.\\
+''node --version''
-\\
-The content of this file was looking very rudimentary in the beginning. It simply repsents a 'Ping-Pong' service at this point. This means, if a user writes a message that includes e.g. the word 'ping' our gateway creates a response with the word 'pong'. The answer will be sent back to the user by using the chat-id. Additionally we established ''3000'' as our port for communicating.\\
-\\
-At this point we were able to run our server locally by typing in ''> node index.js''. But a local server implies that the bot cannot call an API. It is desperate need of a public domain name. This means we have to deploy our application with [[https://zeit.co/|ZEIT]].\\
-\\
-Once this is done we have to let telegram know that our bot has to talk to this url whenver it receives any message in a last step. This get managed through ''cURL''.
-=== References ===
+Same for checking if npm is installed, just with npm instead of the node command
-During the implementation of the **gateway** we used [[https://www.sohamkamani.com/blog/2016/09/21/making-a-telegram-bot/|this manual]] as a kind of orientation.
+''npm --version''
-==== Overview ====
+If you don't have node or npm installed, download the Softare via the links provided in [[wiki:software:beuthbot:registry#prerequisites|Prerequisites]] or search for them via your preferred search engine.
-The **gateway** we built is able to receive incoming messages from our bot and also standardizes (since there is no guarantee for uniform requests, all incoming messages are getting standardized in a very first step) all requests. Once this is done, the **gateway** calls one or more of our NLU interfaces to evaluate the message text. This is done via ''HTTP-POST'' and ''json''. The evaluation of our message (score determining) can be done separately or together with the text analysis. E.g. when using ''Microsoft Azure Cognitive Services'' we transfer our messages with all relevant parameters and as a result out ''HTTP-POST'' delivers the score, entities, key words etc. in form of a ''json'' object. With this result we continue to call the API of our "next" microservice (in this case the ''registry'') and pass on all relevant values.
+After that install all necessesary dependencies
-==== Structure ====
+''npm install''
-To give a better overview of how the gateway is built up, the following class diagram has been created:
+Now you can start the local development server to play around with the API and make your calls
-<uml>
+''npm run dev''
-title Gateway - Class Diagram
-class StandardizationLayer_Bot {
+This will fire up a development server that listens on port 3000.
-    +defaultMessage: Object
-    +TextAudioFlag: Boolean
-    -standardizeMessage(): void
-    +getStandardizedMessage(): Message
-    -getAudioMessage(): Object
-}
-class Gateway {
-  -standardizedMessage: Message
-  -evaluateScores(): void
-}
-class LanguageProcessing{
-  -interpretMessage(): void
-  +getInterpretedMessage(): Object
-  -patternMessage(): void
-  +getPatternedMessage(): Object
-}
-class Registry {
+==== Overview ====
+The registry was built as a regular machine for the chatbot. Here it is decided which service is responsible for delivering the answer to the user. The decision is made on the Intent of the NLU unit.
-}
+==== Structure ====
+The registry consists of two files of a JavaScript file which reflects the service. And a Json file which contains the configuration of the available services. Here each intent is assigned a corresponding service interface.
-StandardizationLayer -- Gateway
-Gateway -- LanguageProcessing
-LanguageProcessing -- Gateway
-Gateway -- Registry
-</uml>
-This class diagram shows the structure around the gateway. Here it is important that there is a StandardizationLayer beforehand, which standsardize the incoming messages. The gateway then directs the message to an NLU service where we get the evaluated object back and compare the scores. The best evaluated message is then forwarded to the registry.
 ==== Functionalities ====
-=== Variables ===
+The registry forwards the incoming requests as a request to the various services and waits for their response before forwarding them to the requester.
-The defined variables are based on ''express'', ''body-parser'' and ''axios'':
-<code javascript>
-var express = require('express')
-var app = express()
-var bodyParser = require('body-parser')
-const axios = require('axios')
-</code>
-=== API-Call ===
-Each time our bot is mesaged in the chat, the message will be passed on to the gateway. This is mapped via ''cURL''. All incoming messages use the route ''\message-in''. If the message has no content, the response is empty. The code for the described behaviour looks as follows:
+==== Further Development ====
+To be able to offer further services the corresponding intent only needs to be included in the json file with an interface. Later it would be possible to extend this service with a better self-learning rule engine.
-<code javascript>
-app.post('/message-in', function(req, res) { // This is the route the API will call
-    const { message } = req.body
-        if (!message || message.text.length < 1) { // In case a message is not present, or if our message is empty, do nothing and return an empty response
-            return res.end()
-        }
-</code>
-=== Microsoft Azure - Cognitive Services - Headers ===
-Microsot Azure predetermines its specific header that should be used for ''HTTP-POST''. The header looks like this:
+==== Further Reading ====
+-[[https://www.drools.org/|Drools]]
-<code javascript>
-    const options = {
-        headers: {
-            'Host': 'northeurope.api.cognitive.microsoft.com',
-	    'Content-Type': 'application/json',
-	    'Ocp-Apim-Subscription-Key': '********************************'
-        }
-    }
-</code>
-=== HTTP-POST ===
-This section of code shows a request to the Azure service and generates a response which is sent directly to the bot. The code is shaded like this because Axios processes the messages asyncronous and we have to ensure a response has already been received. The following code snippet shows this more in detail:
-<code javascript>
-    axios.post('https://northeurope.api.cognitive.microsoft.com/text/analytics/v2.1/sentiment', {
-        "documents": [{
-            "language": "en",
-	    "id": message.chat.id,
-	    "text": message.text
-        }]
-    }, options).then(function (response) {
-        message_out = "[" + message.chat.id + "]: " + "Hi, your score is " + response.data.documents[0].score + "."
-        axios.post('https://api.telegram.org/bot:<token>/sendMessage', {
-            chat_id: message.chat.id,
-            text: message_out
-        }).then(response => {
-            // We get here if the message was successfully posted
-            console.log('Message posted')
-            res.end('ok')
-        })
-    })
-})
-</code>
-=== Server ===
-The server is listening on port ''3000'':
-<code javascript>
-// Finally, start our server
-app.listen(3000, function() {
-    console.log('Telegram app listening on port 3000!')
-})
-</code>
-==== Further Development ====
-In the short term, we are considering replacing Azure with Rasa to test the modular requirements. It is later considered that we will connect an NLU adapter that compares the two services and takes the best results.
-==== Further Reading ====
-To get a deeper insight into the technical components of our gateway, we recommend to follow up with some of the topics that are mentioned [[wiki:software:beuthbot:gateway#references|here]] or [[wiki:software:beuthbot:gateway#built with|here]].
 ==== Built With ====
-- [[https://core.telegram.org/bots/api|Telegram Bot API]]\\
 - [[https://nodejs.org/en/|Node.js]]\\
 - [[https://expressjs.com/|Express.js]]\\
 - [[https://www.npmjs.com/package/axios|Axios]]\\
 - [[https://www.npmjs.com/package/body-parser|Body-Parser]]\\
-- [[https://zeit.co/|ZEIT]]\\
-- [[https://wiki.ubuntuusers.de/cURL/|cURL]]\\
-- [[https://azure.microsoft.com/de-de/services/cognitive-services/text-analytics/|Microsoft Azure]]
 ==== Versioning ====
-We use [[https://git.ziemers.de/|GitLab]] for versioning.
+We use [[https://github.com/|GitHub]] for versioning.
 ==== Authors ====
-- **Christopher Lehmann** - //Development// & //Documentation//\\
+ **Timo Bruns** - //Initial work// - [[https://github.com/Tarry93|GitHub]] \\
 \\
-- **Timo Bruns** - //Development//\\
+ **Christopher Lehmann** - //Initial work// - [[https://github.com/Chr1ssy|GitHub]]\\
+See also the list of [[https://github.com/beuthbot/registry/graphs/contributors|contributors]] who participated in this project.
+<WRAP pagebreak></WRAP>

wiki.ziemers.de

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge