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

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

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

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

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

⁧⁩مورد التأليف⁧⁩

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

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

يمكنك استخدام واجهات برمجة تطبيقات LUIS البرمجية لمعاينة الإصدار 3.0 لإدارة موارد التأليف.

مورد التنبؤ

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

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

يمكنك استخدام واجهة برمجة تطبيقات LUIS Endpoint لمعاينة الإصدار 3.0 لإدارة موارد التنبؤ.

ملاحظة

• يمكنك أيضا استخدام مورد متعدد الخدمات للحصول على نقطة نهاية واحدة يمكنك استخدامها لخدمات معرفية متعددة.
• يوفر 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 باستخدام مدخل LUIS

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

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

3. انقر على زر "Add prediction resource" .

   

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

   

بدون بوابة لويس

إنشاء موارد 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. انتقل إلى مواردManageAzure>:

   

3. في علامة التبويب مورد التنبؤ أو مورد التأليف، حدد الزر إضافة مورد تنبؤ أو إضافة مورد تأليف.

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

بدون بوابة لويس

تعيين مورد التنبؤ دون استخدام مدخل 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
   سلسلة الاستعلام	appid	معرف تطبيق LUIS.
   النص الأساسي		{AzureSubscriptionId: معرف الاشتراك الخاص بك، ResourceGroupاسم مجموعة الموارد التي تحتوي على مورد التنبؤ الخاص بك،: AccountNameاسم مورد التنبؤ الخاص بك}:

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

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

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

مدخل LUIS

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

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

بدون بوابة لويس

إلغاء تعيين مورد التنبؤ دون استخدام مدخل 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، التي يمكن لحساب المستخدم الخاص بك الوصول إليها.

   تتطلب واجهة برمجة تطبيقات 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
   سلسلة الاستعلام	appid	معرف تطبيق LUIS.
   النص الأساسي		{AzureSubscriptionId: معرف الاشتراك الخاص بك، ResourceGroupاسم مجموعة الموارد التي تحتوي على مورد التنبؤ الخاص بك،: AccountNameاسم مورد التنبؤ الخاص بك}:

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

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

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

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

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

حدود الموارد

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

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

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

أخطاء في حدود استخدام المفاتيح

تعتمد حدود الاستخدام على طبقة التسعير.

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

تغيير طبقة التسعير

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

   

2. من القائمة الموجودة على الجانب الأيمن، حدد طبقة التسعير للاطلاع على مستويات التسعير المتاحة

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

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

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

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

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

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

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

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

1. من القائمة الموجودة على الجانب الأيمن، اختر التنبيهات

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

   

3. انقر على إضافة شرط

   

4. حدد إجمالي المكالمات

   

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

   

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

   

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

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

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

Regenerate a Azure key

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

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

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

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

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

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

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