Entitätsmetadaten

Artikel
09/04/2024

Das Entitätsmetadaten-Objekt erfasst optionale zusätzliche Informationen zu erkannten Entitäten und bietet Auflösungen speziell für numerische und temporale Entitäten. Dieses Attribut wird nur aufgefüllt, wenn zusätzliche Daten verfügbar sind, um die Vollständigkeit der erkannten Entitäten zu verbessern. Die Metadatenkomponente umfasst Auflösungen, die sowohl für numerische als auch für temporale Entitäten konzipiert sind. Es ist wichtig, Fälle zu behandeln, in denen das Metadaten-Attribut leer oder nicht vorhanden ist, da es nicht für jede Entität garantiert ist.

Derzeit verarbeiten Metadatenkomponenten Auflösungen in einem Standardformat für eine Entität. Entitäten können in verschiedenen Formen und Auflösungen ausgedrückt werden, um vorhersehbare Standardformate für allgemeine quantifizierbare Typen zur Verfügung zu stellen. Beispielsweise sollten „achtzig“ und „80“ beide zu der ganzen Zahl 80 aufgelöst werden.

Sie können NER-Auflösungen verwenden, um Aktionen zu implementieren oder weitere Informationen abzurufen. Ihr Dienst kann beispielsweise datetime-Entitäten extrahieren, um Datums- und Uhrzeitangaben zu bestimmen, die einem System zur Besprechungsplanung übergeben werden.

Hinweis

Entitätsmetadaten werden nur ab api-version=2023-04-15-preview unterstützt. Für ältere API-Versionen können Sie den Artikel „Entitätsauflösungen“ lesen.

In diesem Artikel sind die zurückgegebenen Auflösungsobjekte für jede Entitätskategorie oder -unterkategorie des Metadaten-Objekts dokumentiert.

Numerische Entitäten

Age

Beispiele: „10 Jahre alt“, „23 Monate alt“, „sechzig Jahre“.

"metadata": {
                "unit": "Year",
                "value": 10
            }

Mögliche Werte für „unit“:

Jahr
Month (Monat)
Woche
Tag

Währung

Beispiele: „30 ägyptische Pfund“, „77 USD“

"metadata": {
                "unit": "Egyptian pound",
                "ISO4217": "EGP",
                "value": 30
            }

Mögliche Werte für „unit“ und „ISO4217“:

ISO 4217-Referenz.

Datetime/Temporale Entitäten

Datetime beinhaltet mehrere verschiedene Untertypen, die unterschiedliche Antwortobjekte zurückgeben.

Date

Bestimmte Tage.

Beispiele: „1. Januar 1995“, „12. April“, „7. Oktober 2022“, „morgen“

"metadata": {
                "dateValues": [
                    {
                        "timex": "1995-01-01",
                        "value": "1995-01-01"
                    }
                ]
            }

Wenn ein mehrdeutiges Datum angegeben wird, werden Ihnen verschiedene Optionen für die Auflösung angeboten. Beispielsweise könnte „12. April“ auf ein beliebiges Jahr verweisen. Die Auflösung bietet dieses und das nächste Jahr als Optionen an. Der timex-Wert XXXX gibt an, dass in der Abfrage kein Jahr angegeben wurde.

"metadata": {
                "dateValues": [
                    {
                        "timex": "XXXX-04-12",
                        "value": "2022-04-12"
                    },
                    {
                        "timex": "XXXX-04-12",
                        "value": "2023-04-12"
                    }
                ]
            }

Mehrdeutigkeit kann sogar für einen bestimmten Wochentag auftreten. Beispielsweise könnte „Montag“ auf den letzten Montag oder diesen Montag verweisen. Wiederum zeigt der timex-Wert an, dass kein Jahr oder Monat angegeben wurde. Es wird ein Tag des Wochenbezeichners (W) verwendet, um den ersten Tag der Woche anzugeben.

"metadata" :{
                "dateValues": [
                    {
                        "timex": "XXXX-WXX-1",
                        "value": "2022-10-03"
                    },
                    {
                        "timex": "XXXX-WXX-1",
                        "value": "2022-10-10"
                    }
                ]
            }

Time

Bestimmte Uhrzeiten.

Beispiele: „9:39:33“, „sieben Uhr“, „20:03“

"metadata": {
                "timex": "T09:39:33",
                "value": "09:39:33"
            }

Datetime

Bestimmte Datums- und Uhrzeitkombinationen.

Beispiele: „18 Uhr morgen“, „20 Uhr am 3. Januar“, „1. November 19:30 Uhr“

"metadata": {
                "timex": "2022-10-07T18",
                "value": "2022-10-07 18:00:00"
            }

