Sdílet prostřednictvím

Předem připravená entita DatetimeV2 pro aplikaci LUIS

  • Článek

Důležité

Služba LUIS bude vyřazena 1. října 2025 a od 1. dubna 2023 nebudete moct vytvářet nové prostředky LUIS. Doporučujeme migrovat aplikace LUIS do porozumění konverzačnímu jazyku, abyste mohli využívat další podporu produktů a vícejazyčné funkce.

Předem připravená entita datetimeV2 extrahuje hodnoty data a času. Tyto hodnoty se přeloží ve standardizovaném formátu, aby klientské programy spotřebováovaly. Pokud má promluva datum nebo čas, který není dokončený, služba LUIS do odpovědi koncového bodu zahrne jak minulé, tak budoucí hodnoty . Vzhledem k tomu, že tato entita je už vytrénovaná, nemusíte do záměrů aplikace přidávat ukázkové promluvy obsahující datetimeV2.

Typy datetimeV2

DatetimeV2 se spravuje z úložiště GitHub pro rozpoznávání textu .

Příklad JSON

Níže je znázorněna následující promluva a její částečná odpověď JSON.

8am on may 2nd 2019

"entities": {
    "datetimeV2": [
        {
            "type": "datetime",
            "values": [
                {
                    "timex": "2019-05-02T08",
                    "resolution": [
                        {
                            "value": "2019-05-02 08:00:00"
                        }
                    ]
                }
            ]
        }
    ]
}

Podtypy datatimeV2

Předem připravená entita datetimeV2 má následující podtypy a příklady z nich jsou uvedeny v následující tabulce:

  • date
  • time
  • daterange
  • timerange
  • datetimerange

Hodnoty rozlišení

  • Pole má jeden prvek, pokud je datum nebo čas v promluvě plně zadané a jednoznačné.
  • Pole má dva prvky, pokud je hodnota datetimeV2 nejednoznačná. Nejednoznačnost zahrnuje nedostatek konkrétního roku, času nebo časového rozsahu. Příklady najdete v nejednoznačných datech . Pokud je čas nejednoznačný pro A.M. nebo P.M., jsou zahrnuty obě hodnoty.
  • Pole má čtyři prvky, pokud má promluva dva prvky s nejednoznačností. Tato nejednoznačnost zahrnuje prvky, které mají:
    • Datum nebo rozsah kalendářních dat, který je nejednoznačný jako rok
    • Časový nebo časový rozsah, který je nejednoznačný, pokud jde o P.M. nebo P.M. Například 3:00 3. dubna.

Každý prvek pole values může mít následující pole:

Název vlastnosti Popis vlastnosti
Timex čas, datum nebo rozsah kalendářních dat vyjádřený ve formátu TIMEX, který se řídí standardem ISO 8601 a atributy TIMEX3 pro anotace pomocí jazyka TimeML.
mod výraz použitý k popisu použití hodnoty, například before, after.
type Podtyp, který může být jedním z následujících položek: datetime, date, time, daterange, timerange, datetimerange, , duration. set
hodnota Nepovinné. Objekt datetime ve formátu rrrr-MM-dd (datum), HH:mm:ss (čas) rrrr-MM-dd HH:mm:ss (datetime). Pokud type ano duration, hodnota je počet sekund (doba trvání)
Používá se pouze v případě, že type je datetime nebo date, timenebo "duration" (doba trvání).

Platné hodnoty kalendářních dat

DatetimeV2 podporuje data mezi následujícími rozsahy:

Min. Max.
1. ledna 1900 31. prosince 2099

Nejednoznačná data

Pokud může být datum v minulosti nebo budoucnosti, služba LUIS poskytuje obě hodnoty. Příkladem je promluva, která zahrnuje měsíc a datum bez roku.

Například s ohledem na následující promluvu:

May 2nd

  • Pokud je dnešní datum 3. května 2017, služba LUIS jako hodnoty poskytuje hodnoty 2017-05-02 i 2018-05-02.
  • Když je dnešní datum 1. května 2017, služba LUIS poskytuje hodnoty 2016-05-02 a 2017-05-02.

Následující příklad ukazuje rozlišení entity "může 2nd". Toto usnesení předpokládá, že dnešní datum je datum mezi 2. květnem 2017 a 1. květnem 2018. Pole v X timex poli jsou části data, které nejsou explicitně zadané v promluvě.

Příklad rozlišení data

