Erkannte Formate

• 20 Cent
• Fünf Dollar
• 10 USD

Attribute

• .literal: Die exakte Wortfolge in der Eingabe, die als Erwähnung einer Währung interpretiert wird.
• .numeric_value: Der kanonische numerische Wert als Zahl des Typs 'Integer' oder 'Double' in Basiseinheiten.
• .location: Listet die Indexelementwerte der ersten und letzten Buchstaben in der Textzeichenfolge für die Wortfolge auf, die als Erwähnung einer Währung interpretiert wird.
• .unit: Grundeinheit einer Währung, die durch einen dreistelligen ISO-Währungscode angegeben wird. Beispiel: USD oder EUR.

In der folgenden Tabelle sind die Informationen aufgelistet, die jedes Attribut aus der Benutzereingabe erfasst.

Für den Input veinte euro ( twenty euro auf Spanisch) oder €1.234,56 gibt @sys-currency diese Werte zurück:

Gleichwertige Ergebnisse werden für andere unterstützte Sprachen und Landeswährungen zurückgegeben.

Tipps zur Verwendung von '@sys-currency'

Falls Sie die Entität @sys-currency als Knotenbedingung verwenden und der Benutzer $0 als Wert angibt, wird der Wert korrekt als Währung erkannt, die Bedingung jedoch für die Zahl 0 und nicht für die Währung 0 ausgewertet. Im Ergebnis wird der Wert null in der Bedingung mit 'false' ausgewertet und der Knoten wird nicht verarbeitet. Wenn Währungswerte unter ordnungsgemäßer Verarbeitung von Nullen geprüft werden sollen, verwenden Sie stattdessen den Ausdruck @sys-currency OR @sys-currency == 0 in der Knotenbedingung.

Weitere Informationen zu Währungen, die je nach Sprache erkannt werden, finden Sie unter Währungsunterstützung.

Erkannte Formate

• Freitag
• heute
• May 8

Attribute

