Oracle Cloud Infrastructure - Dokumentation

Integrierte Entitys

Wir stellen Entitys bereit, die sachliche Informationen aus der Benutzereingabe identifizieren, wie Uhrzeit, Datum und Adressen.


Beschreibung von system-entities-01.png folgt
Beschreibung der Abbildung system-entities-01.png

Diese integrierten Entitys extrahieren Primitive-Werte wie Zeichenfolgen und Ganzzahlen, können jedoch auch komplexere Werte aus der Benutzereingabe mit Eigenschaftsgruppen extrahieren.

Hinweis

Wenn Sie eine Variable als Entity in einem YAML-basierten Dialogablauf definieren, stellen Sie sicher, dass der Entityname und die Schreibschrift genau übereinstimmen. Beispiel: Sie erhalten einen Validierungsfehler, wenn Sie confirm: "YESNO" anstelle von confirm: “YES_NO” eingeben.

Integrierte Entitys und ihre Eigenschaften

Entitys extrahieren Inhalte mit Eigenschaften, von denen jede einen bestimmten Wert erkennt. Diese Eigenschaften werden in der JSON-Ausgabe angezeigt, die von der NLU-Engine zurückgegeben wird. In dieser Ausgabe werden die übereinstimmenden Entitys zusammen mit dem Wert angezeigt, den sie aus der Benutzereingabe identifiziert haben. In der Dialogablaufdefinition können Sie diese Eigenschaften verwenden, um ein bestimmtes Facet eines Entitywertes zu isolieren. Während jede Entity ihre spezifischen Eigenschaften hat, haben alle Entitys die folgenden Eigenschaften:
Eigenschaft Beschreibung
beginOffset Der Anfangsversatz dieses geschlitzten Entitywerts, der bei 0 beginnt.
endOffset Der Endversatz dieses geschlitzten Entitywerts, der bei 0 beginnt.
originalString Die ursprüngliche Zeichenfolge, die aus der Abfrage für diesen Entity-Slot oder die Antwort auf die Eingabeaufforderung extrahiert wurde.
Hinweis

Die Entitys DATE, TIME und DURATION sind in Release 22.08 veraltet. Diese Entitäten sind nicht für Skills verfügbar, die in dieser Version der Plattform erstellt wurden. Stattdessen wird die Entity DATE_TIME verwendet. Vorhandene Fähigkeiten, die auf 22.08 upgegradet wurden, werden diese Legacy-Systementitäten weiterhin unterstützen, obwohl es einige Verhaltensänderungen geben kann.
Entityname Exportierter Inhalt Beispiele Eigenschaften (in Wertausdrücken referenziert) Beispielantwort der NLU-Engine
ADRESSE: Ort, Hausnummer und Straße

Diese Entity ist nur auf Englisch verfügbar.

 500 Smith Road, Smithville

  • city

  • houseNumber

  • road 

{
"road": "smith road",
"city": "smithville",
"entityName": "ADDRESS",
"houseNumber": "500",
"originalString": "500 Smith Road, Smithville"
}
CURRENCY Darstellung von Geldbeträgen. Sie können die Währungen $ und ¥ durch das erkannte Gebietsschema des Benutzers eindeutig machen.

  • $67

  • 75 Dollar

  • amount

  • currency

  • totalCurrency

"CURRENCY": [ { "amount": 550, "currency": "usd", "totalCurrency": "550.0 usd", "entityName": "CURRENCY" } ]
DATE Ein absolutes oder relatives Datum.

Diese Entität ist in Version 22.08 veraltet und für Skills, die in dieser Version der Plattform erstellt wurden, nicht mehr verfügbar. Bei Skills, die mit früheren Versionen erstellt wurden, sollten Sie stattdessen die Entity DATE_TIME verwenden.

Hinweis: Wenn die Benutzereingabe einen Tag benannt, aber keinen anderen zeitlichen Kontext angibt, wird diese Angabe vom System als zukünftiges Datum betrachtet. Beispiel: In der folgenden Eingabe wird "Mittwoch" als der kommende Mittwoch und nicht als der aktuelle Mittwoch oder der vorherige Mittwoch betrachtet.

  • Buche mir ein Ticket für Mittwoch.

  • Ich möchte eine Spesenabrechnung für Mittwoch.

Sie können dieses Verhalten überschreiben, indem Sie eine Mehrdeutigkeitsauflösungsregel anwenden. Während die DATE-Entity das Format mehrerer unterstützter Gebietsschemas auflöst, können Sie das Format des erkannten Gebietsschemas ignorieren und ein Standardformat und eine angespannte (zukünftige, vergangene, nächste usw.) festlegen, indem Sie eine Mehrdeutigkeitsauflösungsregel anwenden.

  • November 9, 2016

  • Heute

 date 
  {
          "entityName": "Meeting",
          "DATE_TIME": [
            {
              "originalString": "Monday, October 16th",
              "bagItem": "Meeting:DateTime",
              "subType": "DATE",
              "timeZone": "UTC",
              "movableDateValue": "--10-16",
              "relativeRepresentation": "--10-16",
              "entityName": "DATE_TIME",
              "value": "2022-10-16"
            }
          ]
        }
      ]
