تثبيت حاويات Docker وتشغيلها ل LUIS

  • مقالة
  • قراءة خلال 15 دقائق

ملاحظة

تم تغيير موقع صورة الحاوية مؤخرا. اقرأ هذه المقالة للاطلاع على الموقع المحدث لهذه الحاوية.

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

يتم من خلال حاوية Language Understanding (LUIS) تحميل نموذج Language Understanding المدرب أو نشره. كتطبيق LUIS ، توفر حاوية عامل الرصيف الوصول إلى تنبؤات الاستعلام من نقاط نهاية واجهة برمجة التطبيقات الخاصة بالحاوية. يمكنك جمع سجلات الاستعلام من الحاوية وإعادة تحميلها إلى تطبيق Language Understanding لتحسين دقة التنبؤ بالتطبيق.

يوضح الفيديو التالي استخدام هذه الحاوية.

Container demonstration for Cognitive Services

إذا لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانياً قبل أن تبدأ.

المتطلبات الأساسية

لتشغيل حاوية LUIS لاحظ المتطلبات الأساسية التالية:

  • Docker مثبت على كمبيوتر مضيف. يجب تكوين Docker للسماح للحاويات بالاتصال ببيانات الفوترة وإرسالها إلى Azure.
    • في Windows ، يجب أيضا تكوين Docker لدعم حاويات Linux.
    • يجب أن يكون لديك فهم أساسي لمفاهيم Docker.
  • مورد LUIS مع طبقة التسعير المجانية (F0) أو القياسية (S).
  • تطبيق مدرب أو منشور يتم تعبئته كإدخال مثبت على الحاوية باستخدام معرف التطبيق المرتبط به. يمكنك الحصول على الملف المعبأ من مدخل LUIS أو واجهات برمجة تطبيقات التأليف. إذا كنت تحصل على تطبيق LUIS المعبأ من واجهات برمجة تطبيقات التأليف ، فستحتاج أيضا إلى مفتاح التأليف الخاص بك.

جمع المعلمات المطلوبة

هناك حاجة إلى ثلاثة معلمات أساسية لجميع حاويات الخدمات المعرفية. يجب أن تكون شروط ترخيص برامج Microsoft موجودة بقيمة قبول. هناك حاجة أيضا إلى مفتاح URI وواجهة برمجة التطبيقات لنقطة النهاية.

URI نقطة النهاية

{ENDPOINT_URI} تتوفر القيمة في صفحة نظرة عامة على مدخل Azure لمورد الخدمات المعرفية المقابل. انتقل إلى صفحة نظرة عامة ، ومرر مؤشر الماوس فوق نقطة النهاية، وستظهر أيقونة نسخ إلى الحافظة . انسخ نقطة النهاية واستخدمها عند الحاجة.

Screenshot that shows gathering the endpoint URI for later use.

المفاتيح

{API_KEY} يتم استخدام القيمة لبدء تشغيل الحاوية وهي متوفرة في صفحة مفاتيح مدخل Azure من مورد الخدمات المعرفية المقابل. انتقل إلى صفحة المفاتيح ، وحدد أيقونة نسخ إلى الحافظة .

Screenshot that shows getting one of the two keys for later use.

هام

يتم استخدام مفاتيح الاشتراك هذه للوصول إلى واجهة برمجة تطبيقات الخدمات المعرفية. لا تشارك مفاتيحك. تخزينها بشكل آمن. على سبيل المثال، استخدم Azure Key Vault. نوصي أيضا بإعادة إنشاء هذه المفاتيح بانتظام. مفتاح واحد فقط ضروري لإجراء استدعاء واجهة برمجة التطبيقات. عند إعادة إنشاء المفتاح الأول، يمكنك استخدام المفتاح الثاني لاستمرار الوصول إلى الخدمة.

معرف التطبيق {APP_ID}

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

The screen for finding your app ID.

مفتاح التأليف {AUTHORING_KEY}

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

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

The screen for finding your authoring resource key.

تأليف واجهات برمجة التطبيقات لملف الحزمة

تأليف واجهات برمجة التطبيقات للتطبيقات المعبأة:

الكمبيوتر المضيف

المضيف هو جهاز كمبيوتر يستند إلى x64 يقوم بتشغيل حاوية Docker. يمكن أن يكون جهاز كمبيوتر في المبنى الخاص بك أو خدمة استضافة Docker في Azure، مثل:

متطلبات الحاويات والتوصيات