Níže je znázorněna následující promluva a její částečná odpověď JSON.

May 2nd

"entities": {
    "datetimeV2": [
        {
            "type": "date",
            "values": [
                {
                    "timex": "XXXX-05-02",
                    "resolution": [
                        {
                            "value": "2019-05-02"
                        },
                        {
                            "value": "2020-05-02"
                        }
                    ]
                }
            ]
        }
    ]
}

Příklady rozlišení rozsahu kalendářních dat pro číselné datum

Entita datetimeV2 extrahuje rozsahy data a času. end Pole start určují začátek a konec oblasti. Pro promluvu May 2nd to May 5thposkytuje služba LUIS hodnoty daterange pro aktuální i příští rok. timex Hodnoty v poli XXXX označují nejednoznačnost roku. P3D označuje, že časové období je dlouhé tři dny.

Níže je znázorněna následující promluva a její částečná odpověď JSON.

May 2nd to May 5th


"entities": {
    "datetimeV2": [
        {
            "type": "daterange",
            "values": [
                {
                    "timex": "(XXXX-05-02,XXXX-05-05,P3D)",
                    "resolution": [
                        {
                            "start": "2019-05-02",
                            "end": "2019-05-05"
                        },
                        {
                            "start": "2020-05-02",
                            "end": "2020-05-05"
                        }
                    ]
                }
            ]
        }
    ]
}

Příklady rozlišení rozsahu dat pro den v týdnu

Následující příklad ukazuje, jak luis používá datetimeV2 k vyřešení promluvy Tuesday to Thursday. V tomto příkladu je aktuální datum 19. června. Služba LUIS obsahuje hodnoty rozsahu dat pro oba rozsahy kalendářních dat, které předchází aktuálnímu datu, a sleduje je.

Níže je znázorněna následující promluva a její částečná odpověď JSON.

Tuesday to Thursday

"entities": {
    "datetimeV2": [
        {
            "type": "daterange",
            "values": [
                {
                    "timex": "(XXXX-WXX-2,XXXX-WXX-4,P2D)",
                    "resolution": [
                        {
                            "start": "2019-10-08",
                            "end": "2019-10-10"
                        },
                        {
                            "start": "2019-10-15",
                            "end": "2019-10-17"
                        }
                    ]
                }
            ]
        }
    ]
}

Nejednoznačný čas

Pole hodnot má dva časové prvky, pokud je čas nebo časový rozsah nejednoznačný. Pokud existuje nejednoznačný čas, hodnoty mají časy A.M. i P.M. ..

Příklad rozlišení časového rozsahu

Odpověď JSON datetimeV2 se v rozhraní API V3 změnila. Následující příklad ukazuje, jak služba LUIS používá datetimeV2 k vyřešení promluvy s časovým rozsahem.

Změny z rozhraní API V2:

  • datetimeV2.timex.type vlastnost již není vrácena, protože je vrácena na nadřazené úrovni, datetimev2.type.
  • Vlastnost datetimeV2.value byla přejmenována na datetimeV2.timex.

Níže je znázorněna následující promluva a její částečná odpověď JSON.

from 6pm to 7pm

Následující JSON je s parametrem nastaveným verbose na false:


"entities": {
    "datetimeV2": [
        {
            "type": "timerange",
            "values": [
                {
                    "timex": "(T18,T19,PT1H)",
                    "resolution": [
                        {
                            "start": "18:00:00",
                            "end": "19:00:00"
                        }
                    ]
                }
            ]
        }
    ]
}

Příklad rozlišení času

Níže je znázorněna následující promluva a její částečná odpověď JSON.

8am

"entities": {
    "datetimeV2": [
        {
            "type": "time",
            "values": [
                {
                    "timex": "T08",
                    "resolution": [
                        {
                            "value": "08:00:00"
                        }
                    ]
                }
            ]
        }
    ]
}

Zastaralé předem připravené datum a čas

Předem připravená entita datetime je zastaralá a nahrazena datetimeV2.

Pokud chcete nahradit datetime datetimeV2 v aplikaci LUIS, proveďte následující kroky:

  1. Otevřete podokno Entity webového rozhraní LUIS.
  2. Odstraňte předem připravenou entitu data a času .
  3. Výběr možnosti Přidat předem připravenou entitu
  4. Vyberte datetimeV2 a klikněte na Uložit.

Další kroky

Přečtěte si o dimenzi, e-mailových entitách a číslech.