DATE_TIME Extrahiert verschiedene zeitbezogene Informationen über die folgenden Subtypen: ein Datum, eine Uhrzeit, ein Datum und Uhrzeit, ein wiederkehrendes Ereignis, ein Intervall oder eine Dauer.
  • Datum: 1. Januar 2023
  • Zeit: 10am
  • Datum und Uhrzeit: 1. Januar 2023 um 10 Uhr
  • Intervall: 1. Januar 2023 von 10 Uhr für 2 Stunden
  • Dauer: 2 Stunden
   Für "Treffen für jeden Dienstag von 10:00 Uhr bis 1 Uhr ab dem 23. Januar 2022 bis zum 23. Februar planen":
   "entityMatches": {
      "Meeting": [
        {
          "entityName": "Meeting",
          "DATE_TIME": [
            {
              "originalString": "February 23",
              "bagItem": "Meeting:DateTime",
              "subType": "DATE",
              "timeZone": "UTC",
              "role": "end",
              "movableDateValue": "--02-23",
              "relativeRepresentation": "--02-23",
              "entityName": "DATE_TIME",
              "value": "2023-02-23"
            },
            {
              "originalString": "January 23, 2022",
              "bagItem": "Meeting:DateTime",
              "subType": "INTERVAL",
              "startDate": {
                "originalString": "January 23, 2022",
                "subType": "DATE",
                "timeZone": "UTC",
                "entityName": "DATE_TIME",
                "value": "2022-01-23"
              },
              "entityName": "DATE_TIME"
            },
            {
              "originalString": "every Tuesday from 10:00 am to 1 pm",
              "bagItem": "Meeting:DateTime",
              "subType": "RECURRING",
              "timeZone": "UTC",
              "recurrenceFrequency": {
                "originalString": "every Tuesday from 10:00 am to 1 pm",
                "subType": "DURATION",
                "timeZone": "UTC",
                "entityName": "DATE_TIME",
                "value": "P1W"
              },
              "startInterval": {
                "originalString": "Tuesday from 10:00 am to 1 pm",
                "subType": "INTERVAL",
                "timeZone": "UTC",
                "startDate": {
                  "originalString": "Tuesday",
                  "subType": "DATE",
                  "timeZone": "UTC",
                  "weekday": "TU",
                  "relativeReference": "weekday",
                  "entityName": "DATE_TIME",
                  "value": "2022-10-18"
                },
                "startTime": {
                  "originalString": "10:00 am",
                  "subType": "TIME",
                  "timeZone": "UTC",
                  "entityName": "DATE_TIME",
                  "value": "10:00:00"
                },
                "endTime": {
                  "originalString": "1 pm",
                  "subType": "TIME",
                  "timeZone": "UTC",
                  "entityName": "DATE_TIME",
                  "value": "13:00:00"
                },
                "entityName": "DATE_TIME"
              },
              "entityName": "DATE_TIME"
            }
          ]
        }
      ]
    }
  • Interpretation vom 23. Februar gemäß den Zeitauflösungsregeln. Da der Anwendungsfall für die Planung einer Besprechung ist, wird das Datum immer als zukunftsgerichtet interpretiert. 
    "movableDateValue": "--02-23",
              "relativeRepresentation": "--02-23"
  • "value": "P1W": Eine Standarddarstellung von ISO 8601-Austausch wöchentlich/einmal pro Woche, wobei P der Dauerdesigator und W der Wochendesignator ist.
DURATION Die Zeitspanne zwischen den beiden Endpunkten eines Zeitintervalls

Diese Entität ist in Version 22.08 veraltet und für Skills, die in dieser Version der Plattform erstellt wurden, nicht mehr verfügbar. Bei Skills, die mit früheren Versionen erstellt wurden, sollten Sie stattdessen die Entity DATE_TIME verwenden.

  • 4 Jahren

  • zwei Wochen

  • startDate

  • endDate

[ { "originalString": "2 hours", "bagItem": "Meeting:DateTime", "subType": "DURATION", "timeZone": "UTC", "entityName": "DATE_TIME", "value": "PT2H" } ] } ]
EMAIL Eine E-Mail-Adresse. Das NLU-System kann E-Mail-Adressen erkennen, die eine Kombination aus folgenden Elementen enthalten:
  • Teil vor dem At-Zeichen (@):
    • Groß- und Kleinbuchstaben im Lateinischen Alphabet (A-Z und a-z)
    • Ziffern (0-9)
    • folgende druckbare Zeichen: !#$%&'*+-/=?^_`{}~
    • Punkt (.)
  • Teil nach dem At-Zeichen (@):
    • Groß- und Kleinbuchstaben im Lateinischen Alphabet (A-Z und a-z)
    • Ziffern (0-9)
    • Bindestrich (-)
ragnar.smith@example.com    
SPEICHERORT Extrahiert Städte, Bundesländer und Länder aus den Eingaben des Benutzers.
  • Redwood City
  • CA
  • USA
  • city
  • state
  • country
"LOCATION": [ { "originalString": "Redwood City, CA, USA", "name": "redwood city, ca, usa", "country": "usa", "state": "ca", "city": "redwood city", "entityName": "LOCATION" } ]
NUMBER Gleicht Ordinal- und Kardinalzahlen ab. Sie können eine Entity als gebietsschemaspezifisches Format auflösen (Gruppierung von Tausenden durch vollständige Stopps, Kommas, Leerzeichen usw.).

  • 1st

  • Vorname

  • 1

  • eine

    
PERSON Erkennt eine Zeichenfolge als Namen einer Person.

Die PERSON-Entity darf nicht mit Namen übereinstimmen, die auch Standorte sind (z.B. Virginia North).

Um die Entity "PERSON" so zu erweitern, dass sie immer mit den Personen in Ihrer Organisation übereinstimmt, können Sie sie einer Entity "Werteliste" zuordnen.
  • John J. Jones
  • Ashok Kumar
  • Gabriele D'Annunzio
  • Jones, David
  • Cantiflas
  • Zhang San
  • Virginia Jones
 name "PERSON": [ { "originalString": "John J. Johnson", "name": "john j. johnson", "entityName": "PERSON" } ]
