> For the complete documentation index, see [llms.txt](https://docs.altu.d1.cx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.altu.d1.cx/train/configuracao-do-nlu.md).

# Configuração do NLU

A configuração do NLU é o primeiro item do menu de informações e gerenciamento da inteligência do chatbot. 

**Essa opção é responsável pela gestão de intenções e entidades.**

Para acessar, clique em cima da opção e você será redirecionado para a página de gerenciamento.

<figure><img src="/files/To8NwNeEqDjx4j1nesBg" alt=""><figcaption></figcaption></figure>

No canto inferior direito da tela, você encontrará a **“Área de testes”.** Use essa opção **após realizar os ajustes de configuração,** explicados mais adiante.

Nela, você pode saber como o cognitivo responde:

* Utilize a **caixa de texto** para enviar mensagens e checar se o NLU está retornando as intenções e entidades corretas no ambiente de desenvolvimento;
* Clique no botão **limpar resultados** para apagar as mensagens que estão na área de teste.
* Ative a opção **produção** caso queira ver o comportamento atual do assistente, ou seja, o que ele responde considerando apenas o que está publicado e rodando.
* Ative a opção **homologação** caso queira testar o comportamento do assistente considerando os ajustes feitos, antes de serem publicados. Ou seja, a forma como ele irá responder às mensagens quando as alterações forem implementadas definitivamente.

<figure><img src="/files/D5w061Bth3jQ6w06eVu0" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
As mensagens enviadas na área de testes são temporárias e não podem ser recuperadas depois de apagadas.
{% endhint %}

### Configurar NLU

A seguir, comece a entender como configurar o NLU.

#### Dados básicos

A primeira etapa é inserir os campos solicitados. São eles:

* **Nome:** você pode deixar o próprio nome do NLU escolhido ou, se preferir, alterá-lo;
* **Descrição:** insira uma nova descrição ou permaneça com a que já está;
* **Personalizado:** a barra de intenção utiliza um intervalo de confiança diferente do intervalo geral definido no NLU para atender comportamentos específicos da mesma e aumentar sua cobertura. Caso deseje é possível ativar o modo de “**configuração automática**”, onde o intervalo de confiança é definido automaticamente pelo motor cognitivo;
* **Squad vinculada:** selecione, caso tenha, a squad vinculada ao NLU;
* **Excluir NLU.**

Ao finalizar, clique em **“Salvar modificações”** e prossiga para a próxima etapa.

![](/files/AOXVqPqa9tygqWZMrubI)

### Intenções

Na compreensão da linguagem natural, as intenções são o que identifica qual a demanda do usuário, o que ele está buscando ou querendo fazer. Pode ser uma informação ou uma ação.

***Exemplo:** O usuário que envia uma mensagem ao chat bot como “quero comprar um notebook”, ele traz consigo uma necessidade que é a de **realizar uma compra.** Nesse caso, a intenção seria **COMPRAR\_PRODUTO.***

Nessa etapa da configuração do NLU, é possível visualizar uma tabela com todas as intenções adicionadas, como também exportar ou adicionar novas.

<figure><img src="/files/pPiSJnkFR8vS9YJ0Ma1h" alt=""><figcaption></figcaption></figure>

#### **Exportar intenções**

Caso deseje fazer o download das intenções adicionadas que aparecem na tabela, basta clicar em cima da opção e, automaticamente, o download será feito. O formato do arquivo será sempre CSV.

<figure><img src="/files/pg7X3H2uIl4IND6Q4svC" alt=""><figcaption></figcaption></figure>

#### **Adicionar intenção**

Se precisar adicionar intenções, clique na opção e insira os dados solicitados: nome, label e frases de treinamento, sendo **uma por linha.**

Utilize o sinal de **“+”** a cada nova intenção adicionad&#x61;**.** Ao finalizar, clique em **salvar.** Suas intenções estarão visíveis na tabela.

<figure><img src="/files/Jvi5GZpLvFeemrUoq2KG" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**A Label é o nome amigável da intenção,** ela será mostrada para a pessoa usuária durante a **desambiguação, que acontece quando o cognitivo identifica uma frase com confiança média** (ele fica "em dúvida" sobre qual é a intenção do usuário) **e apresenta um menu com as 3 intents mais prováveis.**&#x20;

Neste momento, não é mostrado o nome da intent, mas sim a label.
{% endhint %}

#### Relevância das frases de treinamento

Com essa funcionalidade, é possível **exibir a relevância das frases de treinamento em suas respectivas intenções**. Assim, você consegue identificar quais são as frases mais reconhecidas e menos reconhecidas da intenção, tornando os **ajustes mais assertivos**.

Após a publicação do NLU e já contando com um volume de mensagens significativo, ao abrir a tela de **edição de intenções,** você verá abaixo das frases de treinamento a **apresentação do nível de relevância** que aquela determinada frase obteve em sua respectiva intenção.&#x20;

Veja no print abaix&#x6F;**:**

<figure><img src="https://lh3.googleusercontent.com/XOORLue9rakchrhKAL0Y2fe4T3B6WkmHSOQhdsT-qSvpuAxalu_hmStumJHzJOdUFgHcLT9pVSpf5UbtX94Hgm_SPxgIu6O53h0r2Lx-ccQlgnD4U0WQYXu3_PKdQh-eXOz4FR2qAOKYluJUXN9eHq4" alt=""><figcaption><p>Frase com <strong>alta</strong> relevância</p></figcaption></figure>

<figure><img src="https://lh6.googleusercontent.com/1G1ncboHDnDIkApsl2REwrsGPu2bq6XW-7spUhypgnKAJcJvvia755OqczqViMqSfTAx3YQOlqfFQ6XDALLGIn452fDPkmqpS0CNHKpeuwLXJzRO1DP6gSc5idizdzKCn8Ox_06r26ESuKoo0kh4Buo" alt=""><figcaption><p>Frase com <strong>baixa</strong> relevância</p></figcaption></figure>

No exemplo acima, a frase "**Acompanhamento de serviços**" possui uma **alta relevância** e a frase "**Quero acompanhar meu protocolo de atendimento**" possui **baixa relevância**.&#x20;

Na prática, isso significa que as mensagens que o bot está recebendo são **mais parecidas** com "**Acompanhamento de serviços**" do que com "**Quero acompanhar meu protocolo de atendimento**".

### **Entidades**

Na compreensão da linguagem natural, as entidades são informações específicas e relevantes sobre uma intenção. Essas informações variam em uma conversa e são necessárias para um entendimento aprofundado sobre o tema tratado pelo cognitivo.

***Exemplo:** Utilizando o mesmo contexto do exemplo das intenções com a frase “quero comprar um notebook”, se houvesse apenas a intenção cadastrada, um chatbot poderia retornar com uma lista geral de produtos. Mas, ao cadastrar também uma entidade, retornamos algo específico. Assim, o objeto da intenção seria “**notebook**”.*

Nessa etapa da configuração do NLU, também é possível visualizar uma tabela com todas as entidades adicionadas e adicionar novas.

![](/files/5eI7vr86ozeiF9mRjkbn)

#### Adicionar entidade

Para adicionar uma nova entidade, basta inserir o nome da mesma e clicar em salvar. Ela aparecerá na tabela.

<figure><img src="/files/zeggnCibkJ66vaRSMolW" alt=""><figcaption></figcaption></figure>

### Base de conhecimento

A base de conhecimento é a etapa onde se centraliza, no NLU, todos os dados e informações relevantes para o chatbot. Com ela, a inteligência artificial retorna soluções de forma ágil e sana as questões do usuário que está interagindo.

Aqui, você cadastra e gerencia as respostas que o assistente usa durante as interações, tornando muito mais fácil e simples adicionar e fazer e ajustes nos conteúdos.

![](/files/SZ2kJwWp6p3rur3zAhNp)

Depois de entendido qual a informação que o usuário deseja, o assistente precisa dar a resposta adequada e para isso ele aciona a base de conhecimentos em busca do conteúdo cadastrado para a intenção e entidade identificadas na mensagem recebida.

#### Estrutura

Na sua estrutura, a base de conhecimento pode ser utilizada para:

* Exportar a base;
* Adicionar nova base de conhecimento;
* Ver as bases já existentes relativas ao NLU selecionado, podendo editar, excluir itens ou ver todos os detalhes.

{% hint style="info" %}
&#x20;A opção para ativar o **“modo avançado”,** localizada no canto superior esquerdo, permite a vinculação de resposta da base sem nenhuma intent, e também com múltiplas entidades e valores de entidades.
{% endhint %}

* [x] **Exportar a base**

Caso deseje exportar, basta clicar na base que deseja. Siga os passos mostrados no gif abaixo.

<figure><img src="/files/xBvZon2mr0bURcZLAYpr" alt=""><figcaption></figcaption></figure>

* [x] **Adicionar base de conhecimento**

Clique em **“Adicionar base de conhecimento”** para começar.  Preencha os campos solicitados: nome e descrição.

É considerada uma boa prática que ou no nome ou na descrição tenha o assistente vinculado e também que a descrição tenha o objetivo da base e outras informações relevantes. Exemplo:

***Nome da base:*** *Base de conhecimentos Laka Sudeste.*

***Descrição:*** *Base de conhecimentos vinculada ao assistente Laka 1 que atende lojas parceiras da Laka empreendimentos localizadas exclusivamente na região sudeste do Brasil.*

<figure><img src="/files/QBxqrp9Wyvsyk8u71A7q" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Você pode criar mais de uma base de conhecimento para cada NLU.
{% endhint %}

* [x] **Ver bases já existentes**

Na mesma tela, você terá acesso a uma tabela das bases de conhecimento do NLU selecionado. Ela é dividida em:

* ID do NLU;
* Nome do NLU;
* Respostas publicadas;
* Respostas não publicadas.

Ao expandir a visualização no item sinalizado em vermelho na imagem abaixo, outras opções serão exibidas:

<figure><img src="/files/5Fvg2I6JdrLPkrNb2K78" alt=""><figcaption></figcaption></figure>

Ao clicar em alguma **intenção,** automaticamente o conteúdo da base de conhecimento estará visível e você verá a lista com todas as intenções e entidades cadastradas no NLU escolhido com suas respectivas respostas.&#x20;

Além disso, também é possível nesta tela editar as respostas da base através dos botões de **Publicar** e **Excluir respostas**.&#x20;

<figure><img src="/files/ntkMLJePRMmaXC29H3vU" alt=""><figcaption></figcaption></figure>

Caso deseje editar ou excluir respostas publicadas e inserir novas, será possível fazer de forma prática e rápida por este caminho também:

<figure><img src="/files/xVH6fxpsLUaq6pPLnNUR" alt=""><figcaption></figcaption></figure>

* [x] **Outras funcionalidades**

- Caso deseje editar o nome do NLU, digite-o e clique em **“salvar nome”;**
- Clique em **“Publicar todas as respostas”** se desejar;
- Se for o caso, clique em **“excluir base”** para deletar a base de conhecimento selecionada;
- Para facilitar o acesso aos dados, utilize o recurso de **“buscar respostas”.**

![](/files/YYH1dAUA2KAn1fpW5aYL)

### Publicação

A última etapa da “Configuração de NLU” é a **publicação**. É nela onde você irá publicar o NLU.

**Essa fase é realizada para que o usuário interaja com o cognitivo durante o atendimento.**&#x20;

Alguns pontos, antes da publicação, são importantes de serem considerados:

* Caso você realize alguma alteração no conteúdo das intenções e entidades, é necessário publicar novamente para que haja a atualização;
* Modificações não publicadas somente podem ser vistas em ambiente de teste, ou seja, elas não alteram o comportamento do cognitivo durante a interação com o usuário até serem publicadas;
* A frequência de ajustes e publicação varia de NLU para NLU de acordo com a volumetria de mensagens recebidas, é importante checar com seu time de NLU e Curadoria a frequência recomendada para cada caso;
* Uma vez publicada a NLU, os insights das avaliações anteriores dão espaço às avaliações do novo período gerado;
* Faça o processo de publicação em conjunto com o seu time de NLU e Curadoria.

#### Publicar NLU

Na página inicial, ao lado esquerdo, você acompanha o histórico de modificações realizadas no NLU desde a última publicação. Ao lado direito, além da opção de publicação, há também o histórico das últimas publicações.&#x20;

Veja na imagem abaixo:

![](/files/lQxJiEC4CU52cFQlC7uy)

Ao clicar em **Publicar NLU**, uma caixa solicitando o nome do NLU selecionado será exibida.&#x20;

Caso deseje, você também pode selecionar a opção **Baixar métricas da publicação atual**. Esses dados incluem:

* Mensagens recebidas e avaliadas;
* Confusões e instabilidades;
* Performance geral do cognitivo.

Para finalizar a publicação, clique em **Confirmar**.

<figure><img src="/files/nveIiNDwkDzbSK5DV0Fv" alt=""><figcaption></figcaption></figure>