يسرد الجدول أدناه القيم الدنيا والموصى بها لمضيف الحاوية. قد تتغير متطلباتك وفقا لحجم الزيارات.

الحاوية الحدّ الأدنى المستحسنة تي بي إس
(الحد الأدنى، الحد الأقصى)
LUIS نواة واحدة، ذاكرة 2 جيجابايت 1 نواة، ذاكرة 4 جيجابايت 20, 40
  • يجب أن يكون كل نواة 2.6 غيغاهيرتز على الأقل (غيغاهرتز) أو أسرع.
  • TPS - المعاملات في الثانية

يتوافق --cpus النواة والذاكرة مع الإعدادات والإعدادات --memory المستخدمة كجزء من docker run الأمر.

احصل على صورة الحاوية باستخدام docker pull

docker pull استخدم الأمر لتنزيل صورة حاوية من mcr.microsoft.com/azure-cognitive-services/language/luis المستودع:

docker pull mcr.microsoft.com/azure-cognitive-services/language/luis:latest

للحصول على وصف كامل للعلامات المتوفرة، مثل latest المستخدمة في الأمر السابق، راجع LUIS على Docker Hub.

تلميح

يمكنك استخدام الأمر "صور عامل الإرساء " لسرد صور الحاوية التي تم تنزيلها. على سبيل المثال، يسرد الأمر التالي المعرف والمستودع والعلامة الخاصة بكل صورة حاوية تم تنزيلها، منسقة كجدول:

docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"

IMAGE ID         REPOSITORY                TAG
<image-id>       <repository-path/name>    <tag-name>

كيفية استخدام الحاوية

بمجرد أن تكون الحاوية على الكمبيوتر المضيف ، استخدم العملية التالية للعمل مع الحاوية.

Process for using Language Understanding (LUIS) container

  1. تصدير حزمة للحاوية من مدخل LUIS أو واجهات برمجة تطبيقات LUIS.
  2. نقل ملف الحزمة إلى دليل الإدخال المطلوب على الكمبيوتر المضيف. لا تقم بإعادة تسمية ملف حزمة LUIS أو تغييره أو الكتابة فوقه أو فك ضغطه.
  3. قم بتشغيل الحاوية، مع تحميل الإدخال المطلوب وإعدادات الفوترة. تتوفر المزيد من الأمثلة علىdocker run الأمر.
  4. الاستعلام عن نقطة نهاية التنبؤ بالحاوية.
  5. عند الانتهاء من استخدام الحاوية، قم باستيراد سجلات نقطة النهاية من حامل الإخراج في مدخل LUIS وأوقف الحاوية.
  6. استخدم التعلم النشط لمدخل LUIS في صفحة مراجعة نطق نقطة النهاية لتحسين التطبيق.

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

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

تصدير التطبيق المعبأ من LUIS

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

الموقع الافتراضي هو input الدليل الفرعي فيما يتعلق بالمكان الذي docker run تقوم فيه بتشغيل الأمر.

ضع ملف الحزمة في دليل وقم بالرجوع إلى هذا الدليل كحامل إدخال عند تشغيل حاوية عامل الرصيف.

أنواع الحزم

يمكن أن يحتوي دليل تحميل الإدخال على نماذج الإنتاجوالتدريجوالإصدار للتطبيق في وقت واحد. يتم تركيب جميع الحزم.

نوع الحزمة واجهة برمجة تطبيقات نقطة نهاية الاستعلام توفر الاستعلام تنسيق اسم ملف الحزمة
تم إصداره الحصول على ، آخر حاوية فقط {APP_ID}_v{APP_VERSION}.gz
التشغيل المرحلي الحصول على ، آخر Azure والحاوية {APP_ID}_STAGING.gz
التشغيل الحصول على ، آخر Azure والحاوية {APP_ID}_PRODUCTION.gz

هام

لا تقم بإعادة تسمية ملفات حزمة LUIS أو تغييرها أو الكتابة فوقها أو فك ضغطها.

متطلبات التعبئة والتغليف

قبل تعبئة تطبيق LUIS ، يجب أن يكون لديك ما يلي:

متطلبات التعبئة والتغليف التفاصيل
Azure Cognitive Services resource instance تشمل المناطق المدعومة

غرب الولايات المتحدة (westus)
أوروبا الغربية (westeurope)
شرق أستراليا (australiaeast)
تطبيق LUIS المدرب أو المنشور مع عدم وجود تبعيات غير مدعومة.
الوصول إلى نظام ملفات الكمبيوتر المضيف يجب أن يسمح الكمبيوتر المضيف بتحميل إدخال.

