NLU Systementitäten

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer
  • Global definiert verwenden NLUEntitäten, um Systeminformationen zu identifizieren, die Virtual AgentKann aus der Konversation extrahiert werden. Sie können Entitäten als „knotenlose“ Eingabevariablen für ein Thema definieren. Diese Variablen können aus Slot gefüllt werden NLUService Provider-Vorhersagen oder außerhalb des Bereichs des Themas bereitgestellt.

    Systementitäten sind in aktiviert NLUModelle standardmäßig. Sie können sie im Modell anzeigen Entitäten Registerkarte in NLU-Workbench.

    GLOBAL.DATE-Systementität

    Der Untertyp „TAG“ gibt eine Datumszeichenfolge zurück, die einem bestimmten Datum entspricht.

    Tabelle : 1. Subtyp „GLOBAL.DATE“ = TAGESNUTZUNG
    Nutzung Beispiel
    Format JJJJ-MM-TT
    Regulärer Ausdruck \\d\\d\\d\\d-\\d\\d-\\d\\d
    Eingabebeispiel Herr Smith hat Freitag, 4. Februar 2019, verlassen.
    Normalisierter Wert 2019-02-04
    Codebeispiel
    {
    "name": "DATE", 
    "value": "...",
    "score": 1.0, 
    "normalization": "2019-02-04"
    }
    

    Der Untertyp „WOCHE“ gibt eine Datumszeichenfolge einer bestimmten Woche eines Jahres zurück.

    Tabelle : 2. Subtyp „GLOBAL.DATE“ = WOCHENNUTZUNG
    Nutzung Beispiel
    Format JJJJ'W'WW
    Regulärer Ausdruck \\d\\d\\d\\d\\DW\\d\\d
    Eingabebeispiel Herr Smith hat die dritte Woche des Jahres 1999 verlassen.
    Normalisierter Wert 1999W3
    Codebeispiel
    {
    "name": "entity:GLOBAL.DATE", 
    "value": "...",
    "score": 1.0, 
    "normalization": {"type": "GLOBAL.DATE", "subType": "WEEK", "value":"1999W3"}
    }
    

    Der Untertyp „MONAT“ gibt eine Datumszeichenfolge eines bestimmten Monats eines Jahres zurück.

    Tabelle : 3. Subtyp „GLOBAL.DATE“ = MONATSNUTZUNG
    Nutzung Beispiel
    Format JJJJ'M'MM
    Regulärer Ausdruck \\d\\d\\d\\DM\\d\\d
    Eingabebeispiel Herr Smith ist im Februar 1999 gegangen.
    Normalisierter Wert 1999M02
    Codebeispiel
    {
    "name": "entity:GLOBAL.DATE",
    "value": "...",
    "score": 1.0, 
    "normalization": {"type": "GLOBAL.DATE", "subType": "MONTH", "value": "1999M02"}
    }
    

    Der Untertyp „JAHR“ gibt eine Datumszeichenfolge eines bestimmten Jahres zurück.

    Tabelle : 4. Subtyp „GLOBAL.DATE“ = JAHRESNUTZUNG
    Nutzung Beispiel
    Format JJJJ
    Regulärer Ausdruck \\d\\d\\d\\d\\d
    Eingabebeispiel Herr Smith ist 1999 gegangen.
    Normalisierter Wert 1999
    Codebeispiel
    {
    "name": "entity:GLOBAL.DATE",
    "value": "...",
    "score": 1.0,
    "normalization": {"type": "GLOBAL.DATE", "subType": "YEAR", "value": "1999"}
    }
    

    Der SAISONUNTERTYP gibt eine Datumszeichenfolge einer bestimmten Jahreszeit zurück.

    Tabelle : 5. Subtyp „GLOBAL.DATE“ = SAISONNUTZUNG
    Nutzung Beispiel
    Format Eine der folgenden Optionen:
    • Winter : JJJJWI
    • Feder : JJJJJSP
    • Sommer : JJJJSU
    • Fallen : JJJJJFA
    Regulärer Ausdruck Eine der folgenden Optionen:
    • Winter : \\d\\d\\d\\DWI
    • Feder : \\d\\d\\d\\DSP
    • Sommer : \\d\\d\\d\\DSU
    • Fallen : \\d\\d\\d\\DFA
    Eingabebeispiel Herr Smith ist im Herbst 1999 gegangen.
    Normalisierter Wert 1999FA
    Codebeispiel
    {
    "name": "entity:GLOBAL.DATE",
    "value": "...",
    "score": 1.0,
    "normalization": {"type": "GLOBAL.DATE", "subType": "SEASON", "value": "1999FA"}
    }
    

    GLOBAL.TIME-Systementität

    Der Untertyp „ZEIT“ gibt eine Zeitzeichenfolge zurück, die auf eine Stunde und eine Minute genau ist.

    Tabelle : 6. Subtyp „GLOBAL.TIME“ = ZEITNUTZUNG
    Nutzung Beispiel
    Format „T'HH:mm
    Regulärer Ausdruck T\\d\\d:\\d\\d
    Eingabebeispiel Mr. Smith ist um zehn bis drei Minuten gegangen.
    Normalisierter Wert T02:50
    Codebeispiel
    {
    "name": "entity:GLOBAL.TIME", 
    "value": "...",
    "score": 1.0, 
    "normalization": {"type": "GLOBAL.TIME","subType": "TIME", "value": "T02:50"}
    }
    

    Der Untertyp „PARTSOFDAY“ gibt eine Zeitzeichenfolge zurück, die Teile des Tages angibt.

    Tabelle : 7. Subtyp „GLOBAL.TIME“ = PARTSOFDAY-Nutzung
    Nutzung Beispiel
    Format Eine der folgenden Optionen:
    • Morgens : TMO
    • Nachmittag : TAF
    • Abend : TEV
    • Nacht : TNI
    Regulärer Ausdruck Eine der folgenden Optionen:
    • Morgens : TMO
    • Nachmittag : TAF
    • Abend : TEV
    • Nacht : TNI
    Eingabebeispiel Mr. Smith ist morgens gegangen.
    Normalisierter Wert TMO
    Codebeispiel
    {
    "name": "entity:GLOBAL.TIME", 
    "value": "...",
    "score": 1.0, 
    "normalization": {"type": "GLOBAL.TIME", "subType": "PARTSOFDAY", "value": "TMO"}
    }
    

    Systementität „GLOBAL.DATE_TIME“

    Der Untertyp DATE_TIME gibt eine Datumszeichenfolge zurück, die auf ein bestimmtes Datum und eine bestimmte Uhrzeitzeichenfolge genau ist, die auf eine Stunde und eine Minute genau ist.

    Tabelle : 8. Subtyp „GLOBAL.DATE_TIME“ = DATETIME-Nutzung
    Nutzung Beispiel
    Format JJJJ-MM-TT'T'HH:MM
    Regulärer Ausdruck \\d\\d\\d-\\d\\d-\\d\\d\\DT\\d\\d:\\d\\d
    Eingabebeispiel Herr Smith geht am 31. Oktober um 17:00 Uhr
    Normalisierter Wert 2022-10-31T17:00
    Codebeispiel
    {
    "name": "DATE_TIME",
    "value": "October 31st at 5:00 p.m",
    "normalization": "2022-10-31T17:00","confidence": "1"
    }

    GLOBAL.DURATION-Systementität

    Diese Entität gibt eine Dauerzeichenfolge zurück, die die Dauer der Aktivität angibt.

    Tabelle : 9. GLOBAL.DURATION-Nutzung
    Nutzung Beispiel
    Format Eine der folgenden Optionen:
    • Sekunde : „S“
    • Minute : 'M' mm
    • Stunde : „H“ hh
    • Tag : „T“ TT
    • Woche : „W“ WW
    • Monat : 'M'MM
    • Jahr : „J“ JJ
    Regulärer Ausdruck Eine der folgenden Optionen:
    • Sekunde : S\\d\\d
    • Minute : M\\d\\d
    • Stunde : H\\d\\d
    • Tag : D\\d\\d
    • Woche : W\\d\\d
    • Monat : M\\d\\d
    • Jahr : Y\\d\\d
    Eingabebeispiel Herr Smith blieb 48 Stunden in Boston.
    Normalisierter Wert h48
    Codebeispiel
    {
    "name": "entity:GLOBAL.DURATION",
    "value": "...", 
    "score": 1.0,
    "normalization": {"type": "GLOBAL.DURATION", "value": "h48"}
    }
    

    GLOBAL.LOCATION-Systementität

    Diese Entität gibt eine Standortzeichenfolge zurück.

    Tabelle : 10. GLOBAL.LOCATION-Nutzung
    Nutzung Beispiel
    Format Zeichenfolgenwert. Beispiel: Santa Clara
    Regulärer Ausdruck Nicht zutreffend.
    Eingabebeispiel Herr Smith arbeitet in Santa Clara.
    Normalisierter Wert Santa Clara
    Codebeispiel
    {
    "name": "entity:GLOBAL.LOCATION",
    "value": "...", 
    "score": 1.0,
    "normalization": {"type": "GLOBAL.LOCATION", "value":"Santa Clara"}
    }
    

    GLOBAL.PERSON-Systementität

    Diese Entität gibt eine Namenszeichenfolge zurück.

    Nutzung Beispiel
    Format Zeichenfolgenwert. Beispiel: Joe Smith
    Regulärer Ausdruck Nicht zutreffend.
    Eingabebeispiel Joe Smith arbeitet in Santa Clara.
    Normalisierter Wert Joe Smith
    Codebeispiel
    {
    "name": "entity:GLOBAL.PERSON", 
    "value": "...",
    "score": 1.0, 
    "normalization": {"type": "GLOBAL.PERSON", "value":"Joe Smith"}
    }
    

    GLOBAL.MONEY-Systementität

    Diese Entität gibt eine Währungszeichenfolge zurück.

    Tabelle : 11. GLOBAL.GELDNUTZUNG
    Nutzung Beispiel
    Format Zeichenfolgenwert. Beispiel: 2000 USD
    Regulärer Ausdruck Nicht zutreffend.
    Eingabebeispiel Laptops für weniger als 2000 USD anzeigen.
    Normalisierter Wert 2000 USD
    Hinweis:
    Der normalisierte Wert verwendet den dreistelligen ISO 3166-Ländercode der Quellwährung.
    Codebeispiel
    {
    "name": "entity:GLOBAL.MONEY", 
    "value": "...",
    "score": 1.0, 
    "normalization": {"type": "GLOBAL.MONEY", "value":"2000", “currency”:”USD”}
    }
    

    GLOBAL.NUMBER-Systementität

    Diese Entität gibt eine Zahl zurück.

    Nutzung Beispiel
    Format Zeichenfolgenwert. Beispiel: 5,0
    Regulärer Ausdruck Nicht zutreffend.
    Eingabebeispiel Ich möchte die vorherigen 5 Transaktionen aus meinem Konto anzeigen.
    Normalisierter Wert 5,0
    Codebeispiel
    {
    "name": "entity:GLOBAL.NUMBER",
      "value": "...",
      "score": 1.0,
      "normalization": {"numericValue":"5", “normalizedValue”: “5”}
    }
    

    GLOBAL.SOFTWARE

    Gibt eine Softwarezeichenfolge zurück.

    Nutzung Beispiel
    Format Zeichenfolgenwert. Beispiel: Java
    Regulärer Ausdruck Nicht zutreffend.
    Eingabebeispiel Wie installiere ich Java?
    Normalisierter Wert Java
    Codebeispiel
    {
      "name": "entity:GLOBAL.SOFTWARE",
      "value": "Java",
      "score": 0.99930537,
      "normalization": {"type":"entity:GLOBAL.SOFTWARE",
                         "subType":"SOFTWARE",
                         "value":"Java"}
    }
    

    GLOBAL.HARDWARE

    Gibt eine Hardwarezeichenfolge zurück.

    Nutzung Beispiel
    Format Zeichenfolgenwert. Beispiel: Drucker
    Regulärer Ausdruck Nicht zutreffend.
    Eingabebeispiel Wie bestelle ich einen Drucker?
    Normalisierter Wert Drucker
    Codebeispiel
    {
      "name": "entity:GLOBAL.HARDWARE",
      "value": "printer",
      "score": 1.0,
      "normalization": {"type":"entity:GLOBAL.HARDWARE",
                         "subType":"HARDWARE",
                         "value":"printer"}
    }
    

    Beispiel NLUVorhersageergebnis mit Softwaresystementität

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

    Beispiel NLUVorhersageergebnis mit DATUMSSYSTEMENTITÄT

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