TELEFONNUMMER Eine Telefonnummer - Die NLU-Engine erkennt Telefonnummern mit sieben oder mehr Ziffern (sie kann keine Telefonnummern mit weniger Ziffern erkennen). Jeder Ländervorwahl muss ein Pluszeichen (+) als Präfix vorangestellt sein, mit Ausnahme der USA (wo das Pluszeichen optional ist). Die verschiedenen Teile der Telefonnummer (Vorwahl, Präfix und Durchwahl) können durch Punkte (.), Bindestriche (-) oder Leerzeichen getrennt werden. Wenn mehrere Telefonnummern in der Benutzereingabe eingegeben werden, kann die NLU-Engine sie erkennen, wenn sie durch Kommas getrennt sind. Sie kann keine unterschiedlichen Telefonnummern erkennen, wenn sie durch Punkte, Bindestriche oder Leerzeichen getrennt sind.

  • (650 - 555 - 5555)

  • 16.505.555.555

  • +61,3

  • phoneNumber

  • completeNumber

{ "phone_number":"(650)-555-5555", "complete_number":"(650)-555-5555", "entityName":"PHONE_NUMBER" }
TIME Eine bestimmte Uhrzeit.

Diese Entität ist in Version 22.08 veraltet und für Skills, die in dieser Version der Plattform erstellt wurden, nicht mehr verfügbar. Bei Skills, die mit früheren Versionen erstellt wurden, sollten Sie stattdessen die Entity DATE_TIME verwenden.

In einigen Fällen, z.B. wenn die Eingabe mehrdeutig ist, benötigen Sie möglicherweise die TIME-Entity, um die Eingabe konsistent als vergangene oder zukünftige Zeit aufzulösen oder um die nächste Zeit zu approximieren. Wenden Sie dazu eine Mehrdeutigkeitsauflösungsregel an.

14:30 Uhr

  • hrs

  • mins

  • secs

  • "hourFormat":"PM"