تصدير حزمة التطبيق من مدخل LUIS

توفر بوابة LUIS القدرة على تصدير حزمة التطبيق المدربة أو المنشورة.

تصدير حزمة التطبيق المنشورة من بوابة LUIS الإلكترونية

تتوفر حزمة التطبيق المنشورة من صفحة قائمة تطبيقاتي.

  1. سجل الدخول إلى مدخل LUIS.
  2. حدد خانة الاختيار الموجودة على يمين اسم التطبيق في القائمة.
  3. حدد العنصر تصدير من شريط الأدوات السياقي أعلى القائمة.
  4. حدد تصدير للحاوية (GZIP).
  5. حدد بيئة فتحة الإنتاج أو فتحةالترتيب.
  6. يتم تنزيل الحزمة من المتصفح.

Export the published package for the container from the App page's Export menu

تصدير حزمة التطبيق التي تم إصدارها من مدخل LUIS

تتوفر حزمة التطبيق التي تم إصدارها من صفحة قائمة الإصدارات .

  1. سجل الدخول إلى مدخل LUIS.
  2. حدد التطبيق في القائمة.
  3. حدد إدارة في شريط التنقل في التطبيق.
  4. حدد الإصدارات في شريط التنقل الأيمن.
  5. حدد خانة الاختيار الموجودة على يمين اسم الإصدار في القائمة.
  6. حدد العنصر تصدير من شريط الأدوات السياقي أعلى القائمة.
  7. حدد تصدير للحاوية (GZIP).
  8. يتم تنزيل الحزمة من المتصفح.

Export the trained package for the container from the Versions page's Export menu

تصدير حزمة التطبيق المنشورة من واجهة برمجة التطبيقات

استخدم طريقة واجهة برمجة تطبيقات REST التالية، لحزم تطبيق LUIS قمت بنشره بالفعل. استبدال القيم المناسبة الخاصة بك للعناصر النائبة في استدعاء واجهة برمجة التطبيقات، باستخدام الجدول الموجود أسفل مواصفات HTTP.

GET /luis/api/v2.0/package/{APP_ID}/slot/{SLOT_NAME}/gzip HTTP/1.1
Host: {AZURE_REGION}.api.cognitive.microsoft.com
Ocp-Apim-Subscription-Key: {AUTHORING_KEY}
العنصر النائب القيمة
{APP_ID} معرف التطبيق الخاص بتطبيق LUIS المنشور.
{SLOT_NAME} بيئة تطبيق LUIS المنشور. استخدم إحدى القيم التالية:
PRODUCTION
STAGING
{AUTHORING_KEY} مفتاح التأليف لحساب LUIS لتطبيق LUIS المنشور.
يمكنك الحصول على مفتاح التأليف من صفحة الإعدادات المستخدم على مدخل LUIS.
{AZURE_REGION} منطقة Azure المناسبة:

westus - غرب الولايات المتحدة
westeurope - أوروبا الغربية
australiaeast - شرق أستراليا

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

تصدير حزمة التطبيق التي تم إصدارها من واجهة برمجة التطبيقات

استخدم طريقة واجهة برمجة تطبيقات REST التالية، لحزم تطبيق LUIS الذي قمت بتدريبه بالفعل. استبدال القيم المناسبة الخاصة بك للعناصر النائبة في استدعاء واجهة برمجة التطبيقات، باستخدام الجدول الموجود أسفل مواصفات HTTP.

GET /luis/api/v2.0/package/{APP_ID}/versions/{APP_VERSION}/gzip HTTP/1.1
Host: {AZURE_REGION}.api.cognitive.microsoft.com
Ocp-Apim-Subscription-Key: {AUTHORING_KEY}
العنصر النائب القيمة
{APP_ID} معرف التطبيق الخاص بتطبيق LUIS المدرب.
{APP_VERSION} إصدار التطبيق من تطبيق LUIS المدرب.
{AUTHORING_KEY} مفتاح التأليف لحساب LUIS لتطبيق LUIS المنشور.
يمكنك الحصول على مفتاح التأليف من صفحة الإعدادات المستخدم على مدخل LUIS.
{AZURE_REGION} منطقة Azure المناسبة:

westus - غرب الولايات المتحدة
westeurope - أوروبا الغربية
australiaeast - شرق أستراليا

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

قم بتشغيل الحاوية باستخدام docker run