• .alternatives: Speichert alternative Datumswerte, wenn die Eingabe unterschiedlich interpretiert werden kann. Normalerweise wird das zukünftige Datum als Wert für @sys-date zurückgegeben. Bei bestehenden Mehrdeutigkeiten wird das vergangene Datum als alternatives Datum gespeichert. Beispiel: Für die Eingabe in January wird ein zukünftiges Datum zurückgegeben. Wenn jedoch momentan Februar ist (Januar des aktuellen Jahrs ist bereit vorüber), dann wird der vergangene Januar auch als alternatives Datum zurückgegeben. Ein alternatives Datum wird auch für Wochentage bereitgestellt, wenn der Wochentag ohne einen Modifikator angegeben ist. Beispiel: Für die Eingabe Are you open Wednesday? (Haben Sie am Mittwoch geöffnet?) wird das zukünftige Datum gespeichert, ein alternatives Datum (Datum des vorangegangenen Mittwochs) wird jedoch ebenfalls erstellt. Alternative Datumsangaben werden für Wortfolgen erstellt, die Modifikatoren wie next (nächste/r/s), this (diese/r/s) oder last (letze/r/s) enthalten, die in unterschiedlichen Ländereinstellungen verschiedene Bedeutungen haben können. Der Service 'watsonx Assistant' behandelt Datumsangaben mit last und next so, als ob der unmittelbar letzte oder nächste Tag referenziert wird, der entweder in derselben oder in einer vorherigen Woche liegen kann. Für bestimmte Modifikatoren wird ein alternatives Datum unabhängig vom aktuellen Tag der Woche erstellt. Beispiel: Die Eingabe enthält die Angabe this Wednesday (diesen Mittwoch). Wenn es momentan Montag ist, wird das zukünftige Datum gespeichert und es wird kein alternatives Datum erstellt. Wenn es jedoch Mittwoch ist, dann wird angenommen, dass das Datum den Mittwoch der kommenden Woche bezeichnet, das heutige Datum wird jedoch als alternatives Datum gespeichert. Alle alternativen Datumsangaben werden als Objekt gespeichert, das einen Wert und eine Konfidenz für jedes alternative Datum enthält. Die Objekte für alternative Datumsangaben werden in einem JSON-Array gespeichert. Zum Abrufen eines alternativen Werts verwenden Sie die folgende Syntax: @sys-date.alternative.
• .calendar_type: Gibt den Kalendertyp für die verwendete Zeitzone an. GREGORIAN ist der einzige unterstützte Typ.
• .datetime_link: Siehe Erwähnungen von Datum und Uhrzeit.
• .day: Helper-Methode, die den Tag in der Datumsangabe zurückgibt.
• .day_of_week: Gibt den Wochentag in der Datumsangabe als Zeichenfolge in Kleinbuchstaben zurück.
• .festival: Erkennt ländereinstellungsspezifische Feiertagsnamen und kann das Datum des kommenden Feiertags wie Thanksgiving, Christmas und Halloween zurückgeben. Verwenden Sie nur Kleinbuchstaben, wenn Sie einen Feiertag in einer Bedingung angeben müssen, z. B. (@sys-date.festival == 'thanksgiving'). Weitere Informationen zu anerkannten Feiertagen finden Sie unter Festivals.
• .granularity: Erkennt Erwähnungen von Zeitrahmen. Die Optionen sind day (Tag), weekend (Wochenende), week (Woche), fortnight (vierzehn Tage), month (Monat), quarter (Quartal) und year (Jahr).
• .interpretation: Das Objekt, das von Ihrem Assistenten zurückgegeben wird und neue Felder enthält, die die Genauigkeit des System-Entity-Klassifikators erhöhen. Sie können interpretation in dem Ausdruck weglassen, mit dem Sie auf diese Felder Bezug nehmen. Sie können beispielsweise auf den Wert des Feldes festival im Interpretationsobjekt zugreifen, indem Sie die Kurzschreibweise <? @sys-date.festival ?> verwenden.
• .literal: Die exakte Wortfolge in der Eingabe, die als Datum interpretiert wird.
• .location: Listet Indexelementwerte der ersten und letzten Buchstaben in der Textzeichenfolge für die Wortfolge auf, die als Datum interpretiert wird.
• .month: Helper-Methode, die den Monat in der Datumsangabe zurückgibt.
• .range_link: Wenn vorhanden, gibt dieses Attribut an, dass die Eingabe des Benutzers einen Datumsbereich enthält. Der Anfangs- und der Endindexwert der Zeichenfolge, die den Datumsbereich enthält, werden als Teil des Linknamens gespeichert. Es werden zusätzliche Informationen bereitgestellt, wie zum Beispiel die Rolle, die jede Entität @sys-date in der Bereichsbeziehung spielt. Das Anfangsdatum hat zum Beispiel den Rollentyp date_from und das Enddatum den Rollentyp date_to. Zum Prüfen eines Rollenwerts können Sie die Syntax @sys-date.role?.type == 'date_from' verwenden. Wenn die Benutzereingabe einen Bereich impliziert, jedoch nur ein Datum angegeben wird, wird die Eigenschaft range_link nicht zurückgegeben, sondern es wird nur ein Rollentyp zurückgegeben. Zum Beispiel, wenn der Benutzer Have you been open since yesterday fragt. Das gestrige Datum wird als Erwähnung @sys-date erkannt und der Rollentyp date_from wird für die Erwähnung zurückgegeben. Ein Bereichsmodifikator (range_modifier), der das Wort in der Eingabe identifiziert, das die Erkennung als Bereich auslöst, wird ebenfalls zurückgegeben. In diesem Beispiel ist der Modifikator since.
• .relative_{timeframe}: Erkennt und erfasst Erwähnungen von relativen Datumswerten in der Eingabe des Benutzers. Gibt eine Zahl zurück, die die Anzahl der Einheiten zwischen dem aktuellen Datum und dem angegebenen Datum anzeigt. Die Einheiten {time frame} können year, month, week, weekend oder day sein.
• .specific_{timeframe}: Erkennt und erfasst Erwähnungen spezifischer Datumseinheiten in der Eingabe des Benutzers. Die Einheiten {time frame} können year, quarter, month, day oder day_of_week sein.
• .year: Helper-Methode, die das Jahr in der Datumsangabe zurückgibt.

