كيان DatetimeV2 تم إنشاؤه مسبقاً لتطبيق LUIS

هام

سيتم إيقاف LUIS في 1 أكتوبر 2025 وبدءا من 1 أبريل 2023، لن تتمكن من إنشاء موارد LUIS جديدة. نوصي بترحيل تطبيقات LUIS الخاصة بك إلى فهم لغة المحادثة للاستفادة من دعم المنتج المستمر والقدرات متعددة اللغات.

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

أنواع datetimeV2

تتم إدارة DatetimeV2 من مستودع GitHub Recognizers-text.

مثال 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
بداية الفهرس	int - الفهرس في الكلام الذي يبدأ عنده الكيان.
endIndex	int - الفهرس في الكلام الذي ينتهي عنده الكيان.
الدقة	يحتوي على values صفيف تحتوي على قيمة واحدة أو اثنتين أو أربع من قيم الدقة.
النهاية	القيمة النهائية لوقت، أو نطاق تاريخ، بنفس تنسيق value. يُستخدم فقط إذا كانت type هي daterange أوtimerange أوdatetimerange

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

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

• date
• time
• daterange
• timerange
• datetimerange

القيم الدقة

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

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

اسم الخاصية	وصف الخاصية
timex	الوقت أو التاريخ أو النطاق الزمني المعبر عنه بتنسيق TIMEX الذي يتبع معيار ISO 8601 وسمات TIMEX3 للتعليق التوضيحي باستخدام لغة TimeML.
mod	مصطلح يستخدم لوصف كيفية استخدام القيمة مثل before، after.
النوع	النوع الفرعي، الذي يمكن أن يكون أحد العناصر التالية: datetime، date، time، daterange، timerange، datetimerange، duration، set.
قيمة	اختياري. عنصر تاريخ / وقت بتنسيق yyyy-MM-dd (تاريخ)، HH: mm: ss (time) yyyy-MM-dd HH: mm: ss (datetime). إذا كانت type ، durationفإن القيمة هي عدد الثوان (المدة) يُستخدم فقط إذا كانت type هي datetime أو dateأو timeأو `المدة.

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

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

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

تواريخ غامضة

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

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

May 2nd

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

يوضح المثال التالي دقة الكيان "may 2nd". تفترض هذه الدقة أن تاريخ اليوم هو تاريخ بين 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 قيم daterange لكل من العام الحالي والعام الذي يليه. في الحقل 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 قيم daterange لكل من نطاقات التاريخ التي تسبق التاريخ الحالي وتتبعه.

يتم عرض العبارة التالية واستجابة 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"
          }
        ]
      }
    }
  ]

وقت غامض

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

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

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

التغييرات من API 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.

لاستبدال datetime بـ datetimeV2 في تطبيق LUIS، أكمل الخطوات التالية:

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

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

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