استخدم الأمر تشغيل عامل الرصيف لتشغيل الحاوية. ارجع إلى جمع المعلمات المطلوبة للحصول على تفاصيل حول كيفية الحصول على {ENDPOINT_URI} القيم والقيم {API_KEY} .

تتوفر أمثلة على docker run الأمر.

docker run --rm -it -p 5000:5000 ^
--memory 4g ^
--cpus 2 ^
--mount type=bind,src=c:\input,target=/input ^
--mount type=bind,src=c:\output\,target=/output ^
mcr.microsoft.com/azure-cognitive-services/language/luis ^
Eula=accept ^
Billing={ENDPOINT_URI} ^
ApiKey={API_KEY}
  • يستخدم هذا المثال الدليل خارج محرك الأقراص لتجنب أي تعارضات في الأذونات C: على Windows. إذا كنت بحاجة إلى استخدام دليل معين كدليل إدخال، فقد تحتاج إلى منح إذن خدمة عامل الإرث.
  • تجنب بتغيير ترتيب الوسيطات إلا إذا كنت على معرفة بحاويات docker.
  • إذا كنت تستخدم نظام تشغيل مختلفا، فاستخدم وحدة التحكم/المحطة الطرفية الصحيحة، وبناء جملة المجلد للحوامل، وحرف استمرار الخط لنظامك. تفترض هذه الأمثلة وحدة تحكم Windows مع حرف ^استمرار سطر . نظرًا لأن الحاوية هي نظام تشغيل Linux، يستخدم التحميل الهدف بناء جملة مجلد على غرار Linux.

هذا الأمر:

  • يشغل حاوية من صورة حاوية LUIS
  • تحميل تطبيق LUIS من حامل الإدخال في C:\input، الموجود على مضيف الحاوية
  • يخصص ذاكرتين أساسيتين من وحدات المعالجة المركزية و4 غيغابايت (GB) من الذاكرة
  • يعرض منفذ TCP 5000 وتخصيص TTY زائف للحاوية
  • يحفظ الحاوية وسجلات LUIS إلى حامل الإخراج في C:\output ، الموجود على مضيف الحاوية
  • يزيل الحاوية تلقائياً بعد إنهائها. صورة الحاوية لا تزال متوفرة على الكمبيوتر المضيف.

تتوفر المزيد من الأمثلة علىdocker run الأمر.

هام

تُحدد الخياراتEula وBillingApiKey لتشغيل الحاوية؛ وإلا فلن يتم تشغيل الحاوية. لمزيد من المعلومات، راجع الفوترة. قيمة ApiKey هي المفتاح من صفحة موارد Azure في مدخل LUIS وتتوفر أيضا في صفحة مفاتيح موارد AzureCognitive Services.

تشغيل حاويات متعددة على نفس المضيف

إذا كنت تنوي تشغيل حاويات متعددة مع منافذ مكشوفة، فتأكد من تشغيل كل حاوية بمنفذ مكشوف مختلف. على سبيل المثال، قم بتشغيل الحاوية الأولى على المنفذ 5000 والحاوية الثانية على المنفذ 5001.

يمكنك تشغيل هذه الحاوية وحاوية Azure Cognitive Services مختلفة على المضيف معا. يمكنك أيضا تشغيل حاويات متعددة من نفس حاوية الخدمات المعرفية.

واجهات برمجة تطبيقات نقطة النهاية التي تدعمها الحاوية

يتوفر كل من إصدارات V2 و V3 من واجهة برمجة التطبيقات مع الحاوية.

الاستعلام عن نقطة نهاية التنبؤ بالحاوية

توفر الحاوية واجهات برمجة التطبيقات لنقاط نهاية توقّع الاستعلام المستند إلى REST. نقاط النهاية للتطبيقات المنشورة (التدريج أو الإنتاج) لها مسار مختلف عن نقاط النهاية للتطبيقات التي تم إصدارها.

استخدم المضيف http://localhost:5000، لواجهات برمجة تطبيقات الحاوية.

نوع الحزمة فعل HTTP المسار معلمات الاستعلام
تم النشر الحصول على ، آخر /luis/v3.0/apps/{appId}/slots/{slotName}/predict? query={query}
[&verbose]
[&log]
[&show-all-intents]
تم إصداره الحصول على ، آخر /luis/v3.0/apps/{appId}/versions/{versionId}/predict? query={query}
[&verbose]
[&log]
[&show-all-intents]

تقوم معلمات الاستعلام بتكوين كيفية وماذا يتم إرجاعه في استجابة الاستعلام:

