---
sourceDocument: Interfaces conversacionais do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Interfaces conversacionais do Xanadu

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Entidades do sistema NLU

# Entidades do sistema NLU {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 min. de leitura

Use entidades NLU definidas globalmente para identificar informações do sistema que Virtual Agent podem extrair da conversa. Você pode definir entidades como variáveis de entrada "sem nó" para um tópico. Essas variáveis podem ser preenchidas com base nas previsões do provedor de serviços NLU ou fornecidas fora do escopo do tópico.
As entidades do sistema são habilitadas em modelos de NLU por padrão. Você pode exibi-las na guia Entidades do modelo em Workbench de NLU.

## Entidade do sistema GLOBAL.DATE {#nlu-system-entities__section_cqn_53d_lpb}

O subtipo DAY retorna uma cadeia de caracteres de data que é precisa para uma data específica.  
{#nlu-system-entities__table_lcl_cjd_lpb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | AAAA-MM-DD |
| Expressão regular | \\\\d\\\\d\\\\d\\\\d-\\\\d\\\\d-\\\\d\\\\d |
| Exemplo de entrada | O Sr. Smith saiu na sexta-feira, 4 de fevereiro de 2019. |
| Valor normalizado | 2019-02-04 |
| Exemplo de código | { "name": "DATE", "value": "...", "score": 1.0, "normalization": "2019-02-04" } |
[Tabela 1. Subtipo GLOBAL.DATE = uso de DAY]

{#nlu-system-entities__table_lcl_cjd_lpb}

O subtipo WEEK retorna uma cadeia de caracteres de data de uma semana específica do ano.  
{#nlu-system-entities__table_crg_tjd_lpb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | AAAA'S'SS |
| Expressão regular | \\\\d\\\\d\\\\d\\\\d\\\\dW\\\\d\\\\d |
| Exemplo de entrada | O Sr. Smith saiu na terceira semana de 1999. |
| Valor normalizado | 1999S3 |
| Exemplo de código | { "name": "entity:GLOBAL.DATE", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DATE", "subType": "WEEK", "value":"1999W3"} } |
[Tabela 2. Subtipo GLOBAL.DATE = uso de WEEK]

{#nlu-system-entities__table_crg_tjd_lpb}

O subtipo MONTH retorna uma cadeia de caracteres de data de um mês específico do ano.  
{#nlu-system-entities__table_edh_sld_lpb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | AAAA'M'MM |
| Expressão regular | \\\\d\\\\d\\\\d\\\\dM\\\\d\\\\d |
| Exemplo de entrada | O Sr. Smith saiu em fevereiro de 1999. |
| Valor normalizado | 1999M02 |
| Exemplo de código | { "name": "entity:GLOBAL.DATE", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DATE", "subType": "MONTH", "value": "1999M02"} } |
[Tabela 3. Subtipo GLOBAL.DATE = uso de MONTH]

{#nlu-system-entities__table_edh_sld_lpb}

O subtipo YEAR retorna uma cadeia de caracteres de um ano específico.  
{#nlu-system-entities__table_pxj_1md_lpb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | AAAA |
| Expressão regular | \\\\d\\\\d\\\\d\\\\d |
| Exemplo de entrada | O Sr. Smith saiu em 1999. |
| Valor normalizado | 1999 |
| Exemplo de código | { "name": "entity:GLOBAL.DATE", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DATE", "subType": "YEAR", "value": "1999"} } |
[Tabela 4. Subtipo GLOBAL.DATE = uso de YEAR]

{#nlu-system-entities__table_pxj_1md_lpb}

O subtipo SEASON retorna uma cadeia de caracteres de data de uma estação específica do ano.  
{#nlu-system-entities__table_s1q_fpd_lpb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | Um dos seguintes: * Inverno: AAAAWI * Primavera: AAAASP * Verão: AAAASU * Outono: AAAAFA {#nlu-system-entities__ul_m4j_jpd_lpb} |
| Expressão regular | Um dos seguintes: * Inverno: \\\\d\\\\d\\\\d\\\\dWI * Primavera: \\\\d\\\\d\\\\d\\\\dSP * Verão: \\\\d\\\\d\\\\d\\\\dSU * Outono: \\\\d\\\\d\\\\d\\\\dFA {#nlu-system-entities__ul_cnh_npd_lpb} |
| Exemplo de entrada | O Sr. Smith saiu no outono de 1999. |
| Valor normalizado | 1999FA |
| Exemplo de código | { "name": "entity:GLOBAL.DATE", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DATE", "subType": "SEASON", "value": "1999FA"} } |
[Tabela 5. Subtipo GLOBAL.DATE = uso de SEASON]

{#nlu-system-entities__table_s1q_fpd_lpb}

## Entidade do sistema GLOBAL.TIME {#nlu-system-entities__section_rrk_kqd_lpb}

O Subtipo TIME retorna uma cadeia de caracteres de hora com precisão de hora e minuto.  
{#nlu-system-entities__table_zrm_mqd_lpb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | 'T'HH:mm |
| Expressão regular | T\\\\d\\\\d:\\\\d\\\\d |
| Exemplo de entrada | O Sr. Smith saiu às dez para as três. |
| Valor normalizado | T02:50 |
| Exemplo de código | { "name": "entity:GLOBAL.TIME", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.TIME","subType": "TIME", "value": "T02:50"} } |
[Tabela 6. Subtipo GLOBAL.TIME = uso de TIME]

{#nlu-system-entities__table_zrm_mqd_lpb}

O subtipo PARTSOFDAY retorna uma cadeia de caracteres de hora que especifica partes do dia.  
{#nlu-system-entities__table_thr_wqd_lpb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | Um dos seguintes: * Manhã: TMO * Tarde: TAF * Fim de tarde: TEV * Noite: TNI {#nlu-system-entities__ul_xl5_crd_lpb} |
| Expressão regular | Um dos seguintes: * Manhã: TMO * Tarde: TAF * Fim de tarde: TEV * Noite: TNI {#nlu-system-entities__ul_omc_grd_lpb} |
| Exemplo de entrada | O Sr. Smith saiu pela manhã. |
| Valor normalizado | TMO |
| Exemplo de código | { "name": "entity:GLOBAL.TIME", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.TIME", "subType": "PARTSOFDAY", "value": "TMO"} } |
[Tabela 7. Subtipo GLOBAL.TIME = uso de PARTSOFDAY]

{#nlu-system-entities__table_thr_wqd_lpb}

## Entidade do sistema GLOBAL.DATE_TIME {#nlu-system-entities__section_rkt_pbc_3vb}

O subtipo DATE_TIME retorna uma cadeia de caracteres de data com precisão de uma cadeia de caracteres de data e hora específica com preciso de hora e minuto.  
{#nlu-system-entities__table_wsh_ybc_3vb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | AAAA-MM-DD'T'HH:mm |
| Expressão regular | \\\\d\\\\d\\\\d\\\\d-\\\\d\\\\d-\\\\d\\\\dT\\\\d\\\\d:\\\\d\\\\d |
| Exemplo de entrada | O Sr. Smith sai em 31 de outubro às 17:00. |
| Valor normalizado | 2022-10-31T17:00 |
| Exemplo de código | { "name": "DATE_TIME", "value": "October 31st at 5:00 p.m", "normalization": "2022-10-31T17:00","confidence": "1" } |
[Tabela 8. Subtipo GLOBAL.DATE_TIME = uso de DATETIME]

{#nlu-system-entities__table_wsh_ybc_3vb}

## Entidade do sistema GLOBAL.DURATION {#nlu-system-entities__section_qhq_jrd_lpb}

Essa entidade retorna uma cadeia de caracteres de duração que especifica a duração da atividade.  
{#nlu-system-entities__table_gf3_mrd_lpb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | Um dos seguintes: * Segundo: 's'ss * Minuto: 'm'mm * Hora: 'h'hh * Dia: 'D'DD * Semana: 'S'SS * Mês: 'M'MM * Ano: 'A'AA {#nlu-system-entities__ul_dkp_qrd_lpb} |
| Expressão regular | Um dos seguintes: * Segundo: s\\\\d\\\\d * Minuto: m\\\\d\\\\d * Hora: h\\\\d\\\\d * Dia: D\\\\d\\\\d * Semana: S\\\\d\\\\d * Mês: M\\\\d\\\\d * Ano: A\\\\d\\\\d {#nlu-system-entities__ul_bcb_yrd_lpb} |
| Exemplo de entrada | O Sr. Smith permaneceu em Boston por 48 horas. |
| Valor normalizado | h48 |
| Exemplo de código | { "name": "entity:GLOBAL.DURATION", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.DURATION", "value": "h48"} } |
[Tabela 9. Uso de GLOBAL.DURATION]

{#nlu-system-entities__table_gf3_mrd_lpb}

## Entidade do sistema GLOBAL.LOCATION {#nlu-system-entities__section_wpj_2sd_lpb}

Esta entidade retorna uma cadeia de caracteres de local.  
{#nlu-system-entities__table_wd5_cvd_lpb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | Valor da cadeia de caracteres. Exemplo: Santa Clara |
| Expressão regular | Não aplicável. |
| Exemplo de entrada | O Sr. Smith trabalha em Santa Clara. |
| Valor normalizado | Santa Clara |
| Exemplo de código | { "name": "entity:GLOBAL.LOCATION", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.LOCATION", "value":"Santa Clara"} } |
[Tabela 10. Uso de GLOBAL.LOCATION]

{#nlu-system-entities__table_wd5_cvd_lpb}

## Entidade do sistema GLOBAL.PERSON {#nlu-system-entities__section_b1x_jvd_lpb}

Esta entidade retorna uma cadeia de caracteres de nome.  
{#nlu-system-entities__table_og1_nvd_lpb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | Valor da cadeia de caracteres. Exemplo: Joe Smith |
| Expressão regular | Não aplicável. |
| Exemplo de entrada | Joe Smith trabalha em Santa Clara. |
| Valor normalizado | Joe Smith |
| Exemplo de código | { "name": "entity:GLOBAL.PERSON", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.PERSON", "value":"Joe Smith"} } |
[ ]

{#nlu-system-entities__table_og1_nvd_lpb}

## Entidade do sistema GLOBAL.MONEY {#nlu-system-entities__section_xkc_5vd_lpb}

Esta entidade retorna uma cadeia de caracteres de moeda.  
{#nlu-system-entities__table_c1b_wvd_lpb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | Valor da cadeia de caracteres. Exemplo: US$ 2.000 |
| Expressão regular | Não aplicável. |
| Exemplo de entrada | Mostre-me laptops por menos de USD 2.000. |
| Valor normalizado | USD 2.000 Nota: O valor normalizado usa o código de país ISO 3166 de três letras da moeda de origem. |
| Exemplo de código | { "name": "entity:GLOBAL.MONEY", "value": "...", "score": 1.0, "normalization": {"type": "GLOBAL.MONEY", "value":"2000", "currency":"USD"} } |
[Tabela 11. Uso de GLOBAL.MONEY]

{#nlu-system-entities__table_c1b_wvd_lpb}

## Entidade do sistema GLOBAL.NUMBER {#nlu-system-entities__section_fn2_ywd_lpb}

Esta entidade retorna um número.  
{#nlu-system-entities__table_jxp_byd_lpb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | Valor da cadeia de caracteres. Exemplo: 5.0 |
| Expressão regular | Não aplicável. |
| Exemplo de entrada | Quero ver as últimas 5 transações da minha conta. |
| Valor normalizado | 5.0 |
| Exemplo de código | { "name": "entity:GLOBAL.NUMBER", "value": "...", "score": 1.0, "normalization": {"numericValue":"5", "normalizedValue": "5"} } |
[ ]

{#nlu-system-entities__table_jxp_byd_lpb}

## GLOBAL.SOFTWARE {#nlu-system-entities__section_cr2_scy_brb}

Retorna uma cadeia de caracteres de software.  
{#nlu-system-entities__table_oq4_vcy_brb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | Valor da cadeia de caracteres. Exemplo: Java |
| Expressão regular | Não aplicável. |
| Exemplo de entrada | Como instalo o Java? |
| Valor normalizado | Java |
| Exemplo de código | { "name": "entity:GLOBAL.SOFTWARE", "value": "Java", "score": 0.99930537, "normalization": {"type":"entity:GLOBAL.SOFTWARE", "subType":"SOFTWARE", "value":"Java"} } |
[ ]

{#nlu-system-entities__table_oq4_vcy_brb}

## GLOBAL.HARDWARE {#nlu-system-entities__section_bdt_xcy_brb}

Retorna uma cadeia de caracteres de hardware.  
{#nlu-system-entities__table_dfl_ycy_brb__entry__2}

| Uso | Exemplo |
|-|-|
| Formato | Valor da cadeia de caracteres. Exemplo: impressora |
| Expressão regular | Não aplicável. |
| Exemplo de entrada | Como compro uma impressora? |
| Valor normalizado | impressora |
| Exemplo de código | { "name": "entity:GLOBAL.HARDWARE", "value": "printer", "score": 1.0, "normalization": {"type":"entity:GLOBAL.HARDWARE", "subType":"HARDWARE", "value":"printer"} } |
[ ]

{#nlu-system-entities__table_dfl_ycy_brb}

## Exemplo de resultado de previsão de NLU usando a entidade do sistema Software {#nlu-system-entities__section_hlp_xdy_brb}

    {"status":"success",
       "response":{
          "utterance":"How do I install Java?",
          "intents":[
             {
                "intentName":"test intent",
                "nluModelName":"ml_x_snc_global_global_268a97a9dbd23c107906265d1396191a",
                "score":0.90401393,
                "intents":[
                   
                ],
                "entities":[
                   {
                      "name":"entity:GLOBAL.SOFTWARE",
                      "value":"Java",
                      "score":0.99930537,
                      "normalization":{
                         "type":"entity:GLOBAL.SOFTWARE",
                         "subType":"SOFTWARE",
                         "value":"Java"
                      },
                      "startingPosition":-1
                   }
                ]
             }
          ],
          "properties":{
             "all:ml_x_snc_global_global_268a97a9dbd23c107906265d1396191a":"0.55",
             "entity:all":"0.01",
             "inference.sspace.time":"4",
             "inference.time":"33",
             "intent:all":"0.01",
             "nluPlatformLanguage":"en",
             "nluPlatformVersion":"rome.0"
          }
       }
    }

## Exemplo de resultado de previsão de NLU usando a entidade do sistema DATE {#nlu-system-entities__section_f4c_gxd_lpb}

    {
        "utterance": "We should meet next Sunday at Starbucks.",
        "intents": [
            {
                "intentName": "intent:Desire.Desire",
                "score": 0.83452,
                "entities": []
            },
            {
                "intentName": "intent:Meeting.MeetRequest",
                "score": 0.8919042,
                "entities": [
                    {
                        "entityName": "entity:Meeting.MeetRequest.Where",
                        "value": "Starbucks",
                        "score": 1
                    },
         {
                        "entityName": "entity:GLOBAL.DATE",
                        "value": "Sunday",
                        "normalization": { "type": "DATE",
                            "subType": "DAY",
                            "value": "1999-10-01"
                         },
                        "score": 0.87
                    }
                ]
            }
        ]
    }

**Conceitos relacionados**   

* [Domain Separation e Virtual Agent](https://servicenow-prod.fluidtopics.net/mhf7E~4jc3GZPeh7AQVXLg "Domain Separation é compatível com o aplicativo Virtual Agent. O Domain Separation permite separar dados, processos e tarefas administrativas em agrupamentos lógicos chamados de domínios. Você pode controlar vários aspectos dessa separação, incluindo quais usuários podem ver e acessar os dados.")
* [Registro de interação do Virtual Agent](https://servicenow-prod.fluidtopics.net/rjxD6tMxWvyqfKgnw3u4nQ "Sempre que uma conversa do Virtual Agent ocorre, um registro de interação captura toda a conversa como um tipo de registro de bate-papo na tabela Interações [interaction]. O registro inclui todos os elementos de tópico usados na conversa, bem como as transferências para o atendente.")
* [Scripts Virtual Agent](https://servicenow-prod.fluidtopics.net/_zNKHyhzS4jqqcnQ~mt_rw "Use os métodos e variáveis de script ServiceNow Virtual Agent para escrever scripts de bate-papo, como resposta, gatilho e scripts de fluxo. As variáveis também podem fornecer contexto para seus tópicos e conversas de suporte ao vivo.")  
**Referência relacionada**   

* [Tipos de dados de entrada em tópicos Virtual Agent](https://servicenow-prod.fluidtopics.net/uPsxMHHTekvnOXgK_EHFpA "Você pode definir entradas de tipos de dados Glide Virtual Agent (com.glide.cs.chatbot) usados normalmente em Designer do Virtual Agent sem escrever um script. Defina o tipo de dados de entrada no nó inicial de um controle personalizado ou bloco de tópicos.")
* [Parâmetros de URL Virtual Agent](https://servicenow-prod.fluidtopics.net/FOFNPMRAswUJOiFxOlJCZw "Virtual Agent fornece vários parâmetros do sistema que os administradores podem adicionar a um URL de instância para controlar como o conteúdo da página é renderizado.")
* [Feedback de latência em Virtual Agent](https://servicenow-prod.fluidtopics.net/ON3wnzBqQCP0F9GBmggWsw "A propriedade do sistema com.glide.cs.message.processing.enabled notifica os solicitantes sempre que o grande modelo de linguagem (LLM) de IA generativa estiver processando a solicitação no cliente Web Virtual Agent e no painel Now Assist.")