Share via

موارد مطور SDK وREST وCLI لفهم اللغة (LUIS)

  • مقالة

هام

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

تساعدك SDKs وواجهات برمجة تطبيقات REST وCLI على تطوير تطبيقات Language Understanding (LUIS) بلغة البرمجة الخاصة بك. إدارة موارد Azure وتوقعات LUIS.

إدارة موارد Azure

استخدم طبقة إدارة خدمات Azure الذكاء الاصطناعي لإنشاء مورد خدمات Language Understanding أو Azure الذكاء الاصطناعي وتحريره وإدراجه وحذفه.

ابحث عن الوثائق المرجعية استنادًا إلى الأداة:

فهم اللغة لطلبات التأليف والتنبؤ

يتم الوصول إلى خدمة Language Understanding من مورد Azure الذي تحتاج إلى إنشائه. هناك سببان:

  • استخدم مورد التأليف للتدريب لإنشاء وتحرير وتدريب ونشر.
  • استخدم التنبؤ لوقت التشغيل لإرسال نص المستخدم وتلقي التنبؤ.

استخدم نموذج التعليمات البرمجية لخدمات Azure الذكاء الاصطناعي لمعرفة المهام الأكثر شيوعا واستخدامها.

مواصفات REST

تتوفر مواصفات LUIS REST، جنبًا إلى جنب مع جميع مواصفات Azure REST، بشكل عام على GitHub.

واجهة برمجة تطبيقات REST

تتوفر كل من واجهة برمجة تطبيقات نقطة نهاية التأليف والتنبؤ من واجهات برمجة تطبيقات REST:

نوع إصدار
التأليف V2
معاينة الإصدار 3
التنبؤ V2
V3

نقاط نهاية REST

يحتوي LUIS حاليًا على نوعين من نقاط النهاية:

  • التأليف على نقطة نهاية التدريب
  • توقع الاستعلام على نقطة نهاية وقت التشغيل.
الغرض عنوان URL
تأليف V2 على نقطة نهاية التدريب https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
تأليف V3 على نقطة نهاية التدريب https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
توقع V2 - جميع التنبؤات على نقطة نهاية وقت التشغيل https://{your-resource-name}.api.cognitive.microsoft.com/luis/v2.0/apps/{appId}?q={q}[&timezoneOffset][&verbose][&spellCheck][&staging][&bing-spell-check-subscription-key][&log]
توقع V3 - توقع الإصدارات على نقطة نهاية وقت التشغيل https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict?query={query}[&verbose][&log][&show-all-intents]
توقع V3 - توقع الفتحة على نقطة نهاية وقت التشغيل https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict?query={query}[&verbose][&log][&show-all-intents]

يوضح الجدول التالي المعلمات، والمشار إليها بأقواس متعرجة {}، في الجدول السابق.

المعلمة‬ الغرض
your-resource-name اسم مورد Azure
q أو query نص النطق المرسل من تطبيق العميل مثل روبوت الدردشة
version اسم إصدار 10 أحرف
slot production أو staging

معلمات سلسلة استعلام REST

تتضمن معلمات سلسلة استعلام واجهة برمجة التطبيقات V3 API:

معلمة الاستعلام اسم مدخل LUIS نوع إصدار الإعداد الافتراضي الغرض
log حفظ السجلات boolean V2, V3 true استعلام مخزن في ملف السجل. القيمة الافتراضية هي خطأ.
query - سلسلة V3 فقط لا يوجد افتراضي - إنه مطلوب في طلب GET في V2، الكلام المطلوب توقعه موجود في المعلمة q.

في V3، يتم تمرير الوظيفة في المعلمة query.
show-all-intents تضمين عشرات لجميع الأهداف boolean V3 فقط true أعد جميع الأهداف مع النتيجة المقابلة في عنصر prediction.intents. يتم إرجاع الأهداف كعناصر في عنصر intents رئيسي. يسمح هذا بالوصول الآلي دون الحاجة إلى البحث عن الهدف في صفيف: prediction.intents.give. في V2، تم إرجاع هذه في صفيف.
verbose قم بتضمين المزيد من تفاصيل الكيانات boolean V2, V3 true في الإصدار 2، عند التعيين على "صواب"، تم إرجاع جميع الأهداف المتوقعة. إذا كنت بحاجة إلى جميع الأهداف المتوقعة، فاستخدم معلمة V3 الخاصة بـ show-all-intents.

في الإصدار 3، توفر هذه المعلمة فقط تفاصيل بيانات تعريف الكيان لتوقع الكيان.
timezoneOffset - سلسلة V2 - يتم تطبيق المنطقة الزمنية على كيانات datetimeV2.
datetimeReference - سلسلة V3 - يتم تطبيق المنطقة الزمنية على كيانات datetimeV2. يستبدل timezoneOffset من V2.

مخطط التطبيق

يتم استيراد مخطط التطبيق وتصديره بتنسيق .json أو .lu.

حزم SDK المستندة إلى اللغة

اللغة الوثائق المرجعية الحزمة قوالب التشغيل السريع
C#‎ التاليف
التنبؤ		 تأليف NuGet
توقع NuGet		 التاليف
توقع الاستعلام
انتقال التأليف والتنبؤ SDK
Java التأليف والتنبؤ تأليف Maven
تنبؤ Maven
JavaScript التاليف
التنبؤ		 تأليف NPM
توقع NPM		 التاليف
التنبؤ
Python التأليف والتنبؤ نقطه التاليف
التنبؤ

الحاويات

يوفر فهم اللغة (LUIS) حاوية لتوفير إصدارات محلية ومضمنة من تطبيقك.

تصدير التنسيقات واستيرادها

يوفر فهم اللغة القدرة على إدارة تطبيقك ونماذجه بتنسيق JSON وتنسيق .LU (LUDown) وحزمة مضغوطة لحاوية Language Understanding.

يتوفر استيراد هذه التنسيقات وتصديرها من واجهات برمجة التطبيقات ومن مدخل LUIS. يوفر المدخل الاستيراد والتصدير كجزء من قائمة التطبيقات وقائمة الإصدارات.

ورش العمل

أدوات التكامل المستمر

أدوات Bot Framework

يتوفر إطار عمل الروبوت ك SDK بمجموعة متنوعة من اللغات وكخدمة باستخدام Azure الذكاء الاصطناعي Bot Service.

يوفر إطار عمل الروبوت العديد من الأدوات للمساعدة في فهم اللغة، بما في ذلك:

  • محاكي Bot Framework - هو تطبيق سطح مكتب متعدد المنصات يسمح لمطوري برامج البوتات باختبار البوتات التي تم إنشاؤها باستخدام Bot Framework SDK وتصحيحها
  • Bot Framework Composer - أداة تطوير متكاملة للمطورين والفرق متعددة التخصصات لبناء الروبوتات وتجارب المحادثة مع Microsoft Bot Framework
  • نماذج Bot Framework - في #C وJavaScript وTypeScript وPython

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