NLU entidades do sistema

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 5 min. de leitura

    • Usar definido globalmente NLUentidades para identificar informações do sistema que Virtual Agentpode 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 slot de NLUprevisões do provedor de serviços ou fornecidas fora do escopo do tópico.

    As entidades do sistema estão habilitadas em NLUmodelos por padrão. Você pode exibi-los no modelo Entidades tab em Workbench de NLU.

    Entidade do sistema GLOBAL.DATE

    O subtipo DE DIA retorna uma cadeia de caracteres de data precisa para uma data específica.

    Tabela 1. Subtipo GLOBAL.DATE: Uso DIÁRIO
    Uso Exemplo
    Formato AAAA-MM-DD
    Expressão regular ""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"
}

    O subtipo DE SEMANA retorna uma cadeia de caracteres de data de uma semana específica de um ano.

    Tabela 2. Subtipo GLOBAL.DATE: Uso DA SEMANA
    Uso Exemplo
    Formato AAAA'W'WW
    Expressão regular Dw
    Exemplo de entrada O Sr. Smith deixou a terceira semana de 1999.
    Valor normalizado 1999W3
    Exemplo de código 
    {
"name": "entity:GLOBAL.DATE", 
"value": "...",
"score": 1.0, 
"normalization": {"type": "GLOBAL.DATE", "subType": "WEEK", "value":"1999W3"}
}

    O subtipo MÊS retorna uma cadeia de caracteres de data de um mês específico de um ano.

    Tabela 3. GLOBAL.DATE subtipo: MÊS DE uso
    Uso Exemplo
    Formato AAAA'M'MM
    Expressão regular DM
    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"}
}

    O subtipo YEAR retorna uma cadeia de caracteres de data de um ano específico.

    Tabela 4. Subtipo GLOBAL.DATE: ANO DE uso
    Uso Exemplo
    Formato AAAA
    Expressão regular "estou"
    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"}
}

    O subtipo DE ESTAÇÃO retorna uma cadeia de caracteres de data de uma estação específica do ano.

    Tabela 5. Subtipo GLOBAL.DATE: Uso DA ESTAÇÃO
    Uso Exemplo
    Formato Um dos seguintes:
    • Inverno : AAAAAA
    • Mola : AAAAAAA
    • Verão : AAAAAAAASU
    • Queda : AAAAAAFA
    Expressão regular Um dos seguintes:
    • Inverno DWI
    • Mola Dsp
    • Verão DSU
    • Queda DFA
    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"}
}

    Entidade do sistema GLOBAL.TIME

    O subtipo DE HORA retorna uma cadeia de caracteres de tempo com precisão de uma hora e um minuto.

    Tabela 6. Subtipo de TEMPO: Uso de TEMPO
    Uso Exemplo
    Formato "T'HH:mm
    Expressão regular T
    Exemplo de entrada O Sr. Smith saiu aos dez minutos a 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"}
}

    O subtipo PARTSOFDAY retorna uma cadeia de caracteres de tempo que especifica partes do dia.

    Tabela 7. Subtipo GLOBAL.TIME: Uso de PARTSOFDAY
    Uso Exemplo
    Formato Um dos seguintes:
    • Manhã TMO
    • À tarde : TAF
    • À noite TEV
    • Noite TNI
    Expressão regular Um dos seguintes:
    • Manhã TMO
    • À tarde : TAF
    • À noite TEV
    • Noite TNI
    Exemplo de entrada O Sr. Smith saiu de manhã.
    Valor normalizado TMO
    Exemplo de código 
    {
"name": "entity:GLOBAL.TIME", 
"value": "...",
"score": 1.0, 
"normalization": {"type": "GLOBAL.TIME", "subType": "PARTSOFDAY", "value": "TMO"}
}

    Entidade do sistema GLOBAL.DATE_TIME

    O subtipo DATE_TIME retorna uma cadeia de caracteres de data precisa de uma cadeia de caracteres de data e hora específica precisa de uma hora e um minuto.

    Tabela 8. Subtype GLOBAL.DATE_TIME: Uso do DATETIME
    Uso Exemplo
    Formato AAAA-MM-DD'T'HH:MM
    Expressão regular D- D- D- D- D: D
    Exemplo de entrada O Sr. Smith sai em 31 de outubro às 5:00 horas
    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"
}

    Entidade do sistema GLOBAL.DURATION

    Esta entidade retorna uma cadeia de caracteres de duração que especifica a duração da atividade.

    Tabela 9. Uso GLOBAL.DURAÇÃO
    Uso Exemplo
    Formato Um dos seguintes:
    • Segundo ''s'
    • Minuto : 'm'mm
    • Hora : 'h'hh
    • Dia : 'D'DD
    • Semana : "W'WW
    • Mês : 'M'MM
    • Ano : 'Y'YY
    Expressão regular Um dos seguintes:
    • Segundo : s/d
    • Minuto : m/d/d
    • Hora : h/d/d
    • Dia D/d/d/d
    • Semana : W/d/d
    • Mês : M/d/d
    • Ano : Sim
    Exemplo de entrada O Sr. Smith ficou 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"}
}

    Entidade do sistema GLOBAL.LOCATION

    Esta entidade retorna uma cadeia de caracteres de local.

    Tabela 10. Uso GLOBAL.LOCATION
    Uso Exemplo
    Formato Valor da cadeia de caracteres. Exemplo: Santa Clara
    Expressão regular Não aplicável.
    Exemplo de entrada 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"}
}

    Entidade do sistema GLOBAL.PERSON

    Esta entidade retorna uma cadeia de caracteres de nome.

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

    Entidade do sistema GLOBAL.MONEY

    Esta entidade retorna uma cadeia de caracteres de moeda.

    Tabela 11. GLOBAL.Uso de DINHEIRO
    Uso Exemplo
    Formato Valor da cadeia de caracteres. Exemplo: USD 2000
    Expressão regular Não aplicável.
    Exemplo de entrada Mostrar laptops por menos de USD 2000.
    Valor normalizado USD 2000
    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”}
}

    Entidade do sistema GLOBAL.NUMBER

    Esta entidade retorna um número.

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

    GLOBAL.SOFTWARE

    Retorna uma cadeia de caracteres de software.

    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"}
}

    HARDWARE.GLOBAL

    Retorna uma cadeia de caracteres de hardware.

    Uso Exemplo
    Formato Valor da cadeia de caracteres. Exemplo: impressora
    Expressão regular Não aplicável.
    Exemplo de entrada Como faço para solicitar 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"}
}

    Exemplo NLUResultado de previsão usando a entidade do sistema de software

    {"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 NLUResultado de previsão usando a entidade do sistema de DATA

    {
    "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
                }
            ]
        }
    ]
}