Dela via


Matcha entiteter med standardformat

En lösning är ett standardformat för en entitet. Entiteter kan uttryckas i olika former och lösningar ger förutsägbara standardformat för vanliga kvantifierbara typer. Till exempel bör "åttio" och "80" båda matcha till heltal 80.

Du kan använda NER-lösningar för att implementera åtgärder eller hämta ytterligare information. Din tjänst kan till exempel extrahera datetime-entiteter för att extrahera datum och tider som kommer att tillhandahållas till ett schemaläggningssystem för möten.

Viktigt!

Från och med version 2023-04-15-preview ersätts entitetsmatchningsfunktionen med entitetsmetadata

Kommentar

Entitetsmatchningssvar stöds endast från api-version=2022-10-01-preview och "modelVersion": "2022-10-01-preview".

Den här artikeln dokumenterar de lösningsobjekt som returneras för varje entitetskategori eller underkategori.

Ålder

Exempel: "10 år gammal", "23 månader gammal", "sextio Y.O."

"resolutions": [
                    {
                        "resolutionKind": "AgeResolution",
                        "unit": "Year",
                        "value": 10
                    }
                ]

Möjliga värden för "enhet":

  • Year
  • Månad
  • Vecka
  • Dag

Valuta

Exempel: "30 egyptiska pund", "77 USD"

"resolutions": [
                    {
                        "resolutionKind": "CurrencyResolution",
                        "unit": "Egyptian pound",
                        "ISO4217": "EGP",
                        "value": 30
                    }
                ]

Möjliga värden för "enhet" och "ISO4217":

Datetime

Datetime innehåller flera olika undertyper som returnerar olika svarsobjekt.

Datum

Specifika dagar.

Exempel: "1 januari 1995", "12 april", "7 oktober 2022", "tomorrow"

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Date",
                        "timex": "1995-01-01",
                        "value": "1995-01-01"
                    }
                ]

När ett tvetydigt datum anges erbjuds du olika alternativ för din lösning. Till exempel kan "12 april" referera till valfritt år. Lösning ger i år och nästa som alternativ. Värdet timexXXXX anger att inget år angavs i frågan.

"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"
                    }
                ]

Tvetydighet kan uppstå även för en viss dag i veckan. Att till exempel säga "måndag" kan referera till förra måndagen eller den här måndagen. timex Återigen anger värdet att inget år eller månad har angetts och använder en dag i veckans ID (W) för att ange den första dagen i veckan.

"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"
                    }
                ]

Tid

Specifika tider.

Exempel: "9:39:33 AM", "seven AM", "20:03"

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Time",
                        "timex": "T09:39:33",
                        "value": "09:39:33"
                    }
                ]

Datetime

Specifika kombinationer av datum och tid.

Exempel: "18:00 i morgon", "20:00 den 3 januari", "1 november 19:30"

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "DateTime",
                        "timex": "2022-10-07T18",
                        "value": "2022-10-07 18:00:00"
                    }
                ]

På samma sätt som med datum kan du ha tvetydiga datetime-entiteter. Till exempel kan "3 maj 12:e dagen" referera till valfritt år. Lösning ger i år och nästa som alternativ. Värdet timexXXXX anger att inget år har angetts.

"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-intervall

Ett datetime-intervall är en period med start- och slutdatum, tid eller datetime.

Exempel: "från 3 januari 06:00 till 25 april 2022", "mellan måndag till torsdag", "Juni", "helgen"

Parametern "duration" anger den tid som passerat i sekunder (S), minuter (M), timmar (H) eller dagar (D). Den här parametern returneras endast när en explicit start- och slutdatumtid finns i frågan. "Nästa vecka" skulle bara returneras med parametrarna "begin" och "end" för veckan.

"resolutions": [
                    {
                        "resolutionKind": "TemporalSpanResolution",
                        "duration": "PT2702H",
                        "begin": "2022-01-03 06:00:00",
                        "end": "2022-04-25 20:00:00"
                    }
                ]

Ställ in

En uppsättning är en återkommande datetime-period. Uppsättningar matchar inte exakta värden eftersom de inte anger någon exakt datetime.

