كيفية إنشاء موارد LUIS وإدارتها

هام

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

استخدم هذه المقالة للتعرف على أنواع موارد Azure التي يمكنك استخدامها مع LUIS وكيفية إدارتها.

مورد التأليف

يتيح لك مورد التأليف إنشاء تطبيقاتك وإدارتها وتدريبها واختبارها ونشرها. يتوفر مستوى تسعير واحد لمورد تأليف LUIS - مستوى (F0) المجاني، والذي يمنحك:

• مليون عملية تأليف
• 1000 طلب اختبار لنقطة نهاية التنبؤ شهريًا.

يمكنك استخدام واجهات برمجة تطبيقات LUIS البرمجية v3.0-preview لإدارة موارد التأليف.

مورد التنبؤ

يتيح لك مورد التنبؤ الاستعلام عن نقطة نهاية التنبؤ الخاصة بك بعد 1000 طلب يوفرها مورد التأليف. يتوفر مستويان للتسعير لمورد التنبؤ:

• مورد التنبؤ المجاني (F0)، والذي يمنحك 10000 طلب نقطة نهاية تنبؤ شهريًا.
• مورد التنبؤ القياسي (S0)، وهو المستوى المدفوع.

يمكنك استخدام واجهة برمجة تطبيقات نقطة نهاية LUIS v3.0-preview لإدارة موارد التنبؤ.

إشعار

• يمكنك أيضا استخدام مورد متعدد الخدمات للحصول على نقطة نهاية واحدة يمكنك استخدامها لخدمات Azure الذكاء الاصطناعي متعددة.
• يوفر LUIS نوعين من موارد F0 (المستوى المجاني): أحدهما لمعاملات التأليف والآخر لمعاملات التنبؤ. إذا نفدت الحصة النسبية المجانية لمعاملات التنبؤ، فتأكد من أنك تستخدم مورد توقع F0، الذي يمنحك 10000 معاملة مجانية شهريًا، وليس مورد التأليف، الذي يمنحك 1000 معاملة تنبؤ شهريًا.
• يجب عليك تأليف تطبيقات LUIS في المناطق التي تريد نشرها والاستعلام فيها.

إنشاء موارد LUIS

لإنشاء موارد LUIS، يمكنك استخدام مدخل LUIS أو مدخل Azure أو Azure CLI. بعد إنشاء مواردك، سوف تحتاج إلى تعيينها إلى تطبيقاتك لاستخدامها من قبلهم.

مدخل LUIS

إنشاء مورد تأليف LUIS باستخدام مدخل LUIS

1. سجل الدخول إلى مدخل LUIS، ثم حدد بلدك/ منطقتك ووافق على شروط الاستخدام. إذا رأيت قسم تطبيقاتي في المدخل، فإن مورد LUIS موجود بالفعل ويمكنك تخطي الخطوة التالية.

2. في نافذة "Choose an authoring" الذي يظهر، يُرجى البحث على اشتراك Azure ومورد تأليف LUIS. إذا لم يكن لديك موارد يُمكنك إنشاء مجموعة موارد جديدة.

   

   عند إنشاء مورد تأليف جديد، توفير المعلومات التالية:

   • اسم المستأجر - المستأجر المتصل باشتراك Azure.
   • اسم اشتراك Azure - الاشتراك الذي سيتم المحاسبة عليه بشأن المورد.
   • اسم مجموعة موارد Azure - اسم مجموعة موارد مخصصة تختارها أو تُنشئها. تسمح لك مجموعات الموارد بتجميع موارد Azure للوصول والإدارة.
   • اسم مورد Azure - اسم مخصص تختاره، ويُستخدم كجزء من عنوان "URL" لاستعلامات نقطة النهاية الخاصة بالتنبؤ والتأليف.
   • مستوى الأسعار - يحدد مستوى التسعير الحد الأقصى للعملية في الثانية والشهر.

إنشاء مورد LUIS Prediction باستخدام مدخل LUIS

1. انتقل إلى علامة التبويب "Manage" في تطبيقك.

2. من جزء التنقل الأيسر، حدد "Azure Resources".

3. حدد زر Add Prediction resource .

   

   في حال كنت تمتلك مورد تنبؤ بالفعل، أضفه. وفي حال كنت لا تمتلك مورد، حدد "Create a new prediction resource".

   

بدون مدخل LUIS

