DatetimeV2 előre összeállított entitás egy LUIS-alkalmazáshoz

  • Cikk

Fontos

A LUIS 2025. október 1-jén megszűnik, és 2023. április 1-től nem hozhat létre új LUIS-erőforrásokat. Javasoljuk, hogy a LUIS-alkalmazásokat a beszélgetési nyelv megértésére migrálja, hogy kihasználhassa a terméktámogatás és a többnyelvű képességek előnyeit.

A datetimeV2 előre összeállított entitás kinyeri a dátum- és időértékeket. Ezek az értékek szabványosított formátumban oldódnak fel az ügyfélprogramok számára. Ha egy kimondott szövegnek nincs befejezett dátuma vagy ideje, a LUIS a végpont válaszában a múltbeli és a jövőbeli értékeket is tartalmazza. Mivel ez az entitás már be van tanítva, nem kell hozzáadnia a datetimeV2-t tartalmazó példa kimondott szövegeket az alkalmazás szándékaihoz.

A datetimeV2 típusai

A DatetimeV2 kezelése a Recognizers-text GitHub-adattárból történik.

Például szolgáló JSON

Az alábbi kimondott szöveg és annak részleges JSON-válasza alább látható.

8am on may 2nd 2019

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

A datetimeV2 altípusai

Az előre összeállított datetimeV2 entitás az alábbi altípusokkal rendelkezik, és mindegyikre példákat a következő táblázat tartalmaz:

  • date
  • time
  • daterange
  • timerange
  • datetimerange

A felbontás értékei

  • A tömbnek egyetlen eleme van, ha a kimondott szövegben szereplő dátum vagy idő teljes mértékben meg van adva, és egyértelmű.
  • A tömbnek két eleme van, ha a datetimeV2 érték nem egyértelmű. A kétértelműség magában foglalja az adott év, idő vagy időtartomány hiányát. Példákért lásd a nem egyértelmű dátumokat . Ha az idő nem egyértelmű az A.M. vagy a P.M. esetében, a rendszer mindkét értéket tartalmazza.
  • A tömb négy elemből áll, ha a kimondott szöveg kétértelmű elemmel rendelkezik. Ez a kétértelműség az alábbi elemeket tartalmazza:
    • Egy dátum- vagy dátumtartomány, amely nem egyértelmű az évhez hasonlóan
    • Olyan idő- vagy időtartomány, amely nem egyértelmű az A.M. vagy a P.M. között. Például április 3., 3:00.

A tömb minden eleme a values következő mezőkkel rendelkezhet:

Tulajdonság neve Tulajdonság leírása
Timex TIMEX formátumban kifejezett idő-, dátum- vagy dátumtartomány, amely az ISO 8601 szabványt és a TIMEX3 attribútumokat követi a TimeML nyelv használatával.
Mod kifejezés, amely leírja, hogyan kell használni az értéket, például before: . after
típus Az altípus, amely a következő elemek egyike lehet: datetime, , date, time, daterange, timerange, datetimerange, durationset.
Érték Opcionális. Egy datetime objektum a Formátum yyyyy-MM-dd (dátum), HH:mm:ss (time) yyyyy-MM-dd HH:mm:ss (datetime) formátumban. Ha type igen duration, az érték a másodpercek száma (időtartam)
Csak akkor használatos, ha type az datetime vagy date, timevagy az "időtartam".

Érvényes dátumértékek

A datetimeV2 a következő tartományok közötti dátumokat támogatja:

Min Max
1900. január 1. 2099. december 31.

Nem egyértelmű dátumok

Ha a dátum a múltban vagy a jövőben is lehet, a LUIS mindkét értéket megadja. Ilyen például egy kimondott szöveg, amely az év nélküli hónapot és dátumot tartalmazza.

Például a következő kimondott szöveg alapján:

May 2nd

  • Ha a mai dátum 2017. május 3., a LUIS a "2017-05-02" és a "2018-05-02" értéket is megadja értékként.
  • Ha a mai dátum 2017. május 1., a LUIS a "2016-05-02" és a "2017-05-02" értéket is megadja értékként.

Az alábbi példa a "május 2." entitás felbontását mutatja be. Ez az állásfoglalás feltételezi, hogy a mai dátum 2017. május 2. és 2018. május 1. közötti dátum. X A mezőben lévő timex mezők a dátum azon részei, amelyek nincsenek explicit módon megadva a kimondott szövegben.

Példa dátumfeloldási példára

Az alábbi kimondott szöveg és annak részleges JSON-válasza alább látható.

May 2nd

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

Dátumtartományfeloldási példák numerikus dátumhoz

Az datetimeV2 entitás kinyeri a dátum- és időtartományokat. A start mezők a end tartomány elejét és végét határozzák meg. A kimondott May 2nd to May 5thszöveghez a LUIS dátumelrendezési értékeket biztosít az aktuális évre és a következő évre vonatkozóan is. timex A mezőben az XXXX értékek az év kétértelműségét jelzik. P3D azt jelzi, hogy az időtartam három nap.

Az alábbi kimondott szöveg és annak részleges JSON-válasza alább látható.

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

Dátumtartomány-feloldási példák a hét napjára

Az alábbi példa bemutatja, hogy a LUIS hogyan használja a datetimeV2-t a kimondott szöveg Tuesday to Thursdayfeloldásához. Ebben a példában az aktuális dátum június 19. A LUIS az aktuális dátumot megelőző és követő dátumtartományok dátumeltérési értékeit tartalmazza.

Az alábbi kimondott szöveg és annak részleges JSON-válasza alább látható.

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

Kétértelmű idő

Az értékek tömbjének két időeleme van, ha az idő vagy az időtartomány nem egyértelmű. Ha kétértelmű idő áll rendelkezésre, az értékek az A.M. és a P.M. időpontot is megszenvedik.

Példa időtartomány-feloldási példára

A DatetimeV2 JSON-válasz megváltozott az API V3-ban. Az alábbi példa bemutatja, hogy a LUIS hogyan használja a datetimeV2-t az időtartományt tartalmazó kimondott szöveg feloldásához.

Változások az API V2-ről:

  • datetimeV2.timex.typetulajdonság már nem lesz visszaadva, mert a szülőszinten lesz visszaadva. datetimev2.type
  • A datetimeV2.value tulajdonság átnevezve a következőre datetimeV2.timex: .

Az alábbi kimondott szöveg és annak részleges JSON-válasza alább látható.

from 6pm to 7pm

A következő JSON a verbose következő paraméterrel van beállítva false:


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

Példa az időfeloldásra

Az alábbi kimondott szöveg és annak részleges JSON-válasza alább látható.

8am

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

Elavult előre összeállított datetime

Az datetime előre összeállított entitás elavult, és a datetimeV2 váltja fel.

Ha a LUIS-alkalmazásban szeretne lecserélni datetimedatetimeV2 , hajtsa végre a következő lépéseket:

  1. Nyissa meg a LUIS webes felület Entitások panelét.
  2. Törölje az előre összeállított datetime entitást.
  3. Válassza az Előre összeállított entitás hozzáadása lehetőséget
  4. Válassza a datetimeV2 lehetőséget, és kattintson a Mentés gombra.

Következő lépések

Ismerje meg a dimenziót, az e-mail entitásokat és a számot.