In der folgenden Tabelle sind die Informationen aufgelistet, die jedes Attribut aus der Benutzereingabe erfasst.

Erkannte Formate

• 2pm
• at 4
• 15:30

Attribute

• .alternatives: Erfasst andere Zeiten als die, die als Wert für @sys-time gespeichert sind und die der Benutzer möglicherweise meint, wenn die Zeit nicht eindeutig angegeben ist. Die alternativen Werte werden als Objekt gespeichert, das einen Wert und eine Konfidenz für jede alternative Zeit enthält und in einem JSON-Array gespeichert wird. Zum Abrufen eines alternativen Werts verwenden Sie die folgende Syntax: @sys-time.alternative.
• .calendar_type: Gibt den Kalendertyp für die verwendete Zeitzone an. GREGORIAN ist der einzige unterstützte Typ.
• .granularity: Erkennt Erwähnungen von Zeitrahmen. Optionen sind hour, minute, second und instant.
• .hour: Helper-Methode, die die in der Zeitangabe festgelegte Stunde als numerischen Wert zurückgibt.
• .interpretation: Das Objekt, das von Ihrem Assistenten zurückgegeben wird und neue Felder enthält, die die Genauigkeit des System-Entity-Klassifikators erhöhen. Sie können interpretation in dem Ausdruck weglassen, mit dem Sie auf diese Felder Bezug nehmen. Sie können beispielsweise auf den Wert des Feldes granularity im Interpretationsobjekt zugreifen, indem Sie die Kurzschreibweise <? @sys-time.granularity ?> verwenden.
• .literal: Exakter Ausdruck in der Eingabe, der als Uhrzeit interpretiert wird.
• .location: Listet die Indexelementwerte der ersten und letzten Buchstaben in der Textzeichenfolge für die Wortfolge auf, die als Erwähnung einer Zeitangabe interpretiert wird.
• .minute: Helper-Methode, die den Minutenwert zurückgibt, der in der Zeitangabe angegeben wurde.
• .part_of_day: Erkennt Ausdrücke, die die Tageszeit darstellen, z. B. morning (Morgen), afternoon (Nachmittag), evening (Abend), night (Nacht) oder now (jetzt). Legt außerdem einen Zeitraum für jeden Teil des Tages fest. Die Antwort enthält zwei Werte für @sys-time, nämlich einen für den Beginn und einen für das Ende des Zeitraums. Das Entitätsarray enthält ein Objekt range_link mit den Rollentypen time-from und time-to. Die Zeitbereiche für verschiedene Abschnitte des Tages können abhängig von der Ländereinstellung unterschiedlich sein. Für amerikanisches Englisch lautet der Vormittag 6:00:00 bis 12:00:00. Der Nachmittag ist 12:00:00 bis 18:00:00. Der Abend ist 18:00:00 bis 22:00:00. Die Nacht ist 22:00:00 bis 23:59:59. Die Nacht endet kurz vor Mitternacht, da sie sich andernfalls mit einem neuen Tag überschneiden würde, der durch @sys-date gemessen wird.
• .range_link: Wenn vorhanden, gibt dieses Attribut an, dass die Eingabe des Benutzers einen Zeitbereich enthält. Der Anfangs- und der Endindexwert der Zeichenfolge, die den Zeitbereich enthält, werden als Teil des Linknamens gespeichert. Es werden zusätzliche Informationen bereitgestellt, wie zum Beispiel die Rolle, die jede Entität @sys-time in der Bereichsbeziehung spielt. Die Anfangszeit hat zum Beispiel den Rollentyp time_from und die Endzahl den Rollentyp time_to. Zum Prüfen eines Rollenwerts können Sie die Syntax @sys-time.role?.type == 'time_from' verwenden. Wenn die Benutzereingabe einen Bereich impliziert, jedoch nur eine Zeit angegeben wird, wird die Eigenschaft range_link nicht zurückgegeben, sondern es wird nur ein Rollentyp zurückgegeben. Ein Bereichsmodifikator (range_modifier), der das Wort in der Eingabe identifiziert, das die Erkennung als Bereich auslöst, wird ebenfalls zurückgegeben.
• .relative_{timeframe}: Erkennt relative Erwähnungen von Zeitangaben und gibt eine Zahl zurück, die die Anzahl der Einheiten zwischen dem aktuellen Zeitpunkt und dem angegebenen Zeitpunkt anzeigt. Als Zeitrahmeneinheiten ({timeframe}) können hour (Stunde), minute (Minute) oder second (Sekunde) angegeben werden.
• .second: Helper-Methode, die den Sekundenwert zurückgibt, der in der Zeitangabe angegeben wurde.
• .specific_{timeframe}: Erkennt und erfasst Erwähnungen spezifischer Zeiteinheiten in der Eingabe des Benutzers. Als Zeitrahmeneinheiten ({timeframe}) können hour (Stunde), minute (Minute) oder second (Sekunde) angegeben werden.