إنشاء موارد LUIS دون استخدام مدخل LUIS

استخدم Azure CLI لإنشاء كل مورد على حدة.

تلميح

• مورد kind التأليف هو LUIS.Authoring
• مورد kind التنبؤ هو LUIS

1. تسجيل الدخول إلى Azure CLI:

   az login
   

   يفتح هذا الأمر مستعرضًا حتى تتمكن من تحديد الحساب الصحيح وتوفير المصادقة.

2. إنشاء مورد تأليف LUIS من النوع LUIS.Authoring، المسمى my-luis-authoring-resource. قم بإنشائه في مجموعة الموارد الموجودة المسماة my-resource-group للمنطقة westus.

   az cognitiveservices account create -n my-luis-authoring-resource -g my-resource-group --kind LUIS.Authoring --sku F0 -l westus --yes
   

3. إنشاء مورد نقطة نهاية تنبؤ LUIS من النوع LUIS، المسمى my-luis-prediction-resource. قم بإنشائه في مجموعة الموارد الموجودة المسماة my-resource-group للمنطقة westus. إذا كنت تريد معدل نقل أعلى من المستوى المجاني الذي يوفره، فقم بالتغيير F0 إلى S0. تعرف على المزيد حول مستويات التسعير والإنتاجية.

   az cognitiveservices account create -n my-luis-prediction-resource -g my-resource-group --kind LUIS --sku F0 -l westus --yes
   

تعيين موارد LUIS

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

مدخل LUIS

تعيين الموارد باستخدام مدخل LUIS

تعيين مورد تأليف لجميع تطبيقاتك

يعين الإجراء التالي مورد التأليف لجميع التطبيقات.

1. قم بتسجيل الدخول إلى مدخل LUIS.
2. في الزاوية العلوية اليسرى، حدد حساب المستخدم، ثم حدد الإعدادات.
3. في صفحة إعدادات المستخدم، حدد إضافة مورد تأليف، ثم حدد مورد تأليف موجود. حدد حفظ.

تعيين مورد إلى تطبيق معين

يعين الإجراء التالي موردا لتطبيق معين.

1. قم بتسجيل الدخول إلى مدخل LUIS. حدد تطبيقا من قائمة تطبيقاتي.

2. انتقل إلى إدارة>موارد Azure:

   

3. في علامة التبويب Prediction resource أو Authoring resource، حدد الزر Add prediction resource أو Add authoring resource.

4. استخدم الحقول الموجودة في النموذج للعثور على المورد الصحيح، ثم حدد حفظ.

بدون مدخل LUIS

تعيين مورد التنبؤ دون استخدام مدخل LUIS

بالنسبة للعمليات التلقائية مثل البنية الأساسية لبرنامج ربط العمليات التجارية CI/CD، يمكنك أتمتة تعيين مورد LUIS إلى تطبيق LUIS بالخطوات التالية:

1. احصل على رمز Azure Resource Manager المميز وهو سلسلة أبجدية رقمية من الأحرف. تنتهي صلاحية هذا الرمز المميز، لذا استخدمه على الفور. يمكنك أيضًا استخدام أوامر Azure CLI الآتية.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. استخدم الرمز المميز لطلب موارد وقت تشغيل LUIS عبر الاشتراكات. استخدم واجهة برمجة التطبيقات للحصول على حساب LUIS Azure الذي يمكن لحساب المستخدم الوصول إليه.

   تتطلب واجهة برمجة تطبيقات POST هذه القيم التالية:

   الرأس	القيمة‬
   Authorization	قيمة Authorization هي Bearer {token}. يجب أن تكون قيمة الرمز المميز مسبوقة بالكلمة Bearer ومسافة.
   Ocp-Apim-Subscription-Key	مفتاح التأليف الخاص بك.

   تقوم واجهة برمجة التطبيقات بإرجاع صفيف من كائنات JSON التي تمثل اشتراكات LUIS الخاصة بك. تتضمن القيم التي تم إرجاعها معرف الاشتراك ومجموعة الموارد واسم المورد، الذي تم إرجاعه كـAccountName. ابحث عن العنصر في الصفيف الذي هو مورد LUIS الذي تريد تعيينه لتطبيق LUIS.

