> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/detect-information-with-entities/match-entities.md).
# Entidades match
Uma entidade de correspondência pode ser detectada em qualquer lugar da conversa, o que significa que ela é independente de contexto.
## Detectar informações em qualquer lugar
As entidades podem sempre ser solicitadas dentro de um [Coletar entrada](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/user-input-bot-dialog.md) 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:
Como você predefiniu o número do pacote como uma entidade de correspondência, o bot conseguiu identificá-lo na expressão do usuário, pulando assim o bloco Coletar entrada que pedia por ele. O resultado é uma experiência de usuário muito melhor e um bot aparentemente mais inteligente 😉
## Combinar texto ou padrões
As entidades de correspondência têm 2 opções:
* para corresponder a um [text](#match-text)
* para corresponder a um [padrão](#match-pattern)
Exemplo de entidade de correspondência de texto.
{% hint style="warning" %}
Observe que as entidades de correspondência são independentes de contexto, o que significa que elas podem ser detectadas em qualquer parte da conversa. Portanto, elas são muito diferentes de [entidades contextuais ](/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/detect-information-with-entities/contextual-entities.md)que dependem do contexto e podem ser detectadas apenas em certos pontos da conversa.
{% endhint %}
### Adicionar uma entidade de correspondência de texto
Uma entidade de correspondência de texto será detectada quando o que o usuário disser corresponder a um valor em uma lista predefinida.
Para adicionar uma entidade de correspondência de texto:
1. Da [Entidades](/chatlayer-documentation-pt-br/navegacao/natural-language-processing-nlp/synonym-entities.md) aba, clique em **Adicionar entidade de correspondência** botão.
2. Selecione **Texto correspondente**.
3. Insira um **Nome da entidade**.
4. Insira diferentes **Valores da entidade**.
5. Se quiser, adicione [**Sinônimos**](#synonyms-in-match-text-entities) a esses valores digitando-os no campo e depois clicando `Digite` no seu teclado.
Sinônimos em entidades de correspondência de texto
Para cada valor de um texto correspondente, você pode adicionar um sinônimo que será detectado como o valor original. Sinônimos permitem que você adicione alternativas às entidades que são atribuídas ao mesmo valor.
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* como *Brussels* para que seu bot possa funcionar com um único e mesmo valor.
Observe que as entidades de correspondência não diferenciam maiúsculas de minúsculas, então não há necessidade de adicionar sinônimos com letras maiúsculas.
Adicione uma entidade de correspondência de texto.
6. Clique em **Criar entidade**.
Quando um usuário diz "Quero saber mais sobre o **Premium** pacote", a entidade de correspondência **@product** será reconhecida e salva com o valor "Premium".
### Adicionar uma entidade de correspondência de padrão
Uma entidade de correspondência de padrão será detectada quando o que o usuário disser corresponder a um determinado padrão regular.
Para adicionar uma entidade de correspondência de padrão:
1. Da [Entidades](/chatlayer-documentation-pt-br/navegacao/natural-language-processing-nlp/synonym-entities.md) aba, clique em **Adicionar entidade de correspondência** botão.
2. Selecione **Padrão correspondente**.
3. Adicione um **Nome da entidade**.
4. Adicione uma expressão regular em **Padrão**.
Expressões regulares em entidades de correspondência de padrão
O padrão que você preencher nas entidades de correspondência de padrão deve ser escrito como uma expressão regular (RegEx) no estilo Python. Para mais informações, consulte .
Por exemplo: você definiu **@customer\_ID** como uma entidade de correspondência e forneceu o seguinte padrão de 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".
Adicionar uma entidade de correspondência de padrão.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/detect-information-with-entities/match-entities.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.