معلمة الاستعلام النوع الغرض
query سلسلة كلام المستخدم.
verbose منطقي قيمة منطقية تشير إلى ما إذا كان سيتم إرجاع جميع البيانات الوصفية للنماذج المتوقعة. الوضع الافتراضي خطأ.
log منطقي سجلات الاستعلامات، والتي يمكن استخدامها لاحقا للتعلم النشط. الوضع الافتراضي خطأ.
show-all-intents منطقي قيمة منطقية تشير إلى ما إذا كان سيتم إرجاع جميع المقاصد أو نية تسجيل النقاط العليا فقط. الوضع الافتراضي خطأ.

الاستعلام عن تطبيق LUIS

مثال على أمر CURL للاستعلام عن الحاوية لتطبيق منشور هو:

للاستعلام عن نموذج في فتحة، استخدم واجهة برمجة التطبيقات التالية:

curl -G \
-d verbose=false \
-d log=true \
--data-urlencode "query=turn the lights on" \
"http://localhost:5000/luis/v3.0/apps/{APP_ID}/slots/production/predict"

لإجراء استعلامات إلى بيئة التدريج ، استبدل production في المسار بما يلي staging:

http://localhost:5000/luis/v3.0/apps/{APP_ID}/slots/staging/predict

للاستعلام عن نموذج تم إصداره، استخدم واجهة برمجة التطبيقات التالية:

curl -G \
-d verbose=false \
-d log=false \
--data-urlencode "query=turn the lights on" \
"http://localhost:5000/luis/v3.0/apps/{APP_ID}/versions/{APP_VERSION}/predict"

استيراد سجلات نقطة النهاية للتعلم النشط

إذا تم تحديد حامل إخراج لحاوية LUIS، حفظ ملفات سجل استعلام التطبيق في دليل الإخراج، حيث {INSTANCE_ID} يوجد معرف الحاوية. يحتوي سجل استعلام التطبيق على الاستعلام والاستجابة والطوابع الزمنية لكل استعلام تنبؤ تم إرساله إلى حاوية LUIS.

يعرض الموقع التالي بنية الدليل المتداخلة لملفات سجل الحاوية.

/output/luis/{INSTANCE_ID}/

من مدخل LUIS، حدد تطبيقك، ثم حدد استيراد سجلات نقاط النهاية لتحميل هذه السجلات.

Import container's log files for active learning

بعد تحميل السجل، راجع نطق نقطة النهاية في مدخل LUIS.

التحقق من تشغيل حاوية

هناك عدة طرق للتحقق من أن الحاوية قيد التشغيل. حدد موقع عنوان IP الخارجي والمنفذ المكشوف للحاوية المعنية، وافتح متصفح الويب المفضل لديك. استخدم عناوين URL المختلفة للطلبات التالية للتحقق من صحة تشغيل الحاوية. أمثلة عناوين URL للطلبات المدرجة هنا هي http://localhost:5000، ولكن قد تختلف الحاوية المحددة. تأكد من الاعتماد على عنوان IP الخارجي للحاوية والمنفذ المكشوف.

URL للطلب الغرض
http://localhost:5000/ توفر الحاوية صفحةً رئيسيةً.
http://localhost:5000/ready يوفر عنوان URL هذا، المطلوب باستخدام GET، التحقق من أن الحاوية جاهزة لقبول استعلام مقابل النموذج. يمكن استخدام هذا الطلب لتحقيقات Kubernetes للأحياء والاستعداد.
http://localhost:5000/status يتحقق عنوان URL هذا المطلوب أيضا مع GET مما إذا كان مفتاح واجهة برمجة التطبيقات المستخدم لبدء تشغيل الحاوية صالحا دون التسبب في استعلام نقطة نهاية. يمكن استخدام هذا الطلب لتحقيقات Kubernetes للأحياء والاستعداد.
http://localhost:5000/swagger توفر الحاوية مجموعةً كاملةً من الوثائق لنقاط النهاية وميزة Try it out. باستخدام هذه الميزة ، يمكنك إدخال إعداداتك في نموذج HTML مستند إلى الويب وإجراء الاستعلام دون الحاجة إلى كتابة أي رمز. بعد إرجاع الاستعلام، يتم توفير مثال لأمر CURL لإظهار رؤوس HTTP وتنسيق النص الأساسي المطلوب.

Container's home page

إيقاف الحاوية

لإيقاف تشغيل الحاوية، في بيئة سطر الأوامر حيث يتم تشغيل الحاوية، اضغط على Ctrl+C.