Exempel: "varje måndag kl. 18:00", "varje torsdag", "varje helg"

För "varje måndag kl. 18:00" timex anger värdet inget angivet år med början XXXX, sedan varje måndag till WXX-1 för att bestämma den första dagen i varje vecka och slutligen T18 för att indikera 18:00.

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Set",
                        "timex": "XXXX-WXX-1T18",
                        "value": "not resolved"
                    }
                ]

Dimensioner

Exempel: "24 km/tim", "44 kvadratmeter", "sextio sex kilobyte"

"resolutions": [
                    {
                        "resolutionKind": "SpeedResolution",
                        "unit": "KilometersPerHour",
                        "value": 24
                    }
                ]

Möjliga värden för "resolutionKind" och deras enhetsvärden:

  • AreaResolution:

    • SquareKilometer
    • Kvadrathectometer
    • SquareDecameter
    • Kvadratmeter
    • SquareDecimeter
    • SquareCentimeter
    • Kvadratmillimeter
    • SquareInch
    • SquareFoot
    • SquareMile
    • SquareYard
    • Tunnland
  • InformationResolution:

    • Bitars
    • Kilobit
    • Megabit
    • Gigabit
    • Terabit
    • Petabit
    • Byte
    • Kilobyte
    • Megabyte
    • Gigabyte
    • Terabyte
    • Petabyte
  • LengthResolution:

    • Kilometer
    • Hectometer
    • Decameter
    • Meter
    • Decimeter
    • Centimeter
    • Millimeter
    • Micrometer
    • Nanometer
    • Picometer
    • Mil
    • Gården
    • Tums
    • Foten
    • Ljust år
    • Pt
  • SpeedResolution:

    • MeterPerSecond
    • KilometerPerHour
    • KilometerPerMinute
    • KilometerPerSecond
    • MilesPerHour
    • Knut
    • FootPerSecond
    • FootPerMinute
    • YardsPerMinute
    • YardsPerSecond
    • MeterPerMillisecond
    • CentimetersPerMillisecond
    • KilometerPerMillisecond
  • VolumeResolution:

    • Kubikmeter
    • CubicCentimeter
    • CubicMillimiter
    • Hectoliter
    • Avkalkare
    • Liter
    • Deciliter
    • Centiliter
    • Milliliter
    • Kubikvarv
    • CubicInch
    • Kubikfot
    • CubicMile
    • FluidOunce
    • Tesked
    • Matsked
    • Pint
    • Liter
    • Kopp
    • Gill
    • Nypa
    • FluidDram
    • Fat
    • Minim
    • Sladd
    • Peck
    • Skäppa
    • Hogshead
  • WeightResolution:

    • Kilogram
    • Gram
    • Milligram
    • Mikrogram
    • Gallon
    • MetricTon
    • Ton
    • Pund
    • Uns
    • Tidsintervall
    • Pennyweight
    • LongTonBritish
    • ShortTonUS
    • ShortHundredweightUS
    • Sten
    • Dram

Antal

Exempel: "27", "13", "38,5", "2/3", "33%"

"resolutions": [
                    {
                        "resolutionKind": "NumberResolution",
                        "numberKind": "Integer",
                        "value": 27
                    }
                ]

Möjliga värden för "numberKind":

  • Integer
  • Decimal
  • Fraction
  • Power
  • Procent

Ordning

Exempel: "3rd", "first", "last"

"resolutions": [
                    {
                        "resolutionKind": "OrdinalResolution",
                        "offset": "3",
                        "relativeTo": "Start",
                        "value": "3"
                    }
                ]

Möjliga värden för "relativeTo":

  • Början
  • Sluta

Temperatur

Exempel: "88 grader fahrenheit", "tjugotre grader celsius"

"resolutions": [
                    {
                        "resolutionKind": "TemperatureResolution",
                        "unit": "Fahrenheit",
                        "value": 88
                    }
                ]

Möjliga värden för "enhet":

  • Celsius
  • Fahrenheit
  • Kelvin
  • Rankine