In der folgenden Tabelle sind die Informationen aufgelistet, die jedes Attribut aus der Benutzereingabe erfasst.

Erkannte Formate

• now
• two hours from now
• on Monday at 4pm

Attribute

• .datetime_link: Falls vorhanden, bedeutet dies, dass in der Eingabe des Benutzers Datum und Uhrzeit zusammen erwähnt werden, was darauf hindeutet, dass Datum und Uhrzeit miteinander in Zusammenhang stehen. Der Anfangs- und der Endindexwert der Zeichenfolge, die das Datum und die Uhrzeit enthält, werden als Teil des Linknamen gespeichert.

In der folgenden Tabelle sind die Informationen aufgelistet, die jedes Attribut aus der Benutzereingabe erfasst.

Zeitzonen

Angaben eines Datums oder einer Uhrzeit, die sich auf die aktuelle Uhrzeit beziehen, werden für eine ausgewählte Zeitzone aufgelöst. Als Zeitzone gilt standardmäßig GMT (Greenwich Mean Time, mittlere Greenwich-Zeit). REST-API-Clients, die sich in anderen Zeitzonen befinden, erhalten daher den aktuellen Wert in UTC (Coordinated Universal Time, koordinierte Weltzeit), wenn die Eingabe now enthält.

Optional kann der REST-API-Client die lokale Zeitzone als Kontextvariable $timezone hinzufügen. Diese Kontextvariable muss mit jeder Clientanforderung gesendet werden. Als Wert für $timezone kann beispielsweise America/Los_Angeles, EST oder UTC verwendet werden. Eine vollständige Liste der unterstützten Zeitzonen finden Sie im Abschnitt Unterstützte Zeitzonen.

Wenn die Variable $timezone angegeben wird, werden die Werte der relativen @sys-date- und @sys-time-Erwähnungen auf der Grundlage der Zeitzone des Kunden anstelle der koordinierten Weltzeit berechnet.

Informationen zur Verarbeitung von Datums- und Zeitwerten enthalten die Referenzinformationen zu Methoden für Datum und Uhrzeit.

Erkannte Formate

• 21
• einundzwanzig
• 3.13

Attribute

• .literal: Die exakte Wortfolge in der Eingabe, die als numerischer Wert interpretiert wird.
• .location: Listet Indexelementwerte der ersten und letzten Buchstaben in der Textzeichenfolge auf, die als numerischer Wert interpretiert wird.
• .numeric_value: Der kanonische numerische Wert als Zahl des Typs 'Integer' oder 'Double'.
• .range_link: Wenn vorhanden, gibt dieses Attribut an, dass die Eingabe des Benutzers einen Zahlenbereich enthält. Der Positionswert des Texts, der den Bereich angibt, wird an den Linknamen angefügt. Es werden zusätzliche Informationen bereitgestellt, wie zum Beispiel die Rolle, die jede Entität @sys-number in der Bereichsbeziehung spielt. Die Anfangszahl hat zum Beispiel den Rollentyp number_from und die Endzahl den Rollentyp number_to. Zum Prüfen eines Rollenwerts können Sie die Syntax @sys-number.role?.type == 'number_from' verwenden.

In der folgenden Tabelle sind die Informationen aufgelistet, die jedes Attribut aus der Benutzereingabe erfasst.

Tipps zur Verwendung von '@sys-number'

• Falls Sie die Entität '@sys-number' als Knotenbedingung verwenden und der Benutzer 0 als Wert angibt, wird der Wert 0 korrekt als Zahl erkannt. Der Wert 0 wird jedoch als Wert null für die Bedingung interpretiert, was zur Folge hat, dass der Knoten nicht verarbeitet wird. Wenn Zahlenwerte unter ordnungsgemäßer Verarbeitung von Nullen geprüft werden sollen, können Sie in der Knotenbedingung auch den Ausdruck @sys-number == 0 verwenden. Der vollständige Ausdruck lautet @sys-number OR @sys-number == 0.

• Falls Sie die Entität '@sys-number' zum Vergleichen von Zahlenwerten in einer Bedingung verwenden, müssen Sie unbedingt eine separate Überprüfung auf das Vorhandensein einer Zahl aufnehmen. Wenn keine Zahl gefunden wird, wird '@sys-number' mit null ausgewertet. Ihr Vergleich wird möglicherweise auch dann mit 'true' ausgewertet, wenn keine Zahl vorhanden ist.

  Verwenden Sie beispielsweise nicht @sys-number<4 allein, da @sys-number null ergibt, wenn keine Zahl gefunden wird. Da null kleiner als 4 ist, wird die Bedingung in diesem Fall mit 'true' ausgewertet, obwohl keine Zahl vorhanden ist.

  Verwenden Sie stattdessen (@sys-number OR @sys-number == 0) AND @sys-number < 4. Falls keine Zahl vorhanden ist, wird die erste Bedingung mit 'false' ausgewertet. Dies führt dazu, dass die gesamte Bedingung mit 'false' ausgewertet wird.

Weitere Informationen zur Verarbeitung von Zahlenwerten enthalten die Referenzinformationen zu Methoden für Zahlen.

Erkannte Formate

• 15%
• 10 Prozent

Attribute

• .literal: Die exakte Wortfolge in der Eingabe, die als Prozentangabe interpretiert wird.
• .location: Listet Indexelementwerte der ersten und letzten Buchstaben in der Textzeichenfolge auf, die als Erwähnung eines Prozentwertes interpretiert wird.
• .numeric_value: Der kanonische numerische Wert als Zahl des Typs 'Integer' oder 'Double'.
• .range_link: Wenn vorhanden, gibt dieses Attribut an, dass die Eingabe des Benutzers einen Bereich (z. B. from 2 to 3 percent) enthält. Der Positionswert des Texts, der den Bereich angibt, wird an den Linknamen angefügt. Es werden zusätzliche Informationen wie zum Beispiel die Rolle, die jede Entität @sys-percentage in der Bereichsbeziehung spielt, bereitgestellt. Die Anfangszahl hat zum Beispiel den Rollentyp number_from und die Endzahl den Rollentyp number_to. Zum Prüfen eines Rollenwerts können Sie die Syntax @sys-percentage.role?.type == 'number_from' verwenden.

In der folgenden Tabelle sind die Informationen aufgelistet, die jedes Attribut aus der Benutzereingabe erfasst.

Tipps zur Verwendung von '@sys-percentage'

• Wenn Sie die Entität @sys-percentage als Knotenbedingung verwenden und der Benutzer 0% als Wert angibt, wird der Wert ordnungsgemäß als Prozentsatz erkannt, aber die Bedingung wird auf die Zahl 0 und nicht auf den Prozentsatz 0% ausgewertet. Im Ergebnis wird der Wert null in der Bedingung mit 'false' ausgewertet und der Knoten wird nicht verarbeitet. Wenn Prozentsatzwerte unter ordnungsgemäßer Verarbeitung von Nullprozentwerten geprüft werden sollen, verwenden Sie in der Knotenbedingung stattdessen den Ausdruck @sys-percentage OR @sys-percentage == 0.

• Falls Sie einen Wert wie 1-2% eingeben, werden die Werte 1% und 2% als Systementitäten zurückgegeben.