BIR LUIS uygulaması için datetimeV2 önceden oluşturulmuş varlık

  • Makale

Önemli

LUIS 1 Ekim 2025'te kullanımdan kaldırılacak ve 1 Nisan 2023'den itibaren yeni LUIS kaynakları oluşturamayacaksınız. Devam eden ürün desteği ve çok dilli özelliklerden yararlanmak için LUIS uygulamalarınızıkonuşma dili anlayışına geçirmenizi öneririz.

DatetimeV2 önceden oluşturulmuş varlığı tarih ve saat değerlerini ayıklar. Bu değerler, istemci programlarının tüketmesi için standartlaştırılmış bir biçimde çözülür. Konuşmanın tamamlanmayan bir tarihi veya saati olduğunda LUIS, uç nokta yanıtında hem geçmiş hem de gelecekteki değerleri içerir. Bu varlık zaten eğitilmiş olduğundan, uygulama amaçlarına datetimeV2 içeren örnek konuşmalar eklemeniz gerekmez.

datetimeV2 türleri

DatetimeV2, Recognizers-text GitHub deposundan yönetilir.

Örnek JSON

Aşağıdaki konuşma ve kısmi JSON yanıtı aşağıda gösterilmiştir.

8am on may 2nd 2019

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

datetimeV2 alt türleri

DatetimeV2 önceden oluşturulmuş varlığı aşağıdaki alt türlere sahiptir ve aşağıdaki tabloda bunların örnekleri verilmiştir:

  • date
  • time
  • daterange
  • timerange
  • datetimerange

Çözümleme değerleri

  • Konuşmadaki tarih veya saat tam olarak belirtilmiş ve kesin değilse dizi bir öğeye sahiptir.
  • datetimeV2 değeri belirsizse dizide iki öğe vardır. Belirsizlik, belirli bir yıl, saat veya zaman aralığı eksikliğini içerir. Örnekler için bkz . Belirsiz tarihler . A.M. veya P.M. için zaman belirsiz olduğunda, her iki değer de eklenir.
  • Konuşmada belirsizliğe sahip iki öğe varsa dizi dört öğeye sahiptir. Bu belirsizlik şunlara sahip öğeleri içerir:
    • Yıla kadar belirsiz bir tarih veya tarih aralığı
    • A.M. veya P.M. ile ilgili belirsiz bir zaman veya zaman aralığı. Örneğin, 3 Nisan 3:00.

Dizinin her öğesi values aşağıdaki alanlara sahip olabilir:

Özellik adı Özellik açıklaması
Timex TIMEML dilini kullanarak ek açıklama için ISO 8601 standardını ve TIMEX3 özniteliklerini izleyen TIMEX biçiminde ifade edilen saat, tarih veya tarih aralığı.
mod gibi bir değerin beforeafternasıl kullanılacağını açıklamak için kullanılan terim.
Tür Aşağıdaki öğelerden biri olabilecek alt tür: datetime, date, time, , daterange, timerange, datetimerange, duration, . set
değer isteğe bağlı. Biçim yyyy-AA-gg (tarih), SS:aaa:ss (saat) yyyy-AA-gg SS:dd SS:aa:ss (datetime) içindeki bir datetime nesnesi. ise typeduration, değer saniye sayısıdır (süre)
Yalnızca veya date, timeveya 'duration olduğunda typedatetime kullanılır.

Geçerli tarih değerleri

datetimeV2 aşağıdaki aralıklar arasındaki tarihleri destekler:

Minimum Max
1 Ocak 1900 31 Aralık 2099

Belirsiz tarihler

Tarih geçmişte veya gelecekte olabilirse, LUIS her iki değeri de sağlar. Yıl içermeyen ay ve tarihi içeren konuşmalara örnek olarak verilmiştir.

Örneğin, aşağıdaki konuşma göz önünde bulundurulduğunda:

