Auflösen von Entitäten in Standardformate
Eine Auflösung ist ein 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.
Wichtig
Ab Version 2023-04-15-Preview wird das Feature für die Entitätsauflösung durch Entitätsmetadaten ersetzt.
Hinweis
Entitätsauflösungsantworten werden nur ab api-version=2022-10-01-preview und "modelVersion": "2022-10-01-preview" unterstützt.
In diesem Artikel sind die zurückgegebenen Auflösungsobjekte für jede Entitätskategorie oder -unterkategorie dokumentiert.
Age
Beispiele: „10 Jahre alt“, „23 Monate alt“, „sechzig Jahre“.
"resolutions": [
{
"resolutionKind": "AgeResolution",
"unit": "Year",
"value": 10
}
]
Mögliche Werte für „unit“:
- Jahr
- Month (Monat)
- Woche
- Tag
Währung
Beispiele: „30 ägyptische Pfund“, „77 USD“
"resolutions": [
{
"resolutionKind": "CurrencyResolution",
"unit": "Egyptian pound",
"ISO4217": "EGP",
"value": 30
}
]
Mögliche Werte für „unit“ und „ISO4217“:
Datetime
Datetime beinhaltet mehrere verschiedene Untertypen, die unterschiedliche Antwortobjekte zurückgeben.
Date
Bestimmte Tage.
Beispiele: „1. Januar 1995“, „12. April“, „7. Oktober 2022“, „morgen“
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Date",
"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.
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Date",
"timex": "XXXX-04-12",
"value": "2022-04-12"
},
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Date",
"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.
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Date",
"timex": "XXXX-WXX-1",
"value": "2022-10-03"
},
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Date",
"timex": "XXXX-WXX-1",
"value": "2022-10-10"
}
]
Time
Bestimmte Uhrzeiten.
Beispiele: „9:39:33“, „sieben Uhr“, „20:03“
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Time",
"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“
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "DateTime",
"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.
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "DateTime",
"timex": "XXXX-05-03T12",
"value": "2022-05-03 12:00:00"
},
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "DateTime",
"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.
"resolutions": [
{
"resolutionKind": "TemporalSpanResolution",
"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.
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Set",
"timex": "XXXX-WXX-1T18",
"value": "not resolved"
}
]
Dimensionen
Beispiele: „24 km/h“, „44 Quadratmeter“, „Sechsundsechzig Kilobytes“
"resolutions": [
{
"resolutionKind": "SpeedResolution",
"unit": "KilometersPerHour",
"value": 24
}
]
Mögliche Werte für „resolutionKind“ seine „unit“-Werte:
AreaResolution:
- SquareKilometer
- SquareHectometer
- SquareDecameter
- SquareMeter
- SquareDecimeter
- SquareCentimeter
- SquareMillimeter
- SquareInch
- SquareFoot
- SquareMile
- SquareYard
- Acre
InformationResolution:
- bit
- Kilobit
- Megabit
- Gbit
- Terabit
- Petabit
- Byte
- Kilobyte
- Megabyte
- Gigabyte
- Terabyte
- Petabyte
LengthResolution:
- Kilometer
- Hektometer
- Dekameter
- Zähler
- Dezimeter
- Zentimeter
- Millimeter
- Mikrometer
- Nanometer
- Picometer
- Meile
- Yard
- Zoll
- Fuß
- Lichtjahr
- Pt
SpeedResolution:
- MetersPerSecond
- KilometersPerHour
- KilometersPerMinute
- KilometersPerSecond
- MilesPerHour
- Knoten
- FootPerSecond
- FootPerMinute
- YardsPerMinute
- YardsPerSecond
- MetersPerMillisecond
- CentimetersPerMillisecond
- KilometersPerMillisecond
VolumeResolution:
- 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
WeightResolution:
- Kilogram
- Gram
- Milligram
- Microgram
- Gallon
- MetricTon
- Tonne
- Pfund
- Unze
- Gran
- Centgewicht
- LongTonBritish
- ShortTonUS
- ShortHundredweightUS
- Stone
- Dram
Zahl
Beispiele: „27“, „Einhundertdrei“, „38,5“, „2/3“, „33 %“
"resolutions": [
{
"resolutionKind": "NumberResolution",
"numberKind": "Integer",
"value": 27
}
]
Mögliche Werte für „numberKind“:
- Integer
- Decimal
- Fraction
- Power
- Percent
Ordinal
Beispiele: „3.“, „erster“, „letzter“
"resolutions": [
{
"resolutionKind": "OrdinalResolution",
"offset": "3",
"relativeTo": "Start",
"value": "3"
}
]
Mögliche Werte für „relativeTo“:
- Start
- Ende
Temperatur
Beispiele: „88 Grad Fahrenheit“, „dreiundzwanzig Grad Celsius“
"resolutions": [
{
"resolutionKind": "TemperatureResolution",
"unit": "Fahrenheit",
"value": 88
}
]
Mögliche Werte für „unit“:
- Celsius
- Fahrenheit
- Kelvin
- Rankine