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 aber auch komplexere Werte mit Eigenschaftsgruppen aus der Benutzereingabe extrahieren.

Hinweis

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

Built-In-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 über ihre spezifischen Eigenschaften verfügt, haben alle Entitys die folgenden Eigenschaften:

Eigenschaft	Beschreibung
`beginOffset`	Der Anfangsversatz dieses geschlitzten Entitywerts ab 0.
`endOffset`	Der Endversatz dieses geschlitzten Entitywerts ab 0.
`originalString`	Die ursprüngliche Zeichenfolge, die aus der Abfrage für diesen Entity-Slot oder der 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 auf dieser Version der Plattform erstellt wurden. Stattdessen verwenden sie die Entity DATE_TIME. Vorhandene Skills, die auf 22.08 upgegradet wurden, werden diese Legacy-Systementitäten weiterhin unterstützen, obwohl sich das Verhalten möglicherweise ändert.

Entityname	Extrahierter Inhalt	Beispiele	Eigenschaften (in Wertausdrücken referenziert)	Beispielantwort der NLU-Engine
ADDRESS	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 ¥ nach dem erkannten Gebietsschema des Benutzers unterscheiden.	$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 steht nicht für Skills zur Verfügung, die auf dieser Version der Plattform erstellt wurden. Verwenden Sie für Skills, die mit früheren Versionen erstellt wurden, stattdessen die Entity DATE_TIME. 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 außer Kraft setzen, indem Sie eine Mehrdeutigkeitsauflösungsregel anwenden. Während die DATE-Entity in das Format mehrerer unterstützter Gebietsschemas aufgelöst wird, 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 Zeit, ein Datum und eine Uhrzeit, ein wiederkehrendes Ereignis, ein Intervall oder eine Dauer.	Datum: 1. Januar 2023 Zeit: 10 Uhr Datum und Uhrzeit: 1. Januar 2023 um 10 Uhr Intervall: 1. Januar 2023 ab 10 Uhr für 2 Stunden Dauer: 2 Stunden		Für "Termin ein Treffen für jeden Dienstag von 10:00 Uhr bis 1 Uhr ab 23. Januar 2022 und bis 23. Februar": "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 für den ISO 8601-Austausch wöchentlich/einmal pro Woche, wobei `P` der Desigator für die Dauer und `W` der Designator für die Woche ist.
DURATION	Die Zeitspanne zwischen den beiden Endpunkten eines Zeitintervalls Diese Entität ist in Version 22.08 veraltet und steht nicht für Skills zur Verfügung, die auf dieser Version der Plattform erstellt wurden. Verwenden Sie für Skills, die mit früheren Versionen erstellt wurden, stattdessen die Entity DATE_TIME.	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`
LOCATION	Extrahiert Städte, Bundesländer und Länder aus den Benutzereingaben.	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 locale-spezifisches Format auflösen (Gruppierung von Tausenden nach vollständigen Stopps, Kommas, Leerzeichen usw.).	1st erstes 1 eine
PERSON	Erkennt eine Zeichenfolge als den Namen einer Person. Die PERSON-Entity darf nicht mit Namen übereinstimmen, die auch Standorte sind (z.B. Virginia North). Um die Entität PERSON so zu erweitern, dass sie immer mit den Personen in Ihrer Organisation übereinstimmt, können Sie sie einer Wertelistenentität 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" } ]`
PHONE NUMBER	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 steht nicht für Skills zur Verfügung, die auf dieser Version der Plattform erstellt wurden. Verwenden Sie für Skills, die mit früheren Versionen erstellt wurden, stattdessen die Entity DATE_TIME. 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 Sie nähern sich der nächsten Zeit an. Wenden Sie dazu eine Auflösungsregel für Mehrdeutigkeiten 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 sammeln.

