NLU Entités système

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 5 minutes de lecture

    • Utilisez des entités définies NLU globalement pour identifier les informations système qui Agent virtuel peuvent être extraites de la conversation. Vous pouvez définir des entités en tant que variables d’entrée « sans nœud » pour une rubrique. Ces variables peuvent être remplies à partir des prédictions du NLU fournisseur de services ou fournies en dehors du champ d’application de la rubrique.

    Les entités système sont activées par défaut dans les NLU modèles. Vous pouvez les afficher dans l’onglet Entités du modèle dans Console NLU.

    GLOBAL. DATE entité système

    Le sous-type DAY renvoie une chaîne de date précise à une date spécifique.

    Tableau 1. GLOBAL. Sous-type DATE = JOUR d’utilisation
    Utilisation Exemple
    Format AAAA-MM-JJ
    Expression régulière \\d\\d\\d\\d-\\d\\d-\\d\\d\\d
    Exemple d’entrée M. Smith est parti le vendredi 4 février 2019.
    Valeur normalisée 2019-02-04
    Exemple de code 
    {
"name": "DATE", 
"value": "...",
"score": 1.0, 
"normalization": "2019-02-04"
}

    Le sous-type WEEK renvoie une chaîne de date d’une semaine spécifique d’une année.

    Tableau 2. GLOBAL. Sous-type DATE = SEMAINE d’utilisation
    Utilisation Exemple
    Format YYYY’W’WW
    Expression régulière \\d\\d\\d\\d\\d\\d\d\\d
    Exemple d’entrée M. Smith est parti la troisième semaine de 1999.
    Valeur normalisée 1999W3
    Exemple de code 
    {
"name": "entity:GLOBAL.DATE", 
"value": "...",
"score": 1.0, 
"normalization": {"type": "GLOBAL.DATE", "subType": "WEEK", "value":"1999W3"}
}

    Le sous-type MONTH renvoie une chaîne de date d’un mois spécifique d’une année.

    Tableau 3. GLOBAL. Sous-type DATE = MOIS d’utilisation
    Utilisation Exemple
    Format AAAA’M’MM
    Expression régulière \\d\\d\\d\\dM\\d\\d
    Exemple d’entrée M. Smith est parti en février 1999.
    Valeur normalisée 1999M02
    Exemple de code 
    {
"name": "entity:GLOBAL.DATE",
"value": "...",
"score": 1.0, 
"normalization": {"type": "GLOBAL.DATE", "subType": "MONTH", "value": "1999M02"}
}

    Le sous-type YEAR renvoie une chaîne de date d’une année spécifique.

    Tableau 4. GLOBAL. Sous-type DATE = ANNÉE d’utilisation
    Utilisation Exemple
    Format AAAA
    Expression régulière \\d\\d\\d\\d
    Exemple d’entrée M. Smith est parti en 1999.
    Valeur normalisée 1999
    Exemple de code 
    {
"name": "entity:GLOBAL.DATE",
"value": "...",
"score": 1.0,
"normalization": {"type": "GLOBAL.DATE", "subType": "YEAR", "value": "1999"}
}

    Le sous-type SEASON renvoie une chaîne de date d’une saison spécifique de l’année.

    Tableau 5. GLOBAL. Sous-type DATE = Utilisation de la SAISON
    Utilisation Exemple
    Format L'un des éléments suivants :
    • Hiver : YYYYWI
    • Printemps : YYYYSP
    • Été : YYYYSU
    • Automne : AAAA
    Expression régulière L'un des éléments suivants :
    • Hiver : \\d\\d\\d\\d\\dWI
    • Ressort : \\d\\d\\d\\d\\dSP
    • Été : \\d\\d\\d\\d\\dSU
    • Chute : \\d\\d\\d\\d\\dFA
    Exemple d’entrée M. Smith est parti à l’automne 1999.
    Valeur normalisée 1999FA
    Exemple de code 
    {
"name": "entity:GLOBAL.DATE",
"value": "...",
"score": 1.0,
"normalization": {"type": "GLOBAL.DATE", "subType": "SEASON", "value": "1999FA"}
}

    GLOBAL. Entité système TIME

    Le sous-type TIME renvoie une chaîne d’heure précise à une heure et une minute.

    Tableau 6. GLOBAL. Sous-type TIME = TIME utilisation
    Utilisation Exemple
    Format 'T’HH :mm
    Expression régulière T\\d\\d :\\d\\d
    Exemple d’entrée M. Smith est parti à trois heures moins dix.
    Valeur normalisée T02:50
    Exemple de code 
    {
"name": "entity:GLOBAL.TIME", 
"value": "...",
"score": 1.0, 
"normalization": {"type": "GLOBAL.TIME","subType": "TIME", "value": "T02:50"}
}

    Le sous-type PARTSOFDAY renvoie une chaîne d’heure qui spécifie les parties de la journée.

    Tableau 7. GLOBAL. Sous-type TIME = utilisation PARTSOFDAY
    Utilisation Exemple
    Format L'un des éléments suivants :
    • Matin : TMO
    • Après-midi : TAF
    • Soirée : TEV
    • Nuit : TNI
    Expression régulière L'un des éléments suivants :
    • Matin : TMO
    • Après-midi : TAF
    • Soirée : TEV
    • Nuit : TNI
    Exemple d’entrée M. Smith est parti le matin.
    Valeur normalisée TMO
    Exemple de code 
    {
"name": "entity:GLOBAL.TIME", 
"value": "...",
"score": 1.0, 
"normalization": {"type": "GLOBAL.TIME", "subType": "PARTSOFDAY", "value": "TMO"}
}

    GLOBAL. DATE_TIME entité système

    Le sous-type DATE_TIME renvoie une chaîne de date précise à une date et une heure spécifiques à une heure et une minute.

    Tableau 8. GLOBAL. Sous-type DATE_TIME = DATETIME utilisation
    Utilisation Exemple
    Format AAAA-MM-JJ’T’HH :mm
    Expression régulière \\d\\d\\d\\d\\d\\d-\\d\\d\\dT\\d\\d :\\d\\d
    Exemple d’entrée M. Smith part le 31 octobre à 17h00.
    Valeur normalisée 2022-10-31T17:00
    Exemple de code 
    {
"name": "DATE_TIME",
"value": "October 31st at 5:00 p.m",
"normalization": "2022-10-31T17:00","confidence": "1"
}

    GLOBAL. DURÉE entité système

    Cette entité renvoie une chaîne de durée qui spécifie la durée de l’activité.

    Tableau 9. GLOBAL. DURÉE d’utilisation
    Utilisation Exemple
    Format L'un des éléments suivants :
    • Deuxième : 's’ss
    • Minute : 'm’mm
    • Heure : 'h’hh
    • Jour : 'D’DD
    • Semaine : 'W’WW
    • Mois : 'M’MM
    • Année : 'Y’YY
    Expression régulière L'un des éléments suivants :
    • Deuxième : s\\d\\d
    • Minute : m\\d\\d
    • Heure : h\\d\\d
    • Jour : J\\d\\d
    • Semaine : W\\d\\d
    • Mois : M\\d\\d
    • Année : Y\\d\\d
    Exemple d’entrée M. Smith est resté à Boston pendant 48 heures.
    Valeur normalisée h48
    Exemple de code 
    {
"name": "entity:GLOBAL.DURATION",
"value": "...", 
"score": 1.0,
"normalization": {"type": "GLOBAL.DURATION", "value": "h48"}
}

    GLOBAL. Entité système EMPLACEMENT

    Cette entité renvoie une chaîne d’emplacement.

    Tableau 10. GLOBAL. Utilisation de l’emplacement
    Utilisation Exemple
    Format Valeur de chaîne. Exemple : Santa Clara
    Expression régulière Non applicable.
    Exemple d’entrée M. Smith travaille à Santa Clara.
    Valeur normalisée Santa Clara
    Exemple de code 
    {
"name": "entity:GLOBAL.LOCATION",
"value": "...", 
"score": 1.0,
"normalization": {"type": "GLOBAL.LOCATION", "value":"Santa Clara"}
}

    GLOBAL. PERSONNE entité système

    Cette entité renvoie une chaîne de nom.

    Utilisation Exemple
    Format Valeur de chaîne. Exemple : Joe Smith
    Expression régulière Non applicable.
    Exemple d’entrée Joe Smith travaille à Santa Clara.
    Valeur normalisée Joe Smith
    Exemple de code 
    {
"name": "entity:GLOBAL.PERSON", 
"value": "...",
"score": 1.0, 
"normalization": {"type": "GLOBAL.PERSON", "value":"Joe Smith"}
}

    GLOBAL. Entité du système MONEY

    Cette entité renvoie une chaîne de devise.

    Tableau 11. GLOBAL. Utilisation d’ARGENT
    Utilisation Exemple
    Format Valeur de chaîne. Exemple : USD 2000
    Expression régulière Non applicable.
    Exemple d’entrée Montrez-moi des ordinateurs portables pour moins de 2000 $.
    Valeur normalisée 2000 dollars EU
    Remarque :
    La valeur normalisée utilise le code pays ISO 3166 à trois lettres de la devise source.
    Exemple de code 
    {
"name": "entity:GLOBAL.MONEY", 
"value": "...",
"score": 1.0, 
"normalization": {"type": "GLOBAL.MONEY", "value":"2000", “currency”:”USD”}
}

    GLOBAL. NUMÉRO entité système

    Cette entité renvoie un nombre.

    Utilisation Exemple
    Format Valeur de chaîne. Exemple : 5.0
    Expression régulière Non applicable.
    Exemple d’entrée Je veux voir les 5 transactions précédentes de mon compte.
    Valeur normalisée 5.0
    Exemple de code 
    {
"name": "entity:GLOBAL.NUMBER",
  "value": "...",
  "score": 1.0,
  "normalization": {"numericValue":"5", “normalizedValue”: “5”}
}

    GLOBAL. LOGICIEL

    Renvoie une chaîne logicielle.

    Utilisation Exemple
    Format Valeur de chaîne. Exemple : Java
    Expression régulière Non applicable.
    Exemple d’entrée Comment installer Java ?
    Valeur normalisée Java
    Exemple de code 
    {
  "name": "entity:GLOBAL.SOFTWARE",
  "value": "Java",
  "score": 0.99930537,
  "normalization": {"type":"entity:GLOBAL.SOFTWARE",
                     "subType":"SOFTWARE",
                     "value":"Java"}
}

    GLOBAL. MATÉRIEL

    Renvoie une chaîne matérielle.

    Utilisation Exemple
    Format Valeur de chaîne. Exemple : imprimante
    Expression régulière Non applicable.
    Exemple d’entrée Comment commander une imprimante ?
    Valeur normalisée printer
    Exemple de code 
    {
  "name": "entity:GLOBAL.HARDWARE",
  "value": "printer",
  "score": 1.0,
  "normalization": {"type":"entity:GLOBAL.HARDWARE",
                     "subType":"HARDWARE",
                     "value":"printer"}
}

    Exemple de NLU résultat de prédiction à l’aide de l’entité du système logiciel

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

    Exemple de NLU résultat de prédiction utilisant l’entité système DATE

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