# Entidades de correspondência

Uma entidade de correspondência pode ser detectada em qualquer lugar da conversa, o que significa que ela é independente do contexto.&#x20;

## Detectar informações em qualquer lugar

Entidades sempre podem ser solicitadas dentro de um [Coletar entrada](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/user-input-bot-dialog) bloco, mas **entidades de correspondência** podem ser detectadas em qualquer lugar da conversa, o que significa que elas pularão o **Coletar entrada** bloco no seu fluxo. Isso resultaria em uma conversa como esta:

![O bot agora reconhece o número do pacote sem pedí‑lo](https://181262846-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LLTwFwbOqJj4dDhg8Ju%2F-MaiD56xtmTUFIr6h-ih%2F-MaiGwIaqkWo_1l4CE6q%2Fmatchh.png?alt=media\&token=3ada077d-fc7e-4aea-bdae-1a8b3e99f683)

Porque você predefiniu o número do pacote como uma entidade de correspondência, o bot conseguiu identificá‑lo na expressão do usuário, portanto pulando o bloco Coletar entrada que o solicitava. O resultado é uma experiência do usuário muito melhor e um bot aparentemente mais inteligente 😉

## Corresponder texto ou padrões

Entidades de correspondência têm 2 opções:

* corresponder a um [text](#match-text)
* corresponder a um [padrão](#match-pattern)

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2F2AMsXIFh3byDdzlQxGH5%2FScreenshot%202024-08-14%20at%2015.56.55.png?alt=media&#x26;token=7ce4720a-ac59-49fd-bd5b-1b49c03e6488" alt=""><figcaption><p>Exemplo de entidades de correspondência.</p></figcaption></figure>

{% hint style="warning" %}
Observe que entidades de correspondência são independentes do contexto, o que significa que podem ser detectadas em qualquer lugar da conversa. Portanto, elas são muito diferentes de [entidades contextuais ](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/detect-information-with-entities/contextual-entities)que são dependentes do contexto e só podem ser detectadas em certos lugares dentro da conversa.
{% endhint %}

### Adicionar uma entidade de texto de correspondência

Uma entidade de texto de correspondência será detectada quando o que o usuário diz corresponder a um valor em uma lista pré-definida.

Para adicionar uma entidade de texto de correspondência:

1. A partir da [Entidades](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/natural-language-processing-nlp/synonym-entities) aba, clique em **Adicionar entidade de correspondência** botão.
2. Selecione **Texto de correspondência**.
3. Insira um **Nome da entidade**.
4. Insira diferentes **Valores da entidade**.
5. Se desejar, adicione [**Sinônimos**](#synonyms-in-match-text-entities) a esses valores digitando-os no campo e depois clicando `Digite` no seu teclado.

<details>

<summary>Sinônimos em entidades de texto de correspondência</summary>

Para cada valor de um texto correspondido, você pode adicionar um sinônimo que será detectado como o valor original. Sinônimos permitem adicionar alternativas a entidades que são atribuídas ao mesmo valor.&#x20;

Por exemplo:

*Quero ir para Bruxelas*

*Quero ir para Bruxelles*

O significado das duas expressões acima é exatamente o mesmo, mas você quer converter *Bruxelles* para *Brussels* para que seu bot possa trabalhar com um único e mesmo valor.

Observe que entidades de correspondência não diferenciam maiúsculas de minúsculas, então não há necessidade de adicionar sinônimos capitalizados.

</details>

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FEYlHyObSJeCzeSjzaD02%2FScreenshot%202024-08-14%20at%2016.02.00.png?alt=media&#x26;token=301e3488-8d41-42e4-b8d8-1daa68e46454" alt="" width="563"><figcaption><p>Adicionar uma entidade de texto de correspondência.</p></figcaption></figure>

6. Clique em **Criar entidade**.

Quando um usuário diz "Quero saber mais sobre o **Premium** pack", a entidade de correspondência **@product** será reconhecida e salva com o valor "Premium".

### Adicionar uma entidade de padrão de correspondência

Uma entidade de padrão de correspondência será detectada quando o que o usuário diz corresponder a um determinado padrão regular.

Para adicionar uma entidade de padrão de correspondência:

1. A partir da [Entidades](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/natural-language-processing-nlp/synonym-entities) aba, clique em **Adicionar entidade de correspondência** botão.
2. Selecione **Padrão de correspondência**.
3. Adicione um **Nome da entidade**.
4. Adicione uma expressão regular em **Padrão**.

<details>

<summary>Expressões regulares em entidades de padrão de correspondência</summary>

O padrão que você preenche nas entidades de padrão de correspondência deve ser escrito como uma expressão regular (RegEx) no estilo Python. Para mais informações, verifique <https://regex101.com/>.

Por exemplo: você definiu **@customer\_ID** como uma entidade de correspondência, e forneceu o seguinte padrão regex: `[a-z]{5}[0-9]{2}`. Isso significa que quando um usuário diz "Meu ID de cliente é terwf33" – que consiste em 5 letras e 2 números – ele é salvo como a entidade de correspondência **@customer\_ID** com o valor "terwf33".

</details>

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2Fl3CqPG86ZNWARIdoHlkM%2FScreenshot%202024-08-14%20at%2016.08.59.png?alt=media&#x26;token=b2e79b1f-31bf-4572-b951-97ddda09a561" alt="" width="563"><figcaption><p>Adicionar uma entidade de padrão de correspondência.</p></figcaption></figure>