3. قم بتعيين الرمز المميز إلى مورد LUIS باستخدام تعيين حسابات LUIS Azure إلى واجهة برمجة تطبيقات التطبيق.

   تتطلب واجهة برمجة تطبيقات POST هذه القيم التالية:

   نوع	الإعداد	القيمة‬
   الرأس	Authorization	قيمة Authorization هي Bearer {token}. يجب أن تكون قيمة الرمز المميز مسبوقة بالكلمة Bearer ومسافة.
   الرأس	Ocp-Apim-Subscription-Key	مفتاح التأليف الخاص بك.
   الرأس	Content-type	application/json
   Querystring	appid	معرّف تطبيق LUIS.
   النص الأساسي		{AzureSubscriptionId: معرف اشتراكك، ResourceGroup: اسم مجموعة الموارد الذي يحتوي على مورد التنبؤ الخاص بك، AccountName: اسم مورد التنبؤ}

   عند نجاح واجهة برمجة التطبيقات هذه، فإنها ترجع 201 - created status.

إلغاء تعيين مورد

عند إلغاء تعيين مورد، لا يتم حذفه من Azure. إنه غير مرتبط فقط من LUIS.

مدخل LUIS

إلغاء تعيين الموارد باستخدام مدخل LUIS

1. سجل الدخول إلى مدخل LUIS، ثم حدد تطبيقا من قائمة تطبيقاتي.
2. انتقل إلى إدارة>موارد Azure.
3. حدد زر إلغاء تعيين المورد للمورد.

بدون مدخل LUIS

إلغاء تعيين مورد التنبؤ دون استخدام مدخل LUIS

1. احصل على رمز Azure Resource Manager المميز وهو سلسلة أبجدية رقمية من الأحرف. تنتهي صلاحية هذا الرمز المميز، لذا استخدمه على الفور. يمكنك أيضًا استخدام أوامر Azure CLI الآتية.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. استخدم الرمز المميز لطلب موارد وقت تشغيل LUIS عبر الاشتراكات. استخدم واجهة برمجة تطبيقات Get LUIS Azure accounts، والتي يمكن لحساب المستخدم الوصول إليها.

   تتطلب واجهة برمجة تطبيقات POST هذه القيم التالية:

   الرأس	القيمة‬
   Authorization	قيمة Authorization هي Bearer {token}. يجب أن تكون قيمة الرمز المميز مسبوقة بالكلمة Bearer ومسافة.
   Ocp-Apim-Subscription-Key	مفتاح التأليف الخاص بك.

   تقوم واجهة برمجة التطبيقات بإرجاع صفيف من كائنات JSON التي تمثل اشتراكات LUIS الخاصة بك. تتضمن القيم التي تم إرجاعها معرف الاشتراك ومجموعة الموارد واسم المورد، الذي تم إرجاعه كـAccountName. ابحث عن العنصر في الصفيف الذي هو مورد LUIS الذي تريد تعيينه لتطبيق LUIS.

3. قم بتعيين الرمز المميز إلى مورد LUIS باستخدام إلغاء تعيين حساب LUIS Azure من واجهة برمجة تطبيقات التطبيق.

   تتطلب واجهة برمجة تطبيقات DELETE هذه القيم التالية:

   نوع	الإعداد	القيمة‬
   الرأس	Authorization	قيمة Authorization هي Bearer {token}. يجب أن تكون قيمة الرمز المميز مسبوقة بالكلمة Bearer ومسافة.
   الرأس	Ocp-Apim-Subscription-Key	مفتاح التأليف الخاص بك.
   الرأس	Content-type	application/json
   Querystring	appid	معرّف تطبيق LUIS.
   النص الأساسي		{AzureSubscriptionId: معرف اشتراكك، ResourceGroup: اسم مجموعة الموارد الذي يحتوي على مورد التنبؤ الخاص بك، AccountName: اسم مورد التنبؤ}

   عند نجاح واجهة برمجة التطبيقات هذه، فإنها ترجع 200 - OK status.

ملكية الموارد

مورد Azure، مثل مورد LUIS، مملوك من قبل الاشتراك الذي يحتوي على المورد.

لتغيير ملكية مورد، يمكنك اتخاذ أحد هذه الإجراءات:

• نقل ملكية اشتراكك.
• قم بتصدير تطبيق LUIS كملف، ثم قم باستيراد التطبيق على اشتراك مختلف. يتوفر التصدير على صفحة تطبيقاتي في مدخل LUIS.

حدود الموارد

