# Entidades do sistema

Você pode pensar em entidades do sistema como [entidades de correspondência ](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/detect-information-with-entities/match-entities)que são pré-feitas apenas porque se encaixam em padrões regulares e típicos que seriam amplamente usados dentro de conversas de bots.

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FDt5zSKjcfWZ3D8zwpawQ%2FScreenshot%202024-08-23%20at%2012.00.43.png?alt=media&#x26;token=789cb8cb-d385-46a2-9e2b-eefe1d247289" alt=""><figcaption><p>Aba de entidades do sistema.</p></figcaption></figure>

Chatlayer.ai suporta as seguintes entidades do sistema:

| Nome da variável      |                                                                                                                                                                                                      | Exemplo de entrada pelo usuário                          | Exemplo de resultado na sessão                                                                                  |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `sys.email`           | Valida se a entrada do usuário tem um formato de email                                                                                                                                               | "<ilovebots@chatlayer.ai>"                               | `sys: {email: 'ilovebots@chatlayer.ai'}`                                                                        |
| `sys.phone_number`    | Aceita números com mais de 6 e menos de 17 dígitos                                                                                                                                                   | "+32 487 23 02 03"                                       | `sys: {phone_number: '(+32) 487230203'}`                                                                        |
| `sys.ordinal`         |                                                                                                                                                                                                      | "5th"                                                    | `sys: {ordinal: '5'}`                                                                                           |
| `sys.amount_of_money` |                                                                                                                                                                                                      | "5 euro"                                                 | `sys: {amount_of money: '5', amount_of_money_currency: 'EUR'}`                                                  |
| `sys.distance`        |                                                                                                                                                                                                      | "5 kilometers"                                           | `sys: {distance: '5', distance_unit: 'kilometre'}`                                                              |
| `sys.number`          | Reconhece qualquer número.                                                                                                                                                                           | "eighty eight"                                           | `sys: {number: '88'}`                                                                                           |
| `sys.quantity`        |                                                                                                                                                                                                      | "3 liters"                                               | `sys: {quantity: '3', quantity_unit: 'litre'}`                                                                  |
| `sys.temperature`     |                                                                                                                                                                                                      | "80C"                                                    | `sys: {temperature '80', temperature_unit: 'celsius'`                                                           |
| `sys.time`            |                                                                                                                                                                                                      | "3 pm tomorrow"                                          | `sys: {time: '2020-12-25T15:00:00.000+00:00', time_grain: 'hour'}`                                              |
| `sys.url`             | Verifica se a entrada fornecida é uma URL. Formatos aceitos podem ser com www (*[www.chatlayer.ai](http://www.chatlayer.ai)*) ou sem (*chatlayer.ai*). Apenas o domínio 'chatlayer' não será aceito. | "[www.chatlayer.ai/jobs](https://www.chatlayer.ai/jobs)" | `sys: {url: 'www.chatlayer.ai/jobs', url_domain: 'chatlayer.ai'}`                                               |
| `sys.duration`        |                                                                                                                                                                                                      | "3 hours"                                                | `sys: {duration: '3', duration_unit: 'hour', duration_normalized: '10800', duration_normalized_unit: 'second'}` |

{% hint style="warning" %}
Você nunca deve sobrescrever as Entidades do Sistema você mesmo – elas são sobrescritas automaticamente pela última variável detectada (se houver valores detectados). Então, ao invés disso, salve a Entidade do Sistema em um [variável](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/settings/secure-variables-gdpr) de sua escolha fora do `sys` ou `interno` namespaces.
{% endhint %}

## Usar entidades do sistema

Para usar entidades do sistema no seu bot:

1. Crie um [**Coletar entrada**](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/user-input-bot-dialog) bloco. Por exemplo, faça dele um bloco que peça o email do usuário.

{% hint style="danger" %}
Por favor, note que o número de entidades do sistema que você pode usar dentro de um **Coletar entrada** bloco é limitado. As entidades do sistema que você pode usar dentro desses blocos são: **sys.email**, **sys.phone\_number**, **sys.url**, **sys.number**, e **sys.time**.
{% endhint %}

2. Em **Capturar usar resposta como**, role para baixo até encontrar a lista de **Entidades do sistema**.
3. Selecione a entidade do sistema de sua escolha. Para este exemplo, selecionaríamos `@sys.email`.

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FGScJy1XjPzbTp1v580dJ%2FScreenshot%202024-08-23%20at%2012.08.06.png?alt=media&#x26;token=66de9e09-b7cb-4cf6-8fa9-64f1a00ab6aa" alt="" width="327"><figcaption><p>Selecione uma entidade do sistema.</p></figcaption></figure>

4. Em **Salvar variável como**, escolha uma variável para armazenar o valor da entidade.

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2Fv2pQqtHvTIcg1GW0gmzU%2FScreenshot%202024-08-23%20at%2012.09.23.png?alt=media&#x26;token=5f3ff54d-a82a-43ab-89c7-71b85386720f" alt="" width="325"><figcaption><p>Salve o valor da entidade do sistema em uma variável</p></figcaption></figure>

4. Clique **Salvar**.