Mit der Entity DATE_TIME wählen Sie einen bestimmten Subtyp aus, um zu definieren, welche Informationen erfasst werden sollen. Die folgende Tabelle zeigt, welcher Subtyp für jedes mögliche Szenario verwendet werden soll, und enthält Links zu Informationen über die Attribute 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, das durch ein Anfangs- und Enddatum oder ein Anfangs- und Enddatum definiert ist.	Intervall	INTERVAL-Subtypattribute
Eine regelmäßig wiederkehrende Periode, die beispielsweise durch den Beginn und das Ende der ersten Periode, das Intervall zwischen den wiederkehrenden Perioden und das Ende der wiederkehrenden Perioden definiert wird.	Wiederholt auftretend	RECURRING-Subtypattribute

Hinweis

Die Entity DATE_TIME ersetzt die Systementitäten DATE, TIME, DURATION und SET, die veraltet sind und in den in Release 22.08 und höher erstellten Skills nicht verfügbar sind. Vorhandene Skills, die auf 22.08 upgegradet wurden, unterstützen diese veralteten Systementitäten, obwohl möglicherweise Verhaltensänderungen auftreten.

Sie können die Untertypen "Datum", "Uhrzeit" und "Dauer" als eigenständige Entitys im Dialogablauf verwenden (wobei Sie jeweils separate Variablen deklarieren). Sie können jedoch nur die Untertypen "Intervall" und "Wiederkehrend" verwenden, indem Sie sie in eine zusammengesetzte Mischentity integrieren.

Hinweis

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

Referenzieren Sie im visuellen Dialogmodus die Subtypen DATE_TIME 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 der 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. Verwenden Sie für eine benutzerfreundliche Ausgabe den Apache FreeMarker .xs integrierten. Beispiel: Der Subtyp "Zeit" 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. Das zweite value ist ein Attribut des DATE_TIME-Objekts, das den Zeitwert enthält.

Attribute für jeden DATE_TIME-Untertyp

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-Untertyp 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, wie "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 Zeitfenster kein bestimmtes Datum darstellt (d.h. es handelt sich um ein bewegliches Datum wie den 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 aufgelösten beweglichen Datum und dem aufgelösten nicht beweglichen Datum zu unterscheiden. Beispiel: Wenn das Slotted-Datum 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, z. B. "first" in "every first Monday", 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 Ordinalangabe enthält, die durch den Namen eines Monats qualifiziert ist, wie z.B. Juli in "jeden ersten Montag im Juli", stellt dies den explizit angegebenen Qualifier ("M" für Monat) dar.
`subType`	Zeichenfolge	`DATE`
`timezone`	Zeichenfolge	Der Zeitzonenversatz. 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. "Jeder Montag", stellt dies den explizit angegebenen Wochentagwert mit dem Format iCalendar dar, z.B. 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 des Jahres 2023", stellt dies den explizit angegebenen Jahreswert dar.

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 für eine bestimmte Zeit:

Attribut	Typ	Erläuterung
`entityName`	Zeichenfolge	`DATE_TIME`
`subType`	Zeichenfolge	`TIME`
`timezone`	Zeichenfolge	Der Zeitzonenversatz. 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 Datumsuntertypattribute beschriebenen Attribute.
`entityName`	Zeichenfolge	`DATE_TIME`
`subType`	Zeichenfolge	`DATETIME`
`time`	TIME	Dieses Objekt enthält die unter TIME-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 eine Tages- oder Zeitdauer, z.B. 1 Woche:

