You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
sudo docker-compose run --rm -v $PWD/analytics:/analytics bot python /analytics/setup_elastic.py
19
+
sudo docker-compose up -d kibana
20
+
21
+
sudo docker-compose up -d bot
22
+
```
23
+
24
+
## Introdução
25
+
6
26
### For English version, see [README-en](docs/README-en.md)
7
27
8
28
Um projeto feito em Rasa com configurações necessárias para a construção de um projeto grande de chatbot.
9
29
10
-
Este projeto teve como base a[Tais](http://github.com/lappis-unb/tais).
30
+
Este projeto teve como base o projeto[Tais](http://github.com/lappis-unb/tais).
11
31
12
-
# Entenda a Arquitetura
32
+
###Entenda a Arquitetura
13
33
14
34
É utilizado no boilerplate diversas tecnologias que interagem entre si para obter um melhor resultado. Veja a arquitetura implementada:
15
35
@@ -23,120 +43,45 @@ Os notebooks avaliam o funcionamento de acordo com o formato das *intents* e *st
23
43
O elasticsearch coleta os dados da conversa e armazena para a análise feita pelo kibana, que gera gráficos para
24
44
avaliação das conversas dos usuários e do boilerplate.
25
45
26
-
## Bot
27
-
46
+
### Bot
28
47
29
48
Este script foi configurado para construir as imagens genéricas necessárias para execução deste ambiente.
30
49
Caso seu projeto utilize este boilerplate e vá realizar uma integração contínua ou similar, é interessante
31
-
criar um repositório para as imagens e substitua os nomes das imagens "lappis/bot", "lappis/coach" e "lappis/botrequirements" pelas
32
-
suas respectivas novas imagens, por exemplo "<organização>/bot" em repositório público.
50
+
criar um repositório para as imagens e substitua os nomes das imagens "lappis/bot", e "lappis/botrequirements" pelas suas respectivas novas imagens, por exemplo "<organização>/bot" em repositório público.
33
51
34
-
### RocketChat
35
-
Para testar o assistente virtual utilizando da plataforma do RocketChat, siga os seguintes comandos para subir os containers em seu computador:
36
52
53
+
### Treinamento
37
54
55
+
**Atenção**: o comando de treinamento é usado para criar os modelos necessários na conversação do bot para treinar o seu chatbot execute o comando:
38
56
```sh
39
-
sudo docker-compose up -d rocketchat
40
-
41
-
# Caso não vá subir a stack do Analytics
42
-
# aguarde o container do rocketchat subir
43
-
sudo docker-compose up -d bot
44
-
```
45
-
46
-
Caso queira subir toda a stack e vá utilizar do analytics é necessário substituir a seguinte variável de ambiente no `docker/bot-rocketchat.env` de **False** para **True**.
47
-
```
48
-
# Analytics config
49
-
ENABLE_ANALYTICS=True
50
-
51
-
# E logo após trocar, subir o container do bot
52
-
sudo docker-compose up -d bot
53
-
```
54
-
55
-
56
-
Após esses comandos o RocketChat deve estar disponível na porta 3000 do seu computador. Entre em http://localhost:3000 para acessar. Será pedido que faça login. Por padrão é gerado um usuário admin: username: admin senha: admin. Nas próximas telas apenas clique na opção `Continue` e `Go to your workspace`.
57
-
58
-
Para configurar o bot no rocketchat e conseguir conversar com ele pelo próprio rocket, acesse o [link](http://github.com/lappis-unb/rasa-ptbr-boilerplate/tree/master/docs/add_bot_rocketchat.md).
59
-
60
-
61
-
Opcionalmente, é possível fazer uma configuração para que o assistente virtual inicie a conversa, para isso você deve criar um `trigger`.
62
-
Para criar um `trigger` entre no rocketchat como `admin`, e vá no painel do Livechat na
63
-
seção de Triggers, clique em `New Trigger`. Preencha o Trigger da seguinte forma:
64
-
65
-
66
-
```yaml
67
-
Enabled: Yes
68
-
Name: Start Talk
69
-
Description: Start Talk
70
-
Condition: Visitor time on site
71
-
Value: 3
72
-
Action: Send Message
73
-
Value: Impersonate next agent from queue
74
-
Value: Olá!
57
+
sudo make train
75
58
```
76
59
60
+
### Console
77
61
78
-
#### Instalação
79
-
80
-
Para executar o bot em um site você precisa inserir o seguinte Javascript na sua página
**Atenção**: Você precisa alterar a variavel `host` dentro do código acima para a url do site onde estará o seu Rocket.Chat.
99
-
100
66
### Telegram
101
67
102
68
Após realizar o [tutorial](/docs/setup_telegram.md) de exportação de todas variávies de ambiente necessárias, é possível realizar a execução do bot no telegram corretamente.
103
69
104
-
<strong><em>Antes de seguir adiante. Importante:</strong></em> As variáveis de ambiente são necessárias para o correto funcionamento do bot, por isso não esqueça de exportá-las.
70
+
**Antes de seguir adiante. Importante:** As variáveis de ambiente são necessárias para o correto funcionamento do bot, por isso não esqueça de exportá-las.
105
71
106
72
Se ainda não tiver treinado seu bot execute antes:
107
73
108
-
```sh
109
-
make train
110
-
```
111
-
**Atenção**: o comando "make train" executa um container docker, caso precise de sudo em seu computador
112
-
para execução docker, utilize "sudo make train".
113
-
114
74
115
75
Depois execute o bot no telegram:
116
76
117
77
```sh
118
78
sudo docker-compose up bot_telegram
119
79
```
120
-
121
-
### Console
122
-
123
-
```sh
124
-
make train
125
-
sudo docker-compose run --rm bot make run-console
126
-
```
127
-
128
-
### Train Online
129
-
130
-
```
131
-
make train
132
-
sudo docker-compose run --rm coach make train-online
133
-
```
134
-
135
-
## Analytics
80
+
### Analytics
136
81
137
82
Para a visualização dos dados da interação entre o usuário e o chatbot nós utilizamos uma parte da Stack do Elastic, composta pelo ElasticSearch e o Kibana. Com isso, utilizamos um broker para fazer a gerência de mensagens. Então conseguimos adicionar mensagens ao ElasticSearch independente do tipo de mensageiro que estamos utilizando.
138
83
139
-
#### Setup RabbitMQ
84
+
###Configuração do RabbitMQ
140
85
141
86
Em primeiro lugar para fazer o setup do analytics é necessário subir o RabiitMQ e suas configurações.
142
87
@@ -163,9 +108,7 @@ RABBITMQ_DEFAULT_PASS=admin
163
108
164
109
Sendo que as configurações de `RABBITMQ_DEFAULT_USER` e `RABBITMQ_DEFAULT_PASS` devem ser as mesmas definidas no serviço do `rabbitmq`.
165
110
166
-
167
-
168
-
### Execução
111
+
#### Integração com Rasa
169
112
170
113
Existem duas formas para executar a Tais com o *broker*. A primeira delas é via linha de comando.
171
114
Para utilizar esta forma é preciso definir Dentro do arquivo `endpoints.yml` as configurações do broker:
@@ -201,7 +144,7 @@ Ao final é necessário buildar novamente o container do bot.
201
144
sudo docker-compose up --build -d bot
202
145
```
203
146
204
-
### Setup ElasticSearch
147
+
### Configuração ElasticSearch
205
148
206
149
O ElasticSearch é o serviço responsável por armazenar os dados provenientes da interação entre o usuário e o chatbot.
207
150
@@ -221,12 +164,13 @@ ENVIRONMENT_NAME=localhost
221
164
BOT_VERSION=last-commit-hash
222
165
```
223
166
224
-
### Setup Kibana (Visualização)
167
+
#### Setup Kibana (Visualização)
168
+
225
169
Para a análise dos dados das conversas com o usuário, utilize o kibana, e veja como os usuários estão interagindo com o bot, os principais assuntos, média de usuários e outras informações da análise de dados.
226
170
227
171
O Kibana nos auxilia com uma interface para criação de visualização para os dados armazenados nos índices do ElasticSearch.
228
172
229
-
```
173
+
```sh
230
174
sudo docker-compose up -d kibana
231
175
```
232
176
@@ -282,24 +226,6 @@ docker-compose up -d notebooks
282
226
283
227
Acesse o notebook em `localhost:8888`
284
228
285
-
286
-
287
-
## Tutorial para levantar toda a stack
288
-
289
-
```sh
290
-
sudo docker-compose up -d rocketchat
291
-
292
-
sudo docker-compose up -d rabbitmq
293
-
sudo docker-compose up -d rabbitmq-consumer
294
-
295
-
sudo docker-compose up -d elasticsearch
296
-
sudo docker-compose run --rm -v $PWD/analytics:/analytics bot python /analytics/setup_elastic.py
297
-
sudo docker-compose up -d kibana
298
-
299
-
sudo docker-compose up -d bot
300
-
```
301
-
302
-
303
229
# Como conseguir ajuda
304
230
305
231
Parte da documentação técnica do framework da Tais está disponível na
0 commit comments