كيان DatetimeV2 المنشأ مسبقا لتطبيق LUIS

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

يقوم كيان datetimeV2 الذي تم إنشاؤه مسبقا باستخراج قيم التاريخ والوقت. يتم حل هذه القيم بتنسيق موحد لبرامج العميل لاستهلاكها. عندما يكون للنطق تاريخ أو وقت غير مكتمل، يتضمن LUIS قيما سابقة ومستقبلية في استجابة نقطة النهاية. نظرا لأن هذا الكيان تم تدريبه بالفعل ، فلن تحتاج إلى إضافة أمثلة على الألفاظ التي تحتوي على datetimeV2 إلى مقاصد التطبيق.

أنواع datetimeV2

تتم إدارة DatetimeV2 من مستودع GitHub نص أدوات التعرف.

مثال JSON

يتم عرض اللفظ التالي واستجابة JSON الجزئية أدناه.

8am on may 2nd 2019

استجابة V3

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

استجابة مطولة V3

"entities": {
    "datetimeV2": [
        {
            "type": "datetime",
            "values": [
                {
                    "timex": "2019-05-02T08",
                    "resolution": [
                        {
                            "value": "2019-05-02 08:00:00"
                        }
                    ]
                }
            ]
        }
    ],
    "$instance": {
        "datetimeV2": [
            {
                "type": "builtin.datetimeV2.datetime",
                "text": "8am on may 2nd 2019",
                "startIndex": 0,
                "length": 19,
                "modelTypeId": 2,
                "modelType": "Prebuilt Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

استجابة V2

"entities": [
  {
    "entity": "8am on may 2nd 2019",
    "type": "builtin.datetimeV2.datetime",
    "startIndex": 0,
    "endIndex": 18,
    "resolution": {
      "values": [
        {
          "timex": "2019-05-02T08",
          "type": "datetime",
          "value": "2019-05-02 08:00:00"
        }
      ]
    }
  }
]

اسم الخاصية	نوع العقار ووصفه
الكيان	string - نص مستخرج من النطق مع نوع التاريخ أو الوقت أو النطاق الزمني أو النطاق الزمني.
النوع	سلسلة - أحد الأنواع الفرعية ل datetimeV2
startIndex	int - الفهرس في الكلام الذي يبدأ به الكيان.
نهاية الفهرس	int - الفهرس في اللفظ الذي ينتهي عنده الكيان.
دقة	يحتوي على صفيف يحتوي على values قيمة واحدة أو قيمتين أو أربع قيم للدقة.
النهاية	القيمة النهائية لوقت أو نطاق زمني بنفس تنسيق value. يستخدم فقط إذا كان typedaterange، timerangeأو datetimerange

الأنواع الفرعية من datetimeV2

يحتوي كيان datetimeV2 الذي تم إنشاؤه مسبقا على الأنواع الفرعية التالية، ويتم توفير أمثلة لكل منها في الجدول التالي:

• date
• time
• daterange
• timerange
• datetimerange

قيم الدقة

• يحتوي الصفيف على عنصر واحد إذا كان التاريخ أو الوقت في الكلام محددا تماما ولا لبس فيه.
• يحتوي الصفيف على عنصرين إذا كانت قيمة datetimeV2 غامضة. يشمل الغموض عدم وجود سنة أو وقت أو نطاق زمني محدد. راجع التواريخ الغامضة للحصول على أمثلة. عندما يكون الوقت غامضا ل A.M. أو P.M. ، يتم تضمين كلتا القيمتين.
• يحتوي الصفيف على أربعة عناصر إذا كان اللفظ يحتوي على عنصرين مع الغموض. ويشمل هذا الغموض العناصر التي تحتوي على:
  • تاريخ أو نطاق زمني غامض فيما يتعلق بالسنة
  • نطاق زمني أو زمني غامض فيما يتعلق ب A.M. أو P.M. على سبيل المثال، 3:00 3 أبريل.

قد يحتوي كل عنصر من values عناصر الصفيف على الحقول التالية:

اسم الخاصية	وصف العقار
تيميكس	الوقت أو التاريخ أو النطاق الزمني المعبر عنه بتنسيق TIMEX الذي يتبع معيار ISO 8601 وسمات TIMEX3 للتعليق التوضيحي باستخدام لغة TimeML.
mod	مصطلح يستخدم لوصف كيفية استخدام القيمة مثل before، after.
النوع	النوع الفرعي ، والذي يمكن أن يكون أحد العناصر التالية: datetime، ، ، ، timetimerange، daterangedatedatetimerangedurationset.
القيمة	‏‏اختياري. كائن datetime في تنسيق yy-MM-dd (التاريخ)، HH:mm:ss (الوقت) yyyy-MM-dd HH:mm:ss (datetime). إذا type كان الأمر كذلك duration، فإن القيمة هي عدد الثواني (المدة) يستخدم فقط إذا كان typedatetime أو ، timeأو date"المدة".

قيم التواريخ الصالحة

يدعم datetimeV2 التواريخ بين النطاقات التالية:

Min	حد أقصى
1 يناير 1900	31 ديسمبر 2099

تواريخ غامضة

إذا كان التاريخ يمكن أن يكون في الماضي أو المستقبل، يوفر LUIS كلتا القيمتين. مثال على ذلك هو الكلام الذي يتضمن الشهر والتاريخ بدون السنة.

على سبيل المثال ، بالنظر إلى العبارة التالية:

May 2nd

• إذا كان تاريخ اليوم هو 3 مايو 2017 ، فإن LUIS يوفر كلا من "2017-05-02" و "2018-05-02" كقيم.
• عندما يكون تاريخ اليوم هو 1 مايو 2017 ، يوفر LUIS كلا من "2016-05-02" و "2017-05-02" كقيم.

يوضح المثال التالي قرار الكيان "2 مايو". يفترض هذا القرار أن تاريخ اليوم هو تاريخ بين 2 مايو 2017 و 1 مايو 2018. الحقول X الموجودة في الحقل timex هي أجزاء من التاريخ غير محددة صراحة في اللفظ.

مثال على دقة التاريخ

يتم عرض اللفظ التالي واستجابة JSON الجزئية أدناه.

May 2nd

استجابة V3

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

استجابة مطولة V3

"entities": {
    "datetimeV2": [
        {
            "type": "date",
            "values": [
                {
                    "timex": "XXXX-05-02",
                    "resolution": [
                        {
                            "value": "2019-05-02"
                        },
                        {
                            "value": "2020-05-02"
                        }
                    ]
                }
            ]
        }
    ],
    "$instance": {
        "datetimeV2": [
            {
                "type": "builtin.datetimeV2.date",
                "text": "May 2nd",
                "startIndex": 0,
                "length": 7,
                "modelTypeId": 2,
                "modelType": "Prebuilt Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

استجابة V2

  "entities": [
    {
      "entity": "may 2nd",
      "type": "builtin.datetimeV2.date",
      "startIndex": 0,
      "endIndex": 6,
      "resolution": {
        "values": [
          {
            "timex": "XXXX-05-02",
            "type": "date",
            "value": "2019-05-02"
          },
          {
            "timex": "XXXX-05-02",
            "type": "date",
            "value": "2020-05-02"
          }
        ]
      }
    }
  ]

أمثلة على دقة النطاق الزمني للتاريخ الرقمي

يقوم الكيان datetimeV2 باستخراج نطاقات التاريخ والوقت. start تحدد الحقول وبداية النطاق ونهايتهend. بالنسبة للنطق May 2nd to May 5th، يوفر LUIS قيم النطاق الزمني لكل من العام الحالي والعام التالي. في الحقل timex ، XXXX تشير القيم إلى غموض السنة. P3D يشير إلى أن الفترة الزمنية هي ثلاثة أيام.

يتم عرض اللفظ التالي واستجابة JSON الجزئية أدناه.

May 2nd to May 5th

استجابة V3

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

استجابة مطولة V3

"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"
                        }
                    ]
                }
            ]
        }
    ],
    "$instance": {
        "datetimeV2": [
            {
                "type": "builtin.datetimeV2.daterange",
                "text": "May 2nd to May 5th",
                "startIndex": 0,
                "length": 18,
                "modelTypeId": 2,
                "modelType": "Prebuilt Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

استجابة V2

"entities": [
    {
      "entity": "may 2nd to may 5th",
      "type": "builtin.datetimeV2.daterange",
      "startIndex": 0,
      "endIndex": 17,
      "resolution": {
        "values": [
          {
            "timex": "(XXXX-05-02,XXXX-05-05,P3D)",
            "type": "daterange",
            "start": "2019-05-02",
            "end": "2019-05-05"
          }
        ]
      }
    }
  ]

أمثلة على دقة النطاق الزمني ليوم من أيام الأسبوع

يوضح المثال التالي كيفية استخدام LUIS ل datetimeV2 لحل النطق Tuesday to Thursday. في هذا المثال، التاريخ الحالي هو 19 يونيو. يتضمن LUIS قيم النطاق الزمني لكل من النطاقات الزمنية التي تسبق التاريخ الحالي وتتابعه.

يتم عرض اللفظ التالي واستجابة JSON الجزئية أدناه.

Tuesday to Thursday

استجابة V3

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

استجابة مطولة V3

"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"
                        }
                    ]
                }
            ]
        }
    ],
    "$instance": {
        "datetimeV2": [
            {
                "type": "builtin.datetimeV2.daterange",
                "text": "Tuesday to Thursday",
                "startIndex": 0,
                "length": 19,
                "modelTypeId": 2,
                "modelType": "Prebuilt Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

استجابة V2

  "entities": [
    {
      "entity": "tuesday to thursday",
      "type": "builtin.datetimeV2.daterange",
      "startIndex": 0,
      "endIndex": 19,
      "resolution": {
        "values": [
          {
            "timex": "(XXXX-WXX-2,XXXX-WXX-4,P2D)",
            "type": "daterange",
            "start": "2019-04-30",
            "end": "2019-05-02"
          }
        ]
      }
    }
  ]

وقت غامض

يحتوي صفيف القيم على عنصرين زمنيين إذا كان النطاق الزمني أو الزمني غامضا. عندما يكون هناك وقت غامض ، يكون للقيم أوقات A.M. و P.M.

مثال على دقة النطاق الزمني

تم تغيير استجابة DatetimeV2 JSON في واجهة برمجة التطبيقات V3. يوضح المثال التالي كيفية استخدام LUIS ل datetimeV2 لحل النطق الذي يحتوي على نطاق زمني.

التغييرات من واجهة برمجة التطبيقات V2:

• datetimeV2.timex.type لم يعد يتم إرجاع الممتلكات لأنه يتم إرجاعها على المستوى الأصلي ، datetimev2.type.
• datetimeV2.value تمت إعادة تسمية العقار إلى datetimeV2.timex.

يتم عرض اللفظ التالي واستجابة JSON الجزئية أدناه.

from 6pm to 7pm

استجابة V3

JSON التالي مع تعيين المعلمة verbose إلى false:

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

استجابة مطولة V3

JSON التالي مع تعيين المعلمة verbose إلى true:

"entities": {
    "datetimeV2": [
        {
            "type": "timerange",
            "values": [
                {
                    "timex": "(T18,T19,PT1H)",
                    "resolution": [
                        {
                            "start": "18:00:00",
                            "end": "19:00:00"
                        }
                    ]
                }
            ]
        }
    ],
    "$instance": {
        "datetimeV2": [
            {
                "type": "builtin.datetimeV2.timerange",
                "text": "from 6pm to 7pm",
                "startIndex": 0,
                "length": 15,
                "modelTypeId": 2,
                "modelType": "Prebuilt Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

استجابة V2

  "entities": [
    {
      "entity": "6pm to 7pm",
      "type": "builtin.datetimeV2.timerange",
      "startIndex": 0,
      "endIndex": 9,
      "resolution": {
        "values": [
          {
            "timex": "(T18,T19,PT1H)",
            "type": "timerange",
            "start": "18:00:00",
            "end": "19:00:00"
          }
        ]
      }
    }
  ]

مثال على دقة الوقت

يتم عرض اللفظ التالي واستجابة JSON الجزئية أدناه.

8am

استجابة V3

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

استجابة مطولة V3

"entities": {
    "datetimeV2": [
        {
            "type": "time",
            "values": [
                {
                    "timex": "T08",
                    "resolution": [
                        {
                            "value": "08:00:00"
                        }
                    ]
                }
            ]
        }
    ],
    "$instance": {
        "datetimeV2": [
            {
                "type": "builtin.datetimeV2.time",
                "text": "8am",
                "startIndex": 0,
                "length": 3,
                "modelTypeId": 2,
                "modelType": "Prebuilt Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

استجابة V2

"entities": [
  {
    "entity": "8am",
    "type": "builtin.datetimeV2.time",
    "startIndex": 0,
    "endIndex": 2,
    "resolution": {
      "values": [
        {
          "timex": "T08",
          "type": "time",
          "value": "08:00:00"
        }
      ]
    }
  }
]

وقت التاريخ المهمل مسبقا

يتم إهمال الكيان datetime الذي تم إنشاؤه مسبقا واستبداله ب datetimeV2.

لاستبدالها datetimedatetimeV2 في تطبيق LUIS الخاص بك، أكمل الخطوات التالية:

1. افتح جزء الكيانات من واجهة ويب LUIS.
2. حذف كيان datetime الذي تم إنشاؤه مسبقا.
3. انقر على إضافة كيان تم إنشاؤه مسبقا
4. حدد datetimeV2 وانقر على حفظ.

الخطوات التالية

تعرف على المزيد حول نقطة نهاية التنبؤ V3.

تعرف على البعد وكيانات البريد الإلكترونيوالرقم.