Attribut	Typ	Erläuterung
`entityName`	Zeichenfolge	`DATE_TIME`
`subType`	Zeichenfolge	`DURATION`
`timezone`	Zeichenfolge	Der Zeitzonenversatz. 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.

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-Untertyp 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 Attribute des DURATION-Subtyps beschriebenen Attribute.
`endDate`	DATE	Dieses Objekt enthält die unter Datumsuntertypattribute beschriebenen Attribute. Eingeschlossen für die Prompt-Typen "Nur Datum und Uhrzeit" und "Nur Datum".
`endTime`	TIME	Dieses Objekt enthält die unter TIME-Subtypattribute beschriebenen Attribute. Für Prompt-Typen "Nur Datum und Uhrzeit" eingeschlossen.
`entityName`	Zeichenfolge	`DATE_TIME`
`startDate`	DATE	Dieses Objekt enthält die unter Datumsuntertypattribute beschriebenen Attribute. Eingeschlossen für die Prompt-Typen "Nur Datum und Uhrzeit" und "Nur Datum".
`startTime`	TIME	Dieses Objekt enthält die unter TIME-Subtypattribute beschriebenen Attribute. Für Prompt-Typen "Nur Datum und Uhrzeit" eingeschlossen.
`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
            }
          }

RECURRING-Subtypattribute

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

Attribut	Typ	Erläuterung
`entityName`	Zeichenfolge	`DATE_TIME`
`recurrenceDates`	Datumsarray	Wird eingeschlossen, wenn mehrere wiederkehrende Datumsangaben angegeben sind. Dieses Objekt enthält ein Array von DATE-Objekten mit den unter Datumsuntertypattribute beschriebenen Attributen.
`recurrenceFrequency`	DURATION	Dieses Objekt enthält die unter Attribute des DURATION-Subtyps 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`	INTERVAL	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 Datumsuntertypattribute 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" eingeschlossen.
`startDateTime`	DATETIME	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`. Eingeschlossen für den Prompt-Typ "Datum und Uhrzeit".
`startInterval`	INTERVAL	Dieses Objekt enthält die unter INTERVAL-Subtypattribute beschriebenen Attribute.
`startTime`	TIME	Dieses Objekt enthält die unter TIME-Subtypattribute beschriebenen Attribute. Für Prompt-Typ "Nur Zeit" eingeschlossen.
`subType`	Zeichenfolge	`RECURRING`

Im Folgenden finden Sie ein Beispiel für die NLU-Antwort für den RECURRING-Subtyp 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 Teilzeitdaten eingeben, bei denen die Zeit impliziert ist. Beispiel:

"Treffen für Montag planen"
"Spesenabrechnung für 7/11 erstellen"
"Eine Spesenabrechnung für den 11. erstellen"

Einige Situationen, wie die Planung einer Besprechung, bedeuten eine zukünftige Zeit. Andere, wie die Erstellung 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 als nächste Annä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 Benutzereingabe wird durch die Mehrdeutigkeitsauflösungsregeln nicht validiert. Sie können die Benutzereingabe mit einem benutzerdefinierten Validator validieren, der Apache FreeMarker verwendet (was nicht empfohlen wird) oder in einem Entity Event Handler (was empfohlen wird). Dieser Validator gibt false zurück (Validierung nicht erfolgreich), wenn ein vergangenes Datum für einen zukunftsgerichteten Anwendungsfall (z.B. einen Terminplaner) angegeben wird. Bei einem rückwirkenden Anwendungsfall wie der Spesenabrechnung 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 in derselben Mischentity referenzieren oder wenn zwei oder mehr Mischentitys dieselbe Entity referenzieren und auch Führen Sie ein Upgrade auf Release 21.12 durch, um sicherzustellen, dass die für jede Entityreferenz spezifischen Mehrdeutigkeitsauflösungsregeln separat behandelt und nicht durch die Regeln überschrieben werden, die für eine zuvor aufgelöste Entity festgelegt wurden.

Lösungsregeln für Übereinstimmungen mit dem Datumssubtyp

Das Datum wird in das UTC-Datum aufgelöst, nicht in das Datum des Servers oder des Browsers. Beispiel: "heute", das am 8. Juli um 8 Uhr aus der Hawaii-Aleutian Time Zone (UTC-10:00) gesprochen wird, wird als 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" enthält und der aktuelle Tag auch Montag ist, wird "Montag" als heute aufgelöst. Wenn die Äußerung "Montag" enthält und der aktuelle Tag Mittwoch ist, wird der "Montag" als der vorherige Montag aufgelöst.
Zukunft	Löst die mehrdeutige Eingabe als nächsten Tag in der Zukunft auf	Wenn die Äußerung "Montag" enthält und der aktuelle Tag auch Montag ist, wird "Montag" als heute aufgelöst. Wenn die Äußerung "Montag" enthält und der aktuelle Tag Dienstag ist, wird "Montag" wie folgt aufgelöst: Wenn die Äußerung "Dienstag" enthält und der aktuelle Tag Montag ist, wird "Dienstag" als dieser Dienstag aufgelöst.
Nächste	Löst die mehrdeutige Eingabe als nächsten Tag auf.	Wenn die Äußerung "Montag" und der aktuelle Tag auch Montag umfasst, wird der "Montag" als heute aufgelöst. Wenn die Äußerung "Montag" enthält und der aktuelle Tag Dienstag ist, wird "Montag" als gestern aufgelöst. Wenn die Äußerung "Montag" enthält und der aktuelle Tag Sonntag ist, wird der "Montag" als morgen aufgelöst.
Standardwert	Löst die mehrdeutige Eingabe als zukünftiges Datum auf.	Beispiel: Wenn die Eingabe Mittwoch enthält, wird der Tag als nächster Mittwoch interpretiert, nicht als der vorherige Mittwoch oder der aktuelle Tag (wenn es sich um einen Mittwoch handelt).

Lö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 als 9:00 Uhr aufgelöst. Wenn die Äußerung "9 Uhr" enthält und die aktuelle Zeit 10:00 Uhr ist, wird die Zeit gestern 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 als 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 als 9:00 Uhr aufgelöst. Wenn die Äußerung "9 Uhr" enthält und die aktuelle Zeit 10:00 Uhr ist, wird die Zeit heute als 9 Uhr aufgelöst. Wenn die Äußerung "9" enthält und die aktuelle Zeit 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 als heute 9:00 Uhr aufgelöst. Wenn die Äußerung "9 Uhr" enthält und die aktuelle Zeit 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 als 9:00 Uhr aufgelöst. Wenn die Äußerung "10:00" enthält und die aktuelle Zeit 1:00 Uhr ist, wird die Zeit gestern als 10:00 Uhr aufgelöst.
Standardwert	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" und die aktuelle Zeit 10 Uhr ist, wird die Zeit heute als 9 Uhr aufgelöst. Wenn die Äußerung "9 Uhr" enthält und die aktuelle Zeit 10 Uhr ist, wird die Zeit heute als 9 Uhr aufgelöst. Wenn die Äußerung "9" enthält und die aktuelle Zeit 10 Uhr ist, wird die Zeit heute als 9 Uhr aufgelöst. Wenn die Äußerung "1:00 Uhr" enthält und die aktuelle Zeit 2 Uhr ist, wird die Zeit morgen als 1 Uhr aufgelöst.

Gebietsschemabasierte Entitätsauflösung

Sie können die Entitys CURRENCY, DATE und NUMBER aktivieren, um sie in das Benutzergebietsschema aufzulösen, indem Sie Endbenutzergebietsschema berücksichtigen aktivieren.

Beschreibung von currency-entity-customization.png folgt

Beschreibung der Abbildung currency-entity-customization.png.

Je nach Entity verfügt diese Option über 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, z.B. Vergangenheit oder Zukunft.
NUMBER wird in das länderspezifische numerische Format aufgelöst - das Komma, der Punkt oder das Leerzeichen, das zum Trennen von Tausendergruppen verwendet wird, und das Dezimalzeichen mit oder ohne dünnem Leerzeichen, das den Bruchteil der Zahl trennt. Beispielsweise verwenden das Vereinigte Königreich und die USA ein Komma, um Tausende von Gruppen zu trennen.
Hinweis

Wenn Endbenutzergebietsschema berücksichtigen deaktiviert ist, wird die NUMBER-Entity als COMMA_DOT (1.000,00) aufgelöst.
CURRENCY verwendet das Gebietsschema für die Auflösung in eine bestimmte $- oder ¥-Währung. Wenn kein Gebietsschema erkannt wird, können Sie festlegen, dass die Eingabe als die Währung $ oder ¥ 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 ein Upgrade auf Release 21.12 mit demselben Intent durch, um sicherzustellen, dass die für jede Entityreferenz spezifische Gebietsschemaanpassung separat behandelt und nicht durch die 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...	... Auflösung als...	Format (Datums-Monatsfolge)
USA (`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...	... Auflösung als (Dollar-Mehrdeutigkeit)	Diese Eingabe...	... Auflösung als (Yen Ambiguity)
USA (`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 MXN	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 bekannte Format ist ...	Beispiel
USA (`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

Oracle Cloud Infrastructure - Dokumentation