May 2nd

  • Bugünün tarihi 3 Mayıs 2017 ise, LUIS hem "2017-05-02" hem de "2018-05-02" değerlerini sağlar.
  • Bugünün tarihi 1 Mayıs 2017 olduğunda, LUIS hem "2016-05-02" hem de "2017-05-02" değerlerini sağlar.

Aşağıdaki örnekte "2 Mayıs" varlığının çözümlemesi gösterilmektedir. Bu karar, bugünün tarihinin 2 Mayıs 2017 ile 1 Mayıs 2018 arasındaki bir tarih olduğunu varsayar. X alanında bulunan timex alanlar, tarihin ifadede açıkça belirtilmeyen bölümleridir.

Tarih çözümleme örneği

Aşağıdaki konuşma ve kısmi JSON yanıtı aşağıda gösterilmiştir.

May 2nd

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

Sayısal tarih için tarih aralığı çözümleme örnekleri

Varlık tarih datetimeV2 ve saat aralıklarını ayıklar. start ve end alanları aralığın başlangıcını ve sonunu belirtir. konuşmasında May 2nd to May 5thLUIS, hem geçerli yıl hem de sonraki yıl için tarih düzenleme değerleri sağlar. timex alanında, XXXX değerler yılın belirsizliğini gösterir. P3D zaman aralığının üç gün uzun olduğunu gösterir.

Aşağıdaki konuşma ve kısmi JSON yanıtı aşağıda gösterilmiştir.

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

Haftanın günü için tarih aralığı çözümleme örnekleri

Aşağıdaki örnekte LUIS'in ifadeyi çözümlemek için datetimeV2'yi nasıl kullandığı gösterilmektedirTuesday to Thursday. Bu örnekte geçerli tarih 19 Haziran'dır. LUIS, geçerli tarihten önce gelen ve izleyen her iki tarih aralığı için tarih düzenleme değerleri içerir.

Aşağıdaki konuşma ve kısmi JSON yanıtı aşağıda gösterilmiştir.

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

Belirsiz zaman

Değer dizisinde saat veya zaman aralığı belirsizse iki zaman öğesi vardır. Belirsiz bir zaman olduğunda, değerlerin hem A.M. hem de P.M. saatleri olur.

Zaman aralığı çözümleme örneği

API V3'te DatetimeV2 JSON yanıtı değişti. Aşağıdaki örnekte LUIS'in bir zaman aralığına sahip olan ifadeyi çözümlemek için datetimeV2'yi nasıl kullandığı gösterilmektedir.

API V2'den yapılan değişiklikler:

  • datetimeV2.timex.type özelliği artık döndürülmüyor çünkü üst düzeyinde datetimev2.typedöndürülür.
  • datetimeV2.value özelliği olarak yeniden adlandırıldıdatetimeV2.timex.

Aşağıdaki konuşma ve kısmi JSON yanıtı aşağıda gösterilmiştir.

from 6pm to 7pm

Aşağıdaki JSON parametresi olarak verbose ayarlanmıştır false:


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

Zaman çözümleme örneği

Aşağıdaki konuşma ve kısmi JSON yanıtı aşağıda gösterilmiştir.

8am

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

Kullanım dışı bırakılmış önceden oluşturulmuş tarih saat

Önceden datetime oluşturulmuş varlık kullanım dışıdır ve datetimeV2 ile değiştirilir.

YERINE LUIS uygulamanızda ile datetimeV2 değiştirmek datetime için aşağıdaki adımları tamamlayın:

  1. LUIS web arabiriminin Varlıklar bölmesini açın.
  2. Tarih saat önceden oluşturulmuş varlığı silin.
  3. Önceden oluşturulmuş varlık ekle'yi seçin
  4. datetimeV2 öğesini seçin ve Kaydet'e tıklayın.

Sonraki adımlar

Boyut, e-posta varlıkları ve sayı hakkında bilgi edinin.