NLU Entités système

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 fournisseur de NLU service ou fournies en dehors du champ d’application de la rubrique.

    Les entités système sont activées par défaut dans NLU les 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. DATE SubType = 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 a quitté les lieux 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 dates d’une semaine spécifique d’une année.

    Tableau 2. GLOBAL. DATE SubType = SEMAINE d’utilisation
    Utilisation Exemple
    Format YYYY’W’WW
    Expression régulière \\d\\d\\d\\d\\d\\dW\\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 dates d’un mois spécifique d’une année.

    Tableau 3. GLOBAL. DATE SubType = MOIS d’utilisation
    Utilisation Exemple
    Format AAAA’M’MM
    Expression régulière \\d\\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 dates d’une année spécifique.

    Tableau 4. GLOBAL. DATE SubType = ANNÉE d’utilisation
    Utilisation Exemple
    Format AAAA
    Expression régulière \\d\\d\\d\\d
    Exemple d’entrée M. Smith a quitté l’entreprise 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 dates d’une saison spécifique de l’année.

    Tableau 5. GLOBAL. DATE SubType = SEASON utilisation
    Utilisation Exemple
    Format L'un des éléments suivants :
    • Hiver : YYYYWI
    • Printemps : AAAAA
    • É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
    • Automne : \\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. HEURE Entité système

    Le sous-type TIME renvoie une chaîne de temps avec une précision d’une heure et d’une minute.

    Tableau 6. GLOBAL. TIME SubType = HEURE d’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 de temps qui spécifie les parties de la journée.

    Tableau 7. GLOBAL. Sous-type de temps = 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 dans la matinée.
    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 précises.

    Tableau 8. GLOBAL. DATE_TIME SubType = Utilisation de DATETIME
    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 quitte 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èmement : '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èmement : 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. EMPLACEMENT Entité système

    Cette entité retourne 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é retourne 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é retourne une chaîne de devise.

    Tableau 11. GLOBAL. Utilisation de l’ARGENT
    Utilisation Exemple
    Format Valeur de chaîne. Exemple : 2000 USD
    Expression régulière Non applicable.
    Exemple d’entrée Montrez-moi des ordinateurs portables pour moins de 2000 $.
    Valeur normalisée 2000 USD
    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é retourne 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 à partir 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 puis-je 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 utilisant 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
                }
            ]
        }
    ]
}