# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/detect-information-with-entities/match-entities.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