استكشاف الأخطاء وإصلاحها

إذا قمت بتشغيل الحاوية مع تمكين تحميل الإخراج والتسجيل، تقوم الحاوية بإنشاء ملفات سجل مفيدة لاستكشاف المشكلات التي تحدث أثناء بدء تشغيل الحاوية أو تشغيلها.

تلميح

لمزيد من المعلومات والإرشادات حول استكشاف الأخطاء وإصلاحها، راجع الأسئلة المتداولة حول حاويات الخدمات المعرفية (FAQ).

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

للحصول على الحاوية، استخدم الأمر التالي docker pull :

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

ثم قم بتشغيل الحاوية. استبدل {ENDPOINT_URI} بنقطة النهاية، واستبدلها {API_KEY} بمفتاح المورد:

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

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

الفوترة

ترسل حاوية LUIS معلومات الفوترة إلى Azure، باستخدام مورد الخدمات المعرفية على حساب Azure الخاص بك.

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

حاويات Azure Cognitive Services غير مرخصة للتشغيل دون الاتصال بنقطة نهاية القياس أو الفوترة. يجب تمكين الحاويات من توصيل معلومات الفوترة بنقطة نهاية الفوترة في جميع الأوقات. لا ترسل حاويات الخدمات المعرفية بيانات العملاء، مثل الصورة أو النص الذي يتم تحليله، إلى Microsoft.

قم بالاتصال بـ Azure

تحتاج الحاوية إلى قيم وسيطة الفوترة لتشغيلها. تسمح هذه القيم للحاوية بالاتصال بنقطة نهاية الفوترة. تقوم الحاوية بالإبلاغ عن الاستخدام كل 10 إلى 15 دقيقة تقريبا. إذا لم تتصل الحاوية ب Azure خلال الإطار الزمني المسموح به، فستستمر الحاوية في العمل ولكنها لا تعرض الاستعلامات حتى تتم استعادة نقطة نهاية الفوترة. تتم محاولة الاتصال 10 مرات في نفس الفاصل الزمني من 10 إلى 15 دقيقة. إذا تعذر عليها الاتصال بنقطة نهاية الفوترة خلال 10 محاولات، فستتوقف الحاوية عن عرض الطلبات. راجع الأسئلة المتداولة حول حاوية الخدمات المعرفية للحصول على مثال على المعلومات المرسلة إلى Microsoft للفوترة.

وسيطات الفوترة

docker run سيبدأ الأمر الحاوية عند توفير جميع الخيارات الثلاثة التالية بقيم صالحة:

الخيار الوصف
ApiKey مفتاح واجهة برمجة التطبيقات لمورد الخدمات المعرفية المستخدم لتعقب معلومات الفوترة.
يجب تعيين قيمة هذا الخيار إلى مفتاح API للمورد الموفر المحدد في Billing.
Billing نقطة نهاية مورد الخدمات المعرفية المستخدم لتعقب معلومات الفوترة.
يجب تعيين قيمة هذا الخيار إلى URI نقطة النهاية لمورد Azure مزود.
Eula يشير إلى أنك قبلت ترخيص الحاوية.
يجب تعيين قيمة هذا الخيار لقبول.

لمزيد من المعلومات حول هذه الخيارات، راجع تكوين الحاويات.

الملخص

في هذه المقالة، تعلمت المفاهيم وسير العمل لتنزيل حاويات فهم اللغة (LUIS) وتثبيتها وتشغيلها. وخلاصة القول:

  • يوفر فهم اللغة (LUIS) حاوية Linux واحدة ل Docker توفر تنبؤات استعلام نقطة النهاية للكلمات.
  • يتم تنزيل صور الحاوية من سجل حاويات Microsoft (MCR).
  • يتم تشغيل صور الحاوية في Docker.
  • يمكنك استخدام واجهة برمجة تطبيقات REST للاستعلام عن نقاط نهاية الحاوية عن طريق تحديد عنوان URI المضيف للحاوية.
  • يجب عليك تحديد معلومات الفوترة عند إنشاء حاوية.

هام

حاويات الخدمات المعرفية غير مرخصة للعمل دون أن تُوصل بـ Azure للقياس. يحتاج العملاء إلى تمكين الحاويات من توصيل معلومات الفوترة مع خدمة القياس في جميع الأوقات. لا ترسل حاويات الخدمات المعرفية بيانات العميل (على سبيل المثال، الصورة أو النص الذي يتم تحليله) إلى Microsoft.

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