"startTime": { "date": 1613653200000, "zoneOffset": "0", "endOffset": 4, "mins": 0, "zone": "UTC", "entityName": "TIME", "secs": 0, "hrs": 1, "originalString": "1 pm", "type": "TIME", "hourFormat": "PM", "beginOffset": 0 }
URL Eine URL - Diese Entity kann IPv4-Adressen, Web-URLs, Deeplinks (http://example.com/path/page), Dateipfade und mailto-URIs extrahieren. Wenn in der Benutzereingabe Anmeldedaten angegeben sind, muss sie auch das Protokoll enthalten. Ansonsten ist das Protokoll nicht erforderlich. http://example.com

  • protocol

  • domain

  • fullPath

{"protocol":"http","domain":"example.com",}
YES_NO Ermittelt ein "Ja" oder ein "Nein".     "YES_NO": [ { "beginOffset": 0, "endOffset": 4, "originalString": "Yeah", "yesno": "YES", "entityName": "YES_NO", "type": "YES_NO" } ]

Die Entity DATE_TIME

Es gibt viele Möglichkeiten, wie Ihr Skill Datum und Uhrzeit eingeben muss. Beispiel: Sie benötigen ein einfaches Datum oder eine einfache Uhrzeit, ein Datum und eine Uhrzeit oder eine einmalige oder wiederkehrende Periode. Mit der Entity DATE_TIME können Sie Informationen für alle diese Szenarios erfassen.

Mit der Entity DATE_TIME wählen Sie einen bestimmten Subtyp, um zu definieren, welche Informationen erfasst werden sollen. Die folgende Tabelle zeigt, welcher Subtyp für jedes mögliche Szenario verwendet werden soll, und verweist auf Informationen zu den Attributen für jeden Subtyp.

Szenario DATE_TIME-Subtyp Referenz
Ein Datum. Datum. DATE-Subtypattribute
Eine Zeit. Zeit TIME-Subtypattribute
Ein Datum und eine Uhrzeit. Datum und Uhrzeit DATETIME-Subtypattribute
Eine Zeitspanne. Beispiel: 1 Stunde oder 4 Tage. Dauer DURATION-Subtypattribute
Ein einzelnes Vorkommen einer Periode, die durch ein Anfangs- und Enddatum oder ein Anfangs- und Enddatum und eine Endzeit definiert ist. Intervall INTERVAL-Subtypattribute
Eine regelmäßig wiederkehrende Periode, die beispielsweise durch den Start und das Ende der ersten Periode, das Intervall zwischen den wiederkehrenden Perioden und den Zeitpunkt definiert ist, zu dem die Perioden wiederkehrend enden. Wiederholt Attribute für RECURRING-Subtyp
Hinweis

Die Entity DATE_TIME ersetzt die Systementitäten DATE, TIME, DURATION und SET, die veraltet sind und in Skills, die in Release 22.08 und höher erstellt wurden, nicht verfügbar sind. Vorhandene Fähigkeiten, die auf 22.08 aktualisiert wurden, unterstützen diese veralteten Systementitäten, obwohl es einige Verhaltensänderungen geben kann.
Sie können die Subtypen "Datum", "Uhrzeit" und "Dauer" als eigenständige Entitys im Dialogablauf verwenden (wo Sie jeweils separate Variablen deklarieren). Sie können jedoch nur die Subtypen "Intervall" und "Wiederkehrend" verwenden, indem Sie sie in eine Composite-Bag-Entity integrieren.
Hinweis

Es wird empfohlen, alle DATE_TIME-Subtypen innerhalb einer Mischentity zu verwalten.

Im visuellen Dialogmodus referenzieren Sie DATE_TIME-Subtypen mit den Status "Entity auflösen" und "Deklarative Entity auflösen".

Hinweis

Wenn Sie die Subtypen "Datum", "Uhrzeit" und "Dauer" als eigenständige Entitys in einem YAML-basierten Dialogablauf verwenden, geben Sie den Subtyp mit Punktnotation an: DATE_TIME.DATE, DATE_TIME.TIME, DATE_TIME.DURATION und für SET, DATE_TIME.RECURRING. Beispiel:
context:
  variables:
    iResult: "nlpresult"
    Startdate: "DATE_TIME.DATE"
    duration: "DATE_TIME.DURATION"
Im Knoten states referenzieren Sie diese Variablen mit einer System.ResolveEntities-Komponente.
DATE_TIME-Werte werden als ISO 8601 dargestellt. Für eine benutzerfreundliche Ausgabe verwenden Sie den Apache FreeMarker .xs integriert. Beispiel: Der Zeitsubtyp wird mit .value.value?time.xs?string['hh:mm a'] in der folgenden Resource Bundle-Referenz extrahiert:
${rb('pizzaDeliveryMessage','time',deliveryTime.value.value?time.xs?string['hh:mm a'])}
Die erste value ruft den Inhalt der Variablen als Objekt ab. Die zweite value ist ein Attribut des Objekts DATE_TIME, das den Zeitwert enthält.

Attribute für jeden DATE_TIME-Subtyp

Im Folgenden werden die Attribute für jeden DATE_TIME-Subtyp aufgeführt.

Beachten Sie, dass die Subtypen wie jede andere Systementity auch die Eigenschaften beginOffset, endOffset und originalString enthalten.

DATE-Subtypattribute

Der DATE-Subtyp enthält die folgenden Attribute zu einem bestimmten Datum:

Attribut Typ Erläuterung
entityName Zeichenfolge DATE_TIME
month Ganzzahl

Wenn DATE ein Attribut des RECURRING-Subtyps ist und die ursprüngliche Zeichenfolge den Namen eines Monats enthält, z. B. "jeden Montag im Juli", stellt dies die numerische Darstellung ("7" in diesem Beispiel) des explizit angegebenen Monatswerts dar.
movableDateValue Zeichenfolge

Wenn DATE ein Attribut von RECURRING ist und das Einstufungsdatum kein bestimmtes Datum darstellt (d.h. ein bewegliches Datum, z.B. 4. Juli), stellt dies den explizit angegebenen Wert für das bewegliche Datum dar, das vom DATE-Attribut des RECURRING-Subtyps verwendet wird, um zwischen dem berechneten beweglichen Datum und dem berechneten nicht beweglichen Datum zu unterscheiden. Beispiel: Wenn das Schlitzdatum der 4. Juli ist, lautet dieser Wert --07-04.

ordinal Ganzzahl

Wenn DATE ein Attribut des RECURRING-Subtyps ist und die ursprüngliche Zeichenfolge einen Ordinalwert angibt, wie z.B. zuerst in "jeden ersten Montag", stellt dies den numerischen Wert der Ordinalzahl dar (in diesem Beispiel "1").
ordinalReference Enum

Wenn DATE ein Attribut des RECURRING-Subtyps ist und die ursprüngliche Zeichenfolge eine Ordinalzahl enthält, die durch den Namen eines Monats qualifiziert ist, z.B. Juli in "jeden ersten Montag im Juli", stellt dies den explizit angegebenen Qualifier dar ("M" für Monat).
subType Zeichenfolge DATE
timezone Zeichenfolge Die Zeitzonenverschiebung. Beispiel: +07:00.
type Zeichenfolge DATE_TIME
value Zeichenfolge Der aufgelöste Wert im ISO 8601-Format. Beispiel 2022-08-05.
weekday Enum

Wenn DATE ein Attribut des RECURRING-Subtyps ist und die ursprüngliche Zeichenfolge den Namen eines Tages enthält, z.B. "jeden Montag", stellt dies den explizit angegebenen Wochentagswert im Format iCalendar dar, wie MO, TU und WE.
year Ganzzahl

Wenn DATE ein Attribut des RECURRING-Subtyps ist und die ursprüngliche Zeichenfolge das Jahr enthält, z.B. "jeden Montag 2023", stellt dies den explizit angegebenen Jahreswert dar.

Im Folgenden finden Sie ein Beispiel für die NLU-Antwort für den DATE-Subtyp:

          "aDate": {
            "endOffset": 8,
            "entityName": "DATE_TIME",
            "timeZone": "-10:00",
            "originalString": "tomorrow",
            "subType": "DATE",
            "type": "DATE_TIME",
            "value": "2022-09-07",
            "beginOffset": 0
          }

TIME-Subtypattribute

Der TIME-Subtyp enthält die folgenden Attribute zu einer bestimmten Zeit:

Attribut Typ Erläuterung
entityName Zeichenfolge DATE_TIME
subType Zeichenfolge TIME
timezone Zeichenfolge Die Zeitzonenverschiebung. Beispiel: +07:00.
type Zeichenfolge DATE_TIME
value Zeichenfolge Der aufgelöste Wert im ISO 8601-Format. Beispiel 12:00:00.

Im Folgenden finden Sie ein Beispiel für die NLU-Antwort für die TIME-Entity:

          "aTime": {
            "endOffset": 4,
            "entityName": "DATE_TIME",
            "timeZone": "-10:00",
            "originalString": "2 pm",
            "subType": "TIME",
            "type": "DATE_TIME",
            "value": "14:00:00",
            "beginOffset": 0
          }

DATETIME-Subtypattribute

Der DATETIME-Subtyp enthält die folgenden Attribute zu einem bestimmten Datum und einer bestimmten Uhrzeit:

Attribut Typ Erläuterung
date DATE Dieses Objekt enthält die unter Datums-Subtypattribute beschriebenen Attribute.
entityName Zeichenfolge DATE_TIME
subType Zeichenfolge DATETIME
time TIME Dieses Objekt enthält die unter ZEIT-Subtypattribute beschriebenen Attribute.

Im Folgenden finden Sie ein Beispiel für die NLU-Antwort für den DATETIME-Subtyp:


          "aDateAndTime": {
            "date": {
              "endOffset": 5,
              "entityName": "DATE_TIME",
              "timeZone": "-10:00",
              "originalString": "today",
              "subType": "DATE",
              "type": "DATE_TIME",
              "value": "2022-09-06",
              "beginOffset": 0
            },
            "entityName": "DATE_TIME",
            "subType": "DATETIME",
            "time": {
              "endOffset": 13,
              "entityName": "DATE_TIME",
              "timeZone": "-10:00",
              "originalString": "noon",
              "subType": "TIME",
              "type": "DATE_TIME",
              "value": "12:00:00",
              "beginOffset": 9
            }
          }

DURATION-Subtypattribute

Der Subtyp DURATION enthält die folgenden Attribute für einen Tag oder eine Zeitdauer, z.B. 1 Woche:

Attribut Typ Erläuterung
entityName Zeichenfolge DATE_TIME
subType Zeichenfolge DURATION
timezone Zeichenfolge Die Zeitzonenverschiebung. Beispiel: +07:00.
type Zeichenfolge DATE_TIME
value Zeichenfolge Dauer im Format ISO 8601. Beispiele: PT1H für 1 Stunde,P4D für 4 Tage, P1W für 1 Woche, P2M für 2 Monate.

Im Folgenden finden Sie ein Beispiel für die NLU-Antwort für den Subtyp DURATION:

          "aDuration": {
            "endOffset": 7,
            "entityName": "DATE_TIME",
            "timeZone": "-10:00",
            "originalString": "3 hours",
            "subType": "DURATION",
            "type": "DATE_TIME",
            "value": "PT3H",
            "beginOffset": 0
          }

INTERVAL-Subtypattribute

Der INTERVAL-Subtyp enthält diese Attribute für eine Periode, die durch ein Anfangs- und Enddatum und eine Endzeit definiert ist oder durch ein Datum, eine Startzeit und eine Länge definiert ist, z.B. 2 Stunden.

Attribut Typ Erläuterung
duration ENTITY Dieses Objekt enthält die unter DURATION-Subtypattribute beschriebenen Attribute.
endDate DATE Dieses Objekt enthält die unter Datums-Subtypattribute beschriebenen Attribute.

Eingeschlossen für die Prompt-Typen "Datum und Uhrzeit" und "Nur Datum".
endTime TIME Dieses Objekt enthält die unter ZEIT-Subtypattribute beschriebenen Attribute.

Eingeschlossen für die Prompt-Typen "Nur Datum und Uhrzeit" und "Nur Zeit".
entityName Zeichenfolge DATE_TIME
startDate DATE Dieses Objekt enthält die unter Datums-Subtypattribute beschriebenen Attribute.

Eingeschlossen für die Prompt-Typen "Datum und Uhrzeit" und "Nur Datum".
startTime TIME Dieses Objekt enthält die unter ZEIT-Subtypattribute beschriebenen Attribute.

Eingeschlossen für die Prompt-Typen "Nur Datum und Uhrzeit" und "Nur Zeit".
subType Zeichenfolge INTERVAL

Im Folgenden finden Sie ein Beispiel für die NLU-Antwort für die INTERVAL-Entity mit dem Prompt-Typ "Datum und Uhrzeit":

          "anInterval": {
            "duration": {
              "entityName": "DATE_TIME",
              "subType": "DURATION",
              "value": "P1D"
            },
            "endDate": {
              "endOffset": 8,
              "entityName": "DATE_TIME",
              "timeZone": "-10:00",
              "originalString": "tomorrow",
              "subType": "DATE",
              "type": "DATE_TIME",
              "value": "2022-09-07",
              "beginOffset": 0
            },
            "entityName": "DATE_TIME",
            "subType": "INTERVAL",
            "startTime": {
              "endOffset": 4,
              "entityName": "DATE_TIME",
              "timeZone": "-10:00",
              "originalString": "noon",
              "subType": "TIME",
              "type": "DATE_TIME",
              "value": "12:00:00",
              "beginOffset": 0
            },
            "endTime": {
              "endOffset": 4,
              "entityName": "DATE_TIME",
              "timeZone": "-10:00",
              "originalString": "noon",
              "subType": "TIME",
              "type": "DATE_TIME",
              "value": "12:00:00",
              "beginOffset": 0
            },
            "startDate": {
              "endOffset": 5,
              "entityName": "DATE_TIME",
              "timeZone": "-10:00",
              "originalString": "today",
              "subType": "DATE",
              "type": "DATE_TIME",
              "value": "2022-09-06",
              "beginOffset": 0
            }
          }

Attribute für RECURRING-Subtyp

Der Subtyp RECURRING enthält die folgenden Attribute für eine regelmäßig wiederkehrende Periode:

Attribut Typ Erläuterung
entityName Zeichenfolge DATE_TIME
recurrenceDates DATE-Array Wird eingeschlossen, wenn mehrere wiederkehrende Termine angegeben werden. Dieses Objekt enthält ein Array von DATE-Objekten mit den unter Datums-Subtypattribute beschriebenen Attributen.
recurrenceFrequency DURATION Dieses Objekt enthält die unter DURATION-Subtypattribute beschriebenen Attribute.
recurrenceTimes Array der Zeit Wird eingeschlossen, wenn mehrere wiederkehrende Zeiten angegeben werden. Dieses Objekt enthält ein Array von TIME-Objekten mit den unter TIME-Subtypattribute beschriebenen Attributen.
recurrenceUntil INTERVALL Gibt die Grenzen der Wiederholung an. In der Regel wird nur das Enddatum angegeben. Dieses Objekt enthält die unter INTERVAL-Subtypattribute beschriebenen Attribute.
startDate DATE Dieses Objekt enthält die unter Datums-Subtypattribute beschriebenen Attribute.

Beachten Sie, dass das DATE-Objekt für RECURRING-Entitys die Attribute month, movevableDateValue, ordinal, ordinalReference, weekday und year enthalten kann.

Für Prompt-Typ "Nur Datum" enthalten.
startDateTime UHRZEIT Dieses Objekt enthält die unter DATETIME-Subtypattribute beschriebenen Attribute.

Beachten Sie, dass das DATE-Unterobjekt von DATETIME für RECURRING-Entitys die Attribute month enthalten kann. movevableDateValue, ordinal, ordinalReference, weekday und year.

Für Eingabeaufforderungstyp "Datum und Uhrzeit" enthalten.
startInterval INTERVALL Dieses Objekt enthält die unter INTERVAL-Subtypattribute beschriebenen Attribute.
startTime TIME Dieses Objekt enthält die unter ZEIT-Subtypattribute beschriebenen Attribute.

Für Prompt-Typ "Nur Zeit" enthalten.
subType Zeichenfolge RECURRING

Im Folgenden finden Sie ein Beispiel für die NLU-Antwort für den Untertyp RECURRING mit dem Prompt-Typ "Datum und Uhrzeit":

          "aRecurringPeriod": {
            "startInterval": {
              "duration": {
                "entityName": "DATE_TIME",
                "subType": "DURATION",
                "value": "PT1H"
              },
              "endDate": {
                "entityName": "DATE_TIME",
                "timeZone": "-10:00",
                "subType": "DATE",
                "value": "2022-07-28"
              },
              "entityName": "DATE_TIME",
              "subType": "INTERVAL",
              "startTime": {
                "endOffset": 7,
                "entityName": "DATE_TIME",
                "timeZone": "-10:00",
                "originalString": "12 noon",
                "subType": "TIME",
                "bagItem": "Meeting:DateTime",
                "type": "DATE_TIME",
                "value": "12:00:00",
                "beginOffset": 0
              },
              "endTime": {
                "entityName": "DATE_TIME",
                "timeZone": "-10:00",
                "subType": "TIME",
                "value": "13:00:00"
              },
              "startDate": {
                "endOffset": 8,
                "entityName": "DATE_TIME",
                "timeZone": "-10:00",
                "originalString": "tomorrow",
                "subType": "DATE",
                "bagItem": "Meeting:DateTime",
                "type": "DATE_TIME",
                "value": "2022-07-28",
                "beginOffset": 0
              }
            },
            "recurrenceFrequency": {
              "endOffset": 10,
              "entityName": "DATE_TIME",
              "timeZone": "-10:00",
              "originalString": "every week",
              "subType": "DURATION",
              "type": "DATE_TIME",
              "bagItem": "Meeting:DateTime",
              "value": "P1W",
              "beginOffset": 0
            },
            "entityName": "DATE_TIME",
            "subType": "RECURRING",
            "recurrenceUntil": {
              "endDate": {
                "endOffset": 6,
                "entityName": "DATE_TIME",
                "timeZone": "-10:00",
                "originalString": "Sept 1",
                "subType": "DATE",
                "bagItem": "Meeting:DateTime",
                "type": "DATE_TIME",
                "value": "2022-09-01",
                "beginOffset": 0
              },
              "entityName": "DATE_TIME",
              "subType": "INTERVAL"
            }
          }

Mehrdeutigkeitsauflösungsregeln für Zeit- und Datumsübereinstimmungen

Benutzer können teilweise Datumsangaben eingeben, bei denen die Zeit impliziert ist. Beispiel:
  • "Besprechung für Montag planen"
  • "Spesenabrechnung für 7/11 erstellen"
  • "Spesenabrechnung für den 11. erstellen"
Einige Situationen, wie die Planung einer Besprechung, implizieren eine zukünftige Zeit. Andere, wie das Erstellen einer Spesenabrechnung, beziehen sich auf eine Zeit in der Vergangenheit. Um sicherzustellen, dass die Subtypen "Zeit" und "Datum" der Entity DATE_TIME mehrdeutige Eingaben als Vergangenheit, Gegenwart oder nächste Näherung auflösen können, können Sie Mehrdeutigkeitsauflösungsregeln anwenden. Um den zeitlichen Kontext für die Zeitauflösung festzulegen, klicken Sie beispielsweise auf die Entity DATE_TIME, und wenden Sie dann eine Regel an.
Hinweis

Die Mehrdeutigkeitsauflösungsregeln validieren die Benutzereingabe nicht. Sie können die Benutzereingabe mit einem benutzerdefinierten Validator validieren, der Apache FreeMarker (wird nicht empfohlen) oder in einem Entity Event Handler (wird empfohlen) verwendet. Dieser Validator gibt false zurück (Validierung nicht erfolgreich), wenn ein vergangenes Datum für einen zukunftsgerichteten Anwendungsfall angegeben wird (z.B. ein Besprechungsplaner). Bei einem rückwärts gerichteten Anwendungsfall wie Spesenabrechnungen gibt der Validator false zurück, wenn der Benutzer ein zukünftiges Datum eingibt.

Beschreibung von time-entity-configuration.png folgt
Beschreibung der Abbildung time-entity-configuration.png

Hinweis

Wenn Sie dieselbe Entity mit zwei oder mehr Elementen innerhalb derselben Mischentity referenzieren oder wenn zwei oder mehr Mischentitys dieselbe Entity referenzieren und auch Führen Sie ein Upgrade auf Release 21.12 aus, um sicherzustellen, dass die Mehrdeutigkeitsauflösungsregeln, die für jede Entityreferenz spezifisch sind, separat behandelt und nicht von den Regeln überschrieben werden, die für eine zuvor aufgelöste Entity festgelegt wurden.

Auflösungsregeln für Abgleiche mit dem Datumssubtyp

Das Datum wird in das UTC-Datum aufgelöst, nicht in das Server- oder Browserdatum. Beispiel: "heute", die am 8. Juli um 8 Uhr aus der Zeitzone Hawaii-Aleutian (UTC-10:00) ausgesprochen wurde, wird am 9. Juli aufgelöst.
Regel Funktionsweise Beispiele
Vergangenheit Löst die mehrdeutige Eingabe als nächsten Wochentag in der Vergangenheit auf.
  • Wenn die Äußerung "Montag" und der aktuelle Tag auch "Montag" enthält, wird "Montag" wie heute aufgelöst.
  • Wenn die Äußerung "Montag" und der aktuelle Tag "Mittwoch" enthält, wird der "Montag" wie der vorherige Montag aufgelöst.
Zukunft Löst die mehrdeutige Eingabe als nächsten Tag in der Zukunft auf
  • Wenn die Äußerung "Montag" und der aktuelle Tag auch "Montag" enthält, wird "Montag" wie heute aufgelöst.
  • Wenn die Äußerung "Montag" und der aktuelle Tag "Dienstag" enthält, wird "Montag" wie folgt aufgelöst.
  • Wenn die Äußerung "Dienstag" und der aktuelle Tag "Montag" enthält, wird "Dienstag" an diesem Dienstag aufgelöst.
Nächste Löst die mehrdeutige Eingabe als nächsten Tag auf.
  • Wenn die Äußerung "Montag" enthält und der aktuelle Tag auch Montag ist, wird der "Montag" wie heute aufgelöst. Wenn die Äußerung "Montag" und der aktuelle Tag "Dienstag" enthält, wird "Montag" wie gestern aufgelöst.
  • Wenn die Äußerung "Montag" und der aktuelle Tag "Sonntag" enthält, wird der "Montag" als morgen aufgelöst.
Default Löst die mehrdeutige Eingabe als zukünftiges Datum auf. Beispiel: Wenn die Eingabe Mittwoch enthält, wird der Tag als nächster Mittwoch und nicht als vorheriger Mittwoch oder aktueller Tag interpretiert (wenn es sich um einen Mittwoch handelt).

Auflösungsregeln für Übereinstimmungen mit dem Zeitsubtyp

Regel Funktionsweise Beispiele
Vergangenheit Löst die Eingabe auf die nächste Zeit in der Vergangenheit relativ zur aktuellen Zeit in der UTC-Zeitzone auf.
  • Wenn die Äußerung "9 Uhr" enthält und die aktuelle Zeit 10:00 Uhr ist, wird die Zeit heute um 9:00 Uhr aufgelöst.
  • Wenn die Äußerung "9 Uhr" enthält und die aktuelle Uhrzeit 10:00 Uhr ist, wird die Uhrzeit gestern auf 9:00 Uhr aufgelöst.
  • Wenn die Äußerung "9" enthält und die aktuelle Zeit 10:00 Uhr ist, wird die Zeit heute um 9:00 Uhr aufgelöst.
Zukunft Löst die Eingabe auf die nächste Zeit in der Zukunft relativ zur aktuellen Zeit in der UTC-Zeitzone auf.
  • Wenn die Äußerung "9 Uhr" enthält und die aktuelle Zeit jetzt 10:00 Uhr ist, wird die Zeit morgen um 9:00 Uhr aufgelöst.
  • Wenn die Äußerung "9 Uhr" enthält und die aktuelle Uhrzeit 10:00 Uhr ist, wird die Zeit heute als 9 Uhr aufgelöst.
  • Wenn die Äußerung "9" enthält und die aktuelle Uhrzeit 10:00 Uhr ist, wird die Zeit heute als 9:00 Uhr aufgelöst.
Nächste Löst die Eingabe als die nächste Zeit relativ zur aktuellen Zeit in der UTC-Zeitzone auf.
  • Wenn die Äußerung "9 Uhr" enthält und die aktuelle Zeit 10:00 Uhr ist, wird die Zeit wie heute um 9:00 Uhr aufgelöst.
  • Wenn die Äußerung "9 Uhr" enthält und die aktuelle Uhrzeit 10:00 Uhr ist, wird die Zeit heute als 9:00 Uhr aufgelöst.
  • Wenn die Äußerung "9" enthält und die aktuelle Zeit 10:00 Uhr ist, wird die Zeit heute um 9:00 Uhr aufgelöst.
  • Wenn die Äußerung "10:00" und die aktuelle Uhrzeit 1:00 Uhr enthält, wird die Uhrzeit gestern als 10:00 Uhr aufgelöst.
Default Löst die Eingabe nach der Methode auf, die in den Releases vor 21.06 von Oracle Digital Assistant verwendet wird.
  • Wenn die Äußerung "9 Uhr" enthält und die aktuelle Uhrzeit 10 Uhr ist, wird die Zeit heute als 9 Uhr aufgelöst.
  • Wenn die Äußerung "9 Uhr" enthält und die aktuelle Uhrzeit 10 Uhr ist, wird die Zeit heute als 9 Uhr aufgelöst.
  • Wenn die Äußerung "9" enthält und die aktuelle Uhrzeit 10 Uhr ist, wird die Zeit heute als 9 Uhr aufgelöst.
  • Wenn die Äußerung "1:00 Uhr" und die aktuelle Uhrzeit "2 Uhr" enthält, wird die Zeit als "1 Uhr morgen" aufgelöst.

Gebietsschemabasierte Entitätsauflösung

Sie können die Entitäten CURRENCY, DATE und NUMBER in das Benutzergebietsschema auflösen, indem Sie Endbenutzergebietsschema berücksichtigen aktivieren.
Beschreibung von currency-entity-customization.png folgt
Beschreibung der Abbildung currency-entity-customization.png

Je nach Entity hat diese Option verschiedene Anwendungen:
  • DATE wird in das gebietsschemaspezifische Format aufgelöst: Es kann z.B. 11/7 als 7. November für en-US oder 11. Juli für en-AU auflösen. Bei nicht unterstützten Gebietsschemas können Sie ein Format und einen zeitlichen Kontext anwenden, wie Vergangenheit oder Zukunft.
  • NUMBER wird in das länderspezifische numerische Format aufgelöst: Komma, Punkt oder Leerzeichen, die zum Trennen von Tausendergruppen verwendet werden, und Dezimalpunkt mit oder ohne dünnes Leerzeichen, das den Bruchteil der Zahl trennt. Beispiel: Sowohl Großbritannien als auch die USA verwenden ein Komma, um Tausendergruppen zu trennen.
    Hinweis

    Wenn Endbenutzergebietsschema berücksichtigen deaktiviert ist, wird die Entity NUMBER als COMMA_DOT (1.000,00) aufgelöst.
  • CURRENCY verwendet ein Gebietsschema, um eine bestimmte $- oder ¥-Währung aufzulösen. Wenn kein Gebietsschema gefunden wird, können Sie festlegen, dass die Eingabe als $- oder ¥-Währung aufgelöst wird, die von der Mehrdeutigkeitsauflösungsregel festgelegt wird.
Hinweis

Wenn Sie dieselbe Entity mit zwei weiteren Elementen innerhalb derselben Mischentity referenzieren oder wenn zwei oder mehr Mischentitys dieselbe Entity referenzieren und auch zugeordnet sind Führen Sie mit demselben Intent ein Upgrade auf Release 21.12 aus, um sicherzustellen, dass die für jede Entityreferenz spezifische Gebietsschemaanpassung separat behandelt und nicht von der Gebietsschemakonfiguration einer zuvor aufgelösten Entity überschrieben wird.

Gebietsschemabasierte Datumsauflösung

Wenn das Gebietsschema des Benutzers nicht erkannt werden kann, wird das Datum als das ausgewählte Standarddatumsformat aufgelöst.
Für dieses Gebietsschema... Diese Eingabe... ... Wird aufgelöst als... Format (Sequenz Datum/Monat)
Vereinigte Staaten (en_US) 11/7 November 7 MONTH_DAY
Großbritannien (en_GB) 11/7 Juli 11 DAY_MONTH
Kanada - Englisch (en_CA) 11/7 November 7 MONTH_DAY
Kanada - Französisch (fr_CA) 11/7 November 7 MONTH_DAY
Australien (en_AU) 11/7 Juli 11 DAY_MONTH
Mexiko (es_MX) 11/7 Juli 11 DAY_MONTH
Singapur (zh_SG) 11/7 Juli 11 DAY_MONTH
USA (ar_AE) 11/7 November 7 MONTH_DAY
Arabisch (ar_AR) 11/7 November 7 MONTH_DAY
Frankreich (fr_FR) 11/7 Juli 11 DAY_MONTH
Niederlande (nl_NL) 11/7 Juli 11 DAY_MONTH
Deutschland (de_DE) 11/7 Juli 11 DAY_MONTH
Italien (it_IT) 11/7 Juli 11 DAY_MONTH
Portugal (pt_PT) 11/7 Juli 11 DAY_MONTH
Spanien (en_ES) 11/7 Juli 11 DAY_MONTH
China (zh_CN) 11/7 November 7 MONTH_DAY
Japan (ja_JP) 11/7 November 7 MONTH_DAY

Gebietsschemabasierte Währungsauflösung

Für dieses Gebietsschema... Diese Eingabe... ... Wird aufgelöst als (Dollar-Mehrdeutigkeit) Diese Eingabe... ... Löst sich auf als (Yen Ambiguity)
Vereinigte Staaten (en_US) 20 Dollar 20.0 USD 20 ¥ 20,0 JPY
Großbritannien (en_GB) 20 Dollar 20.0 USD 20 ¥ 20,0 JPY
Kanada - Englisch (en_CA) 20 Dollar 20.0 CAD 20 ¥ 20,0 JPY
Kanada - Französisch (fr_CA) 20 Dollar 20.0 CAD 20 ¥ 20,0 JPY
Australien (en_AU) 20 Dollar 20.0 AUD 20 ¥ 20,0 JPY
Mexiko (es_MX) 20 Dollar 20,0 MIO. 20 ¥ 20,0 CNY
Singapur (zh_SG) 20 Dollar 20,0 SGD 20 ¥ 20,0 JPY
USA (ar_AE) 20 Dollar 20.0 USD 20 ¥ 20,0 JPY
Arabisch (ar_AR) 20 Dollar 20.0 USD 20 ¥ 20,0 JPY
Frankreich (fr_FR) 20 Dollar 20.0 USD 20 ¥ 20,0 JPY
Niederlande (nl_NL) 20 Dollar 20.0 USD 20 ¥ 20,0 JPY
Deutschland (de_DE) 20 Dollar 20.0 USD 20 ¥ 20,0 JPY
Italien (it_IT) 20 Dollar 20.0 USD 20 ¥ 20,0 JPY
Portugal (pt_PT) 20 Dollar 20.0 USD 20 ¥ 20,0 JPY
Spanien (en_ES) 20 Dollar 20.0 USD 20 ¥ 20,0 JPY
China (zh_CN) 20 Dollar 20.0 USD 20 ¥ 20,0 CNY
Japan (ja_JP) 20 Dollar 20.0 USD 20 ¥ 20,0 JPY

Gebietsschemabasierte Zahlenauflösung

Wenn Endbenutzergebietsschema berücksichtigen deaktiviert ist, wird standardmäßig das Zahlenformat COMMA_DOT (1.000,00) verwendet.
Wenn das Gebietsschema aktiviert ist für... ... Das erkannte Format ist ... Beispiel
Vereinigte Staaten (en_US) COMMA_DOT 1.000.000
Großbritannien (en_GB) COMMA_DOT 1.000.000
Kanada - Englisch (en_CA) COMMA_DOT 1.000.000
Kanada - Französisch (fr_CA) DOT_COMMA 1
Australien (en_AU) COMMA_DOT 1.000.000
Mexiko (es_MX) COMMA_DOT 1.000.000
Singapur (zh_SG) COMMA_DOT 1.000.000
USA (ar_AE) DOT_COMMA 1
Arabisch (ar_AR) DOT_COMMA 1
Frankreich (fr_FR) SPACE_COMMA 1 0 0
Niederlande (nl_NL) DOT_COMMA 1
Deutschland (de_DE) DOT_COMMA 1
Italien (it_IT) DOT_COMMA 1
Portugal (pt_PT) COMMA_DOT 1.000.000
Spanien (en_ES) DOT_COMMA 1
China (zh_CN) COMMA_DOT 1.000.000
Japan (ja_JP) COMMA_DOT 1.000.000