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


---

# 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/system-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.