حدود إنشاء مفتاح التأليف

يمكنك إنشاء ما يصل إلى 10 مفاتيح تأليف لكل منطقة، لكل اشتراك. تختلف مناطق النشر عن مناطق التأليف. تأكد من إنشاء تطبيق في منطقة التأليف يتوافق مع منطقة النشر حيث تريد أن يكون تطبيق العميل موجودًا. للحصول على معلومات حول كيفية تعيين مناطق التأليف إلى مناطق النشر، راجع مناطق التأليف والنشر.

راجع حدود الموارد لمزيد من المعلومات.

أخطاء حدود الاستخدام الرئيسية

تستند حدود الاستخدام إلى مستوى التسعير.

إذا تجاوزت الحصة النسبية للمعاملات في الثانية (TPS)، فستتلقى خطأ HTTP 429. إذا تجاوزت الحصة النسبية للمعاملة لكل شهر (TPM)، فستتلقى خطأ HTTP 403.

تغيير مستوى الأسعار

1. في مدخل Microsoft Azure، انتقل إلى All resources وحدد المورد الخاص بك

   

2. من القائمة اليمنى، حدد Pricing tier لمشاهدة مستويات التسعير المتوفرة

3. حدد مستوى التسعير الذي تريده، وانقر فوق تحديد لحفظ التغيير. عند اكتمال تغيير التسعير، سيظهر إعلام في أعلى اليمين مع تحديث مستوى التسعير.

عرض مقاييس موارد Azure

عرض ملخص لاستخدام موارد Azure

يمكنك عرض معلومات استخدام LUIS في مدخل Microsoft Azure. تعرض صفحة نظرة عامة ملخصًا، بما في ذلك المكالمات والأخطاء الأخيرة. إذا قمت بإجراء طلب نقطة نهاية LUIS، فاسمح بما يصل إلى خمس دقائق حتى يظهر التغيير.

تخصيص مخططات استخدام موارد Azure

توفر صفحة المقاييس طريقة عرض أكثر تفصيلا للبيانات. يمكنك تكوين مخططات المقاييس لفترة زمنية محددة ومقياس معين.

تنبيه حد المعاملات الإجمالي

إذا كنت تريد معرفة متى تصل إلى حد معاملة معين، على سبيل المثال 10000 معاملة، يمكنك إنشاء تنبيه:

1. من القائمة الجانبية اليسرى حدد Alerts

2. من القائمة العلوية حدد قاعدة تنبيه جديدة

   

3. حدد إضافة شرط

   

4. حدد Total calls

   

5. قم بالتمرير لأسفل وصولًا إلى قسم منطق التنبيه وقم بتعيين السمات كما تريد وانقر فوق تم

   

6. لإرسال إعلامات أو استدعاء إجراءات عند تشغيل قاعدة التنبيه انتقل إلى قسم الإجراءات وأضف مجموعة الإجراءات الخاصة بك.

   

إعادة تعيين مفتاح تأليف

لتطبيقات موارد التأليف التي تم ترحيلها: إذا تم اختراق مفتاح التأليف الخاص بك، قم بإعادة تعيين المفتاح في مدخل Microsoft Azure، في صفحة Keys لمورد التأليف.

بالنسبة للتطبيقات التي لم يتم ترحيلها: يتم إعادة تعيين المفتاح على جميع تطبيقاتك في مدخل LUIS. إذا قمت بتأليف تطبيقاتك عبر واجهات برمجة تطبيقات التأليف، فستحتاج إلى تغيير قيمة Ocp-Apim-Subscription-Key إلى المفتاح الجديد.

إعادة إنشاء مفتاح Azure

يمكنك إعادة إنشاء مفتاح Azure من صفحة Keys في مدخل Microsoft Azure.

ملكية التطبيق والوصول والأمان

يتم تعريف التطبيق بواسطة موارد Azure الخاصة به، والتي يتم تحديدها بواسطة اشتراك المالك.

يمكنك نقل تطبيق LUIS الخاص بك. استخدم الموارد التالية لمساعدتك على القيام بذلك باستخدام مدخل Microsoft Azure أو Azure CLI:

• نقل موارد إلى مجموعة موارد جديدة أو اشتراك
• نقل مورد داخل نفس الاشتراك أو عبر الاشتراكات

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

• تعلم كيفية استخدام الإصدارات للتحكم في دورة حياة التطبيق.