Ähnlich wie bei Datumsangaben können mehrdeutige datetime-Entitäten auftreten. Beispielsweise kann sich „3. Mai mittags“ auf jedes Jahr beziehen. Die Auflösung bietet dieses und das nächste Jahr als Optionen an. Der timex-Wert XXXX zeigt an, dass kein Jahr angegeben wurde.

"metadata": {
                 "dateValues": [ 
                       {
                           "timex": "XXXX-05-03T12",
                           "value": "2022-05-03 12:00:00"
                       },
                       {
                           "timex": "XXXX-05-03T12",
                           "value": "2023-05-03 12:00:00"
                       }
                  ]
              }

datetime-Bereiche

Ein datetime-Bereich ist ein Zeitraum mit einem Anfangs- und Enddatum, einer Uhrzeit oder einem datetime-Wert.

Beispiele: „vom 3. Januar 6 Uhr bis zum „25. April 2022 20 Uhr", „zwischen Montag und Donnerstag“, „Juni“, „ am Wochenende“

Der Parameter „Dauer“ gibt die verstrichene Zeit in Sekunden (S), Minuten (M), Stunden (H) oder Tagen (D) an. Dieser Parameter wird nur zurückgegeben, wenn die Abfrage einen expliziten datetime-Wert für Anfang und Ende enthält. „Nächste Woche“ würde nur mit den Parametern „begin“ und „end“ für die Woche zurückgegeben.

"metadata": {
                "duration": "PT2702H",
                "begin": "2022-01-03 06:00:00",
                "end": "2022-04-25 20:00:00"
            }

Set

Ein Set ist ein wiederkehrender datetime-Zeitraum. Sets werden nicht zu genauen Werten aufgelöst, da sie keine genaue datetime angeben.

Beispiele: „jeden Montag um 6 Uhr“, „jeden Donnerstag“, „jedes Wochenende“

Für „jeden Montag um 6 Uhr“ zeigt der timex-Wert mit dem einleitenden XXXX keine Jahresangabe an, dann jeden Montag in Form von WXX-1, um den ersten Tag jeder Woche zu bestimmen, und schließlich T18, um 18 Uhr anzugeben.

"metadata": {
                "timex": "XXXX-WXX-1T18",
                "value": "not resolved"
            }

Dimensionen

Beispiele: „24 km/h“, „44 Quadratmeter“, „Sechsundsechzig Kilobytes“

"metadata": {
                "unit": "KilometersPerHour",
                "value": 24
            }

Mögliche Werte für die Feldwerte „unit“:

Für Messungen:
- SquareKilometer
- SquareHectometer
- SquareDecameter
- SquareMeter
- SquareDecimeter
- SquareCentimeter
- SquareMillimeter
- SquareInch
- SquareFoot
- SquareMile
- SquareYard
- Acre
Für Informationen:
- bit
- Kilobit
- Megabit
- Gbit
- Terabit
- Petabit
- Byte
- Kilobyte
- Megabyte
- Gigabyte
- Terabyte
- Petabyte
Für Länge, Breite, Höhe:
- Kilometer
- Hektometer
- Dekameter
- Zähler
- Dezimeter
- Zentimeter
- Millimeter
- Mikrometer
- Nanometer
- Picometer
- Meile
- Yard
- Zoll
- Fuß
- Lichtjahr
- Pt
Für Geschwindigkeit:
- MetersPerSecond
- KilometersPerHour
- KilometersPerMinute
- KilometersPerSecond
- MilesPerHour
- Knoten
- FootPerSecond
- FootPerMinute
- YardsPerMinute
- YardsPerSecond
- MetersPerMillisecond
- CentimetersPerMillisecond
- KilometersPerMillisecond
Für Volumen:
- CubicMeter
- CubicCentimeter
- CubicMillimiter
- Hektoliter
- Dekaliter
- Liter
- Deziliter
- Zentiliter
- Milliliter
- CubicYard
- CubicInch
- CubicFoot
- CubicMile
- FluidOunce
- Teelöffel
- Esslöffel
- Pint
- Quart
- Tasse
- Gill
- Zusammendrücken
- FluidDram
- Barrel
- Minim
- Cord
- Viertelscheffel
- Scheffel
- Tonne
Für Gewicht:
- Kilogram
- Gram
- Milligram
- Microgram
- Gallon
- MetricTon
- Tonne
- Pfund
- Unze
- Gran
- Centgewicht
- LongTonBritish
- ShortTonUS
- ShortHundredweightUS
- Stone
- Dram

Ordinal

Beispiele: „3.“, „erster“, „letzter“

"metadata": {
                "offset": "3",
                "relativeTo": "Start",
                "value": "3"
            }

Mögliche Werte für „relativeTo“:

Start
Ende

Temperatur

Beispiele: „88 Grad Fahrenheit“, „dreiundzwanzig Grad Celsius“

"metadata": {
                "unit": "Fahrenheit",
                "value": 88
            }