تثبيت حاويات Docker وتشغيلها من أجل LUIS
هام
سيتم إيقاف LUIS في 1 أكتوبر 2025 وبدءا من 1 أبريل 2023، لن تتمكن من إنشاء موارد LUIS جديدة. نوصي بترحيل تطبيقات LUIS الخاصة بك إلى فهم لغة المحادثة للاستفادة من دعم المنتج المستمر والقدرات متعددة اللغات.
إشعار
تم تغيير موقع صورة الحاوية مؤخراً. اقرأ هذه المقالة للاطلاع على الموقع المحدث لهذه الحاوية.
تمكنك الحاويات من استخدام LUIS في بيئتك الخاصة. وتعد الحاويات رائعة لمتطلبات الأمان وإدارة البيانات المحددة. ستتعلم في هذه المقالة كيفية تنزيل حاوية LUIS وتثبيتها وتشغيلها.
يتم من خلال حاوية Language Understanding (LUIS) تحميل نموذج Language Understanding المدرب أو نشره. كتطبيق LUIS، توفر حاوية docker إمكانية الوصول إلى توقعات الاستعلام من نقاط نهاية API للحاوية. يمكنك جمع سجلات الاستعلام من الحاوية وإعادة تحميلها إلى تطبيق Language Understanding لتحسين دقة التنبؤ بالتطبيق.
يوضح الفيديو التالي استخدام هذه الحاوية.
في حال لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانيّاً قبل البدء.
المتطلبات الأساسية
لتشغيل حاوية LUIS، لاحظ المتطلبات الأساسية التالية:
- تثبيت Docker على كمبيوتر مضيف. يجب تكوين Docker للسماح للحاويات بالاتصال وإرسال بيانات الفواتير إلى Azure.
- في Windows، يجب أيضًا تكوين Docker لدعم حاويات Linux.
- يجب أن يكون لديك فهم أساسي لمفاهيم Docker.
- مورد LUIS مع مستوى التسعير المجاني (F0) أو القياسي (S).
- تطبيق مدرب أو منشور تم حزمه كإدخال مثبت إلى الحاوية باستخدام معرف التطبيق المرتبط به. يمكنك الحصول على الملف المحزم من مدخل LUIS أو واجهات برمجة تطبيقات التأليف. إذا كنت تحصل على تطبيق LUIS المحزم من واجهات برمجة تطبيقات التأليف، فستحتاج أيضاً إلى مفتاح التأليف الخاص بك.
جمع المعلمات المطلوبة
مطلوب ثلاث معلمات أساسية لجميع حاويات Azure الذكاء الاصطناعي. يجب أن تكون شروط ترخيص برامج Microsoft موجودة بقيمة accept. هناك حاجة أيضاً إلى مفتاح URI وAPI لنقطة النهاية.
نقطة النهاية URI
{ENDPOINT_URI} تتوفر القيمة في صفحة نظرة عامة على مدخل Microsoft Azure لمورد خدمات Azure الذكاء الاصطناعي المقابل. انتقل إلى صفحة Overview، ومرر مؤشر الماوس فوق نقطة النهاية، وستظهر أيقونة نسخ إلى الحافظة. انسخ واستخدم نقطة النهاية عند الحاجة.
المفاتيح
{API_KEY} يتم استخدام القيمة لبدء الحاوية وهي متوفرة في صفحة مفاتيح مدخل Microsoft Azure لمورد خدمات Azure الذكاء الاصطناعي المقابل. انتقل إلى صفحة Keys وحدد الأيقونة Copy to clipboard.
هام
يتم استخدام مفاتيح الاشتراك هذه للوصول إلى واجهة برمجة تطبيقات خدمات Azure الذكاء الاصطناعي. لا تشارك مفاتيحك. قم بتخزينها بشكل آمن. على سبيل المثال، استخدم Azure Key Vault. نوصي أيضاً بإعادة إنشاء هذه المفاتيح بانتظام. مفتاح واحد فقط ضروري لإجراء استدعاء واجهة برمجة التطبيقات. عند إعادة إنشاء المفتاح الأول، يمكنك استخدام المفتاح الثاني للوصول المستمر إلى الخدمة.
معرف التطبيق {APP_ID}
يتم استخدام هذا المعرف لتحديد التطبيق. يمكنك العثور على معرف التطبيق في مدخل LUIS بالنقر فوق إدارة في أعلى الشاشة لتطبيقك، ثم الإعدادات.
مفتاح التأليف {AUTHORING_KEY}
يستخدم هذا المفتاح للحصول على التطبيق المحزم من خدمة LUIS في السحابة وتحميل سجلات الاستعلام مرة أخرى إلى السحابة. ستحتاج إلى مفتاح التأليف الخاص بك إذا قمت بتصدير تطبيقك باستخدام واجهة برمجة تطبيقات REST، الموضحة لاحقاً في المقالة.
يمكنك الحصول على مفتاح التأليف الخاص بك من مدخل LUIS بالنقر فوق إدارة في أعلى الشاشة لتطبيقك، ثم موارد Azure.
تأليف واجهات برمجة التطبيقات لملف الحزمة
تأليف واجهات برمجة التطبيقات للتطبيقات المحزمة:
الكمبيوتر المضيف
المضيف هو كمبيوتر يعمل بإصدار x64 يقوم بتشغيل حاوية Docker. وقد يكون هذا أحد أجهزة الكمبيوتر الموجودة في موقعك أو خدمة استضافة Docker في Azure، مثل:
- خدمة Azure Kubernetes.
- Azure Container Instances.
- تم توزيع مجموعة Kubernetes في Azure Stack. لمزيد من المعلومات، يرجى مراجعة نشر Kubernetes في Azure Stack.
متطلبات الحاوية وتوصياتها
يسرد الجدول أدناه القيم الدنيا والموصى بها لمضيف الحاوية. قد تتغير متطلباتك اعتماداً على حجم حركة المرور.
| الحاوية | الحد الأدنى | مستحسن | TPS (الحد الأدنى، الحد الأقصى) |
|---|---|---|---|
| LUIS | نواة واحدة، ذاكرة 2 جيجابايت | نواة واحدة، ذاكرة 4 جيجابايت | 20، 40 |
- يجب أن يكون كل نواة 2.6 غيغاهيرتز على الأقل (غيغاهرتز) أو أسرع.
- TPS - المعاملات في الثانية
تتوافق النواة والذاكرة مع إعدادات --cpus و--memory، والتي يتم استخدامها كجزء من الأمر docker run.
أحصل على صورة الحاوية باستخدام docker pull
يمكن العثور على صورة حاوية LUIS في نقابة سجل الحاوية mcr.microsoft.com . موجودة داخل المستودع azure-cognitive-services/language ويطلق عليها اسم luis. اسم نسخة الحاوية المؤهل بالكامل هو mcr.microsoft.com/azure-cognitive-services/language/luis.
لاستخدام أحدث إصدار من الحاوية، يمكنك استخدام العلامة latest . يمكنك أيضاً العثور على قائمة كاملة من العلامات على MCR.
استخدم الأمر 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 لسرد صور الحاوية التي تم تنزيلها. على سبيل المثال، يسرد الأمر التالي المعرف والمستودع والعلامة لكل صورة حاوية تم تنزيلها، منسقة كجدول:
docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"
IMAGE ID REPOSITORY TAG
<image-id> <repository-path/name> <tag-name>
كيفية استخدام الحاوية
بمجرد وجود الحاوية على الكمبيوتر المضيف، استخدم العملية التالية للعمل بالحاوية.
- تصدير حزمة للحاوية من مدخل LUIS أو واجهات برمجة تطبيقات LUIS.
- نقل ملف الحزمة إلى دليل الإدخال المطلوب على الكمبيوتر المضيف. لا تقم بإعادة تسمية ملف حزمة LUIS أو تغييره أو الكتابة فوقه أو إلغاء ضغطه.
- قم بتشغيل الحاوية، مع إعدادات تحميل الإدخال والفوترة المطلوبة. تتوفر المزيد من الأمثلة على الأمر
docker run. - الاستعلام عن نقطة نهاية التنبؤ للحاوية.
- عند الانتهاء من الحاوية، قم باستيراد سجلات نقطة النهاية من تحميل الإخراج في مدخل LUIS وإيقاف الحاوية.
- استخدم التعلم النشط لمدخل LUIS في صفحة مراجعة تعبيرات نقطة النهاية لتحسين التطبيق.
لا يمكن تغيير التطبيق الذي يعمل في الحاوية. لتغيير التطبيق في الحاوية، تحتاج إلى تغيير التطبيق في خدمة LUIS باستخدام مدخل LUIS أو استخدام واجهات برمجة تطبيقات التأليف LUIS. ثم قم بتدريب و/أو نشر، ثم قم بتنزيل حزمة جديدة وتشغيل الحاوية مرة أخرى.
لا يمكن تصدير تطبيق LUIS داخل الحاوية مرة أخرى إلى خدمة LUIS. يمكن تحميل سجلات الاستعلام فقط.
تصدير التطبيق المحزم من LUIS
تتطلب حاوية LUIS تطبيق LUIS مدرباً أو منشوراً للإجابة عن استعلامات التنبؤ لتعبيرات المستخدم. للحصول على تطبيق LUIS، استخدم إما واجهة برمجة تطبيقات الحزمة المدربة أو المنشورة.
الموقع الافتراضي هو الدليل الفرعي input فيما يتعلق بمكان تشغيل الأمر docker run.
ضع ملف الحزمة في دليل وقم بالإشارة إلى هذا الدليل كتحميل إدخال عند تشغيل حاوية docker.
أنواع الحزم
يمكن أن يحتوي دليل تحميل الإدخال على نماذجالإنتاج و التقسيم المرحلي و إصدار التطبيق في وقت واحد. يتم تحميل جميع الحزم.
| نوع الحزمة | واجهة برمجة تطبيقات نقطة نهاية الاستعلام | توفر الاستعلام | تنسيق اسم ملف الحزمة |
|---|---|---|---|
| تم إصداره | GET، POST | حاوية فقط | {APP_ID}_v{APP_VERSION}.gz |
| التدريج | GET، POST | Azure والحاوية | {APP_ID}_STAGING.gz |
| الإنتاج | GET، POST | Azure والحاوية | {APP_ID}_PRODUCTION.gz |
هام
لا تقم بإعادة تسمية ملفات حزمة LUIS أو تغييرها أو الكتابة فوقها أو إلغاء ضغطها.
المتطلبات الأساسية للتحزيم
قبل حزم تطبيق LUIS، يجب أن يكون لديك ما يلي:
| متطلبات التحزيم | التفاصيل |
|---|---|
| مثيل مورد خدمات Azure azure الذكاء الاصطناعي | تشمل المناطق المدعومة غرب الولايات المتحدة ( westus)غرب أوروبا ( westeurope)شرق أستراليا ( australiaeast) |
| تطبيق LUIS مدرب أو منشور | بدون تبعيات غير معتمدة. |
| الوصول إلى نظام ملفات الكمبيوتر المضيف | يجب أن يسمح الكمبيوتر المضيف بتحميل إدخال. |
تصدير حزمة التطبيق من مدخل LUIS
يوفر مدخل LUIS القدرة على تصدير حزمة التطبيق المدرب أو المنشور.
تصدير حزمة التطبيق المنشور من مدخل LUIS
تتوفر حزمة التطبيق المنشور من صفحة قائمة تطبيقاتي.
- قم بتسجيل الدخول إلى مدخل LUIS.
- حدد خانة الاختيار إلى يسار اسم التطبيق في القائمة.
- حدد العنصر تصدير من شريط الأدوات السياقي أعلى القائمة.
- حدد تصدير للحاوية (GZIP).
- حدد بيئة فتحة الإنتاج أو فتحة التقسيم المرحلي.
- يتم تنزيل الحزمة من المتصفح.
تصدير حزمة التطبيق التي تم إصدارها من مدخل LUIS
تتوفر حزمة التطبيق التي تم إصدارها من صفحة قائمة الإصدارات.
- قم بتسجيل الدخول إلى مدخل LUIS.
- حدد التطبيق في القائمة.
- حدد إدارة في شريط التنقل للتطبيق.
- حدد الإصدارات في شريط التنقل الأيسر.
- حدد خانة الاختيار إلى يسار اسم الإصدار في القائمة.
- حدد العنصر تصدير من شريط الأدوات السياقي أعلى القائمة.
- حدد تصدير للحاوية (GZIP).
- يتم تنزيل الحزمة من المتصفح.
تصدير حزمة التطبيق المنشور من واجهة برمجة التطبيقات
استخدم أسلوب واجهة برمجة تطبيقات REST التالي، لحزم تطبيق LUIS الذي قمت بنشره بالفعل. استبدال القيم المناسبة الخاصة بك للعناصر النائبة في استدعاء API، باستخدام الجدول أسفل مواصفات 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}
| Placeholder | القيمة |
|---|---|
| {APP_ID} | معرف التطبيق لتطبيق LUIS المنشور. |
| {SLOT_NAME} | بيئة تطبيق LUIS المنشور. استخدم إحدى القيم التالية:PRODUCTIONSTAGING |
| {AUTHORING_KEY} | مفتاح التأليف لحساب LUIS لتطبيق LUIS المنشور. يمكنك الحصول على مفتاح التأليف الخاص بك من صفحة إعدادات المستخدم على مدخل LUIS. |
| {AZURE_REGION} | منطقة Azure المناسبة:westus - غرب الولايات المتحدةwesteurope - غرب أوروباaustraliaeast - شرق أستراليا |
لتنزيل الحزمة المنشورة، راجع وثائق واجهة برمجة التطبيقات هنا. إذا تم تنزيلها بنجاح، فإن الاستجابة هي ملف حزمة LUIS. احفظ الملف في موقع التخزين المحدد لتحميل إدخال الحاوية.
تصدير حزمة التطبيق الذي تم إصداره من واجهة برمجة التطبيقات
استخدم أسلوب واجهة برمجة تطبيقات REST التالي، لحزم تطبيق LUIS الذي قمت بتدريبه بالفعل. استبدال القيم المناسبة الخاصة بك للعناصر النائبة في استدعاء API، باستخدام الجدول أسفل مواصفات 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}
| Placeholder | القيمة |
|---|---|
| {APP_ID} | معرف التطبيق لتطبيق LUIS المدرب. |
| {APP_VERSION} | إصدار التطبيق من تطبيق LUIS المدرب. |
| {AUTHORING_KEY} | مفتاح التأليف لحساب LUIS لتطبيق LUIS المنشور. يمكنك الحصول على مفتاح التأليف الخاص بك من صفحة إعدادات المستخدم على مدخل LUIS. |
| {AZURE_REGION} | منطقة Azure المناسبة:westus - غرب الولايات المتحدةwesteurope - غرب أوروباaustraliaeast - شرق أستراليا |
لتنزيل الحزمة التي تم إصدارها، راجع وثائق واجهة برمجة التطبيقات هنا. إذا تم تنزيلها بنجاح، فإن الاستجابة هي ملف حزمة LUIS. احفظ الملف في موقع التخزين المحدد لتحميل إدخال الحاوية.
قم بتشغيل الحاوية باستخدام docker run
استخدم الأمر 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. - تجنب بتغيير ترتيب الوسيطات إلا إذا كنت على معرفة بحاويات docker.
- إذا كنت تستخدم نظام تشغيل مختلف، استخدم وحدة التحكم/المحطة الطرفية الصحيحة، وبناء جملة المجلد للتحميلات، وحرف متابعة السطر للنظام الخاص بك. تفترض هذه الأمثلة وحدة تحكم Windows بحرف
^لمتابعة السطر. نظرًا لأن الحاوية هي نظام تشغيل Linux، يستخدم التحميل الهدف بناء جملة مجلد على غرار Linux.
هذا الأمر:
- يشغل حاوية من صورة حاوية LUIS
- يحمل التطبيق LUIS من تحميل الإدخال في C:\input، الموجود على مضيف الحاوية
- يخصص ذاكرتين أساسيتين من وحدات المعالجة المركزية و4 غيغابايت (GB) من الذاكرة
- يعرض منفذ TCP 5000 وتخصيص TTY زائف للحاوية
- يحفظ الحاوية وسجلات LUIS إلى تحميل الإخراج في C:\output، الموجود على مضيف الحاوية
- يزيل الحاوية تلقائياً بعد إنهائها. صورة الحاوية لا تزال متوفرة على الكمبيوتر المضيف.
تتوفر المزيد من الأمثلة على الأمر docker run.
هام
تُحدد الخياراتEula وBillingApiKey لتشغيل الحاوية؛ وإلا فلن يتم تشغيل الحاوية. لمزيد من المعلومات، انظرالفواتير.
قيمة ApiKey هي المفتاح من صفحة موارد Azure في مدخل LUIS وتتوفر أيضاً في صفحة مفاتيح موارد Azure Azure AI services.
تشغيل حاويات متعددة على نفس المضيف
إذا كنت تنوي تشغيل عدة حاويات ذات منافذ مكشوفة، فتأكد من تشغيل كل حاوية بمنفذ مكشوف مختلف. على سبيل المثال، قم بتشغيل الحاوية الأولى على المنفذ 5000 والحاوية الثانية على المنفذ 5001.
يمكن أن يكون لديك هذه الحاوية وحاوية خدمات Azure الذكاء الاصطناعي مختلفة تعمل على HOST معا. يمكنك أيضا أن يكون لديك حاويات متعددة من نفس حاوية خدمات Azure الذكاء الاصطناعي قيد التشغيل.
واجهات برمجة التطبيقات لنقطة النهاية المدعومة من الحاوية
يتوفر كل من الإصدارين V2 و V3 من واجهة برمجة التطبيقات مع الحاوية.
الاستعلام عن نقطة نهاية التوقع للحاوية
توفر الحاوية واجهات برمجة التطبيقات لنقاط نهاية توقّع الاستعلام المستند إلى REST. نقاط النهاية للتطبيقات المنشورة (التقسيم المرحلي أو الإنتاج) لها مسار مختلف عن نقاط النهاية للتطبيقات التي تم إصدارها.
استخدم المضيف http://localhost:5000، لواجهات برمجة تطبيقات الحاوية.
| نوع الحزمة | فعل HTTP | المسار | معلمات الاستعلام |
|---|---|---|---|
| تم النشر | GET، POST | /luis/v3.0/apps/{appId}/slots/{slotName}/predict? /luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict? |
query={query}[ &verbose][ &log][ &show-all-intents] |
| تم إصداره | GET، POST | /luis/v3.0/apps/{appId}/versions/{versionId}/predict? /luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict |
query={query}[ &verbose][ &log][ &show-all-intents] |
تقوم معلمات الاستعلام بتكوين كيفية وما يتم إرجاعه في استجابة الاستعلام:
| معلمة الاستعلام | النوع | الاستخدام |
|---|---|---|
query |
سلسلة | تعبير المستخدم. |
verbose |
boolean | قيمة منطقية تشير إلى ما إذا كان سيتم إرجاع جميع بيانات التعريف للنماذج المتوقعة. الافتراضي خطأ. |
log |
boolean | سجلات الاستعلامات، والتي يمكن استخدامها لاحقاً للتعلم النشط. الافتراضي خطأ. |
show-all-intents |
boolean | قيمة منطقية تشير إلى ما إذا كان سيتم إرجاع جميع الأهداف أو هدف التسجيل الأعلى فقط. الافتراضي خطأ. |
الاستعلام عن تطبيق 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، حدد تطبيقك، ثم حدد استيراد سجلات نقطة النهاية لتحميل هذه السجلات.
بعد تحميل السجل، راجع تعبيرات نقطة النهاية في مدخل LUIS.
تحقق من أن الحاوية قيد التشغيل
هناك عدة طرق للتحقق من أن الحاوية قيد التشغيل. حدد موقع عنوان External IP والمنفذ المكشوف للحاوية المعنية، وافتح متصفح الويب المفضل لديك. استخدم عناوين URL المختلفة للطلبات التالية للتحقق من تشغيل الحاوية. أمثلة عناوين URL للطلبات المدرجة هنا هي http://localhost:5000، ولكن قد تختلف الحاوية الخاصة بك. تأكد من الاعتماد على عنوان External IP والمنفذ المكشوف للحاوية الخاصة بك.
| URL للطلب | الغرض |
|---|---|
http://localhost:5000/ |
توفر الحاوية صفحةً رئيسيةً. |
http://localhost:5000/ready |
تم طلبه بواسطة GET، يوفر عنوان URL هذا التحقق من أن الحاوية جاهزة لقبول استعلام مقابل النموذج. يمكن استخدام هذا الطلب لـ Kubernetes تحقيقات الاستعداد والجاهزية. |
http://localhost:5000/status |
مطلوب أيضاً مع GET، أن يتحقق عنوان URL هذا مما إذا كان مفتاح api المستخدم لبدء الحاوية صالحاً دون التسبب في استعلام نقطة النهاية. يمكن استخدام هذا الطلب لـ Kubernetes تحقيقات الاستعداد والجاهزية. |
http://localhost:5000/swagger |
توفر الحاوية مجموعةً كاملةً من الوثائق لنقاط النهاية وميزة Try it out. باستخدام هذه الميزة، يمكنك إدخال إعداداتك في نموذج HTML مستند إلى الويب وإجراء الاستعلام بدون الحاجة إلى كتابة أية تعليمة برمجية. بعد عودة الاستعلام، يتم توفير مثال على أمر Curl لإظهار عناوين HTTP وتنسيق الجسم المطلوب. |
تشغيل الحاوية غير المتصلة بالإنترنت
لاستخدام هذه الحاوية غير المتصلة بالإنترنت، يجب عليك أولا طلب الوصول عن طريق ملء أحد التطبيقات وشراء خطة التزام. راجع استخدام حاويات Docker في بيئات غير متصلة للحصول على مزيد من المعلومات.
إذا تمت الموافقة على تشغيل الحاوية غير المتصلة بالإنترنت، فاستخدم المثال التالي يوضح تنسيق الأمر الذي docker run ستستخدمه، مع قيم العنصر النائب. استبدل قيم العناصر النائبة هذه بقيمك الخاصة.
DownloadLicense=True ستقوم المعلمة في الأمر بتنزيل docker run ملف ترخيص سيمكن حاوية Docker من التشغيل عندما لا تكون متصلة بالإنترنت. يحتوي أيضا على تاريخ انتهاء صلاحية، وبعد ذلك سيكون ملف الترخيص غير صالح لتشغيل الحاوية. يمكنك فقط استخدام ملف ترخيص مع الحاوية المناسبة التي تمت الموافقة عليها. على سبيل المثال، لا يمكنك استخدام ملف ترخيص لحاوية تحويل الكلام إلى نص مع حاوية Document Intelligence.
| Placeholder | القيمة | شكل أو مثال |
|---|---|---|
{IMAGE} |
صورة الحاوية التي تريد استخدامها. | mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice |
{LICENSE_MOUNT} |
المسار حيث سيتم تنزيل الترخيص وتثبيته. | /host/license:/path/to/license/directory |
{ENDPOINT_URI} |
نقطة النهاية للمصادقة على طلب واجهة برمجة التطبيقات. يمكنك العثور عليه في صفحة المفتاح ونقطة النهاية الخاصة بموردك، على مدخل Microsoft Azure. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{API_KEY} |
مفتاح مورد Text Analytics. يمكنك العثور عليه في صفحة المفتاح ونقطة النهاية الخاصة بموردك، على مدخل Microsoft Azure. | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
{CONTAINER_LICENSE_DIRECTORY} |
موقع مجلد الترخيص على نظام الملفات المحلي للحاوية. | /path/to/license/directory |
docker run --rm -it -p 5000:5000 \
-v {LICENSE_MOUNT} \
{IMAGE} \
eula=accept \
billing={ENDPOINT_URI} \
apikey={API_KEY} \
DownloadLicense=True \
Mounts:License={CONTAINER_LICENSE_DIRECTORY}
بمجرد تنزيل ملف الترخيص، يمكنك تشغيل الحاوية في بيئة غير متصلة. يوضح المثال التالي تنسيق الأمر docker run الذي ستستخدمه، مع قيم العناصر النائبة. استبدل قيم العناصر النائبة هذه بقيمك الخاصة.
أينما يتم تشغيل الحاوية، يجب تحميل ملف الترخيص إلى الحاوية ويجب تحديد موقع مجلد الترخيص على نظام الملفات المحلي للحاوية باستخدام Mounts:License=. يجب أيضا تحديد تحميل الإخراج بحيث يمكن كتابة سجلات استخدام الفوترة.
| Placeholder | القيمة | شكل أو مثال |
|---|---|---|
{IMAGE} |
صورة الحاوية التي تريد استخدامها. | mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice |
{MEMORY_SIZE} |
الحجم المناسب للذاكرة لتخصيصها للحاوية الخاصة بك. | 4g |
{NUMBER_CPUS} |
العدد المناسب من وحدات المعالجة المركزية لتخصيصها للحاوية الخاصة بك. | 4 |
{LICENSE_MOUNT} |
المسار حيث سيتم تحديد موقع الترخيص وتثبيته. | /host/license:/path/to/license/directory |
{OUTPUT_PATH} |
مسار الإخراج لتسجيل سجلات الاستخدام. | /host/output:/path/to/output/directory |
{CONTAINER_LICENSE_DIRECTORY} |
موقع مجلد الترخيص على نظام الملفات المحلي للحاوية. | /path/to/license/directory |
{CONTAINER_OUTPUT_DIRECTORY} |
موقع مجلد الإخراج على نظام الملفات المحلي للحاوية. | /path/to/output/directory |
docker run --rm -it -p 5000:5000 --memory {MEMORY_SIZE} --cpus {NUMBER_CPUS} \
-v {LICENSE_MOUNT} \
-v {OUTPUT_PATH} \
{IMAGE} \
eula=accept \
Mounts:License={CONTAINER_LICENSE_DIRECTORY}
Mounts:Output={CONTAINER_OUTPUT_DIRECTORY}
إيقاف الحاوية
لإيقاف تشغيل الحاوية، في بيئة سطر الأوامر حيث يتم تشغيل الحاوية، اضغط على Ctrl+C.
استكشاف الأخطاء وإصلاحها
إذا قمت بتشغيل الحاوية مع تحميل ناتج وتمكين التسجيل، فإن الحاوية تنشئ ملفات سجل تساعد في استكشاف المشكلات التي تحدث أثناء بدء الحاوية أو تشغيلها وإصلاحها.
تلميح
لمزيد من المعلومات والإرشادات حول استكشاف الأخطاء وإصلاحها، راجع حاويات Azure الذكاء الاصطناعي الأسئلة المتداولة (FAQ).
إذا كنت تواجه مشكلة في تشغيل حاوية خدمات Azure الذكاء الاصطناعي، يمكنك محاولة استخدام حاوية تشخيص Microsoft. استخدم هذه الحاوية لتشخيص الأخطاء الشائعة في بيئة التوزيع التي قد تمنع حاويات Azure الذكاء الاصطناعي من العمل كما هو متوقع.
للحصول على الحاوية، استخدم الأمر 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 الخاص بك.
تتم فوترة الاستعلامات إلى الحاوية في طبقة الأسعار لمورد Azure المستخدم للمعلمة ApiKey.
لا يتم ترخيص حاويات خدمات Azure الذكاء الاصطناعي للتشغيل دون الاتصال بنقطة نهاية القياس أو الفوترة. يجب تمكين الحاويات لتوصيل معلومات الفوترة بنقطة نهاية الفوترة في جميع الأوقات. لا ترسل حاويات خدمات Azure الذكاء الاصطناعي بيانات العملاء، مثل الصورة أو النص الذي يتم تحليله، إلى Microsoft.
قم بالاتصال بـ Azure
تحتاج الحاوية إلى قيم وسيطة للفوترة لتشغيلها. تسمح هذه القيم للحاوية بالاتصال بنقطة نهاية الفوترة. تشير الحاوية إلى الاستخدام كل 10 إلى 15 دقيقة تقريباً. إذا لم تتصل الحاوية بـ Azure خلال الفترة الزمنية المسموح بها، فسيستمر تشغيل الحاوية ولكنها لا تخدم الاستعلامات حتى تتم استعادة نقطة نهاية الفوترة. تمت محاولة الاتصال 10 مرات في نفس الفاصل الزمني من 10 إلى 15 دقيقة. إذا تعذر الاتصال بنقطة نهاية الفوترة خلال 10 محاولات، فستتوقف الحاوية عن تقديم الطلبات. راجع الأسئلة المتداولة حول حاوية خدمات azure الذكاء الاصطناعي للحصول على مثال على المعلومات المرسلة إلى Microsoft للفوترة.
وسائط الفوترة
سيبدأ الأمر docker run الحاوية عندما يتم توفير جميع الخيارات الثلاثة التالية بقيم صالحة:
| خيار | الوصف |
|---|---|
ApiKey |
مفتاح API لمورد خدمات Azure الذكاء الاصطناعي المستخدم لتعقب معلومات الفوترة. يجب تعيين قيمة هذا الخيار على مفتاح واجهة برمجة التطبيقات للمورد المقدم المحدد في Billing. |
Billing |
نقطة نهاية مورد خدمات Azure الذكاء الاصطناعي المستخدمة لتعقب معلومات الفوترة. يجب تعيين قيمة هذا الخيار إلى عنوان URI لنقطة النهاية لمورد Azure المتاح. |
Eula |
يشير إلى أنك قبلت ترخيص الحاوية. يجب تعيين قيمة هذا الخيار على accept. |
لمزيد من المعلومات بشأن هذه الخيارات، راجع تكوين الحاويات.
الملخص
في هذه المقالة، تعلمت المفاهيم وسير العمل لتنزيل حاويات Language Understanding (LUIS) وتثبيتها وتشغيلها. في ملخص
- توفر Language Understanding (LUIS) حاوية Linux واحدة من أجل Docker والتي توفر تنبؤات استعلام نقطة النهاية للتعبيرات.
- يتم تنزيل صور الحاوية من Microsoft Container Registry (MCR).
- يتم تشغيل صور الحاوية في Docker.
- يمكنك استخدام واجهة برمجة تطبيقات REST للاستعلام عن نقاط نهاية الحاوية عن طريق تحديد عنوان URI المضيف للحاوية.
- يجب عليك تحديد معلومات الفوترة عند إنشاء مثيل حاوية.
هام
لا يتم ترخيص حاويات Azure الذكاء الاصطناعي للتشغيل دون الاتصال ب Azure لقياسها. يحتاج العملاء إلى تمكين الحاويات من توصيل معلومات الفوترة مع خدمة القياس في جميع الأوقات. لا ترسل حاويات Azure الذكاء الاصطناعي بيانات العميل (على سبيل المثال، الصورة أو النص الذي يتم تحليله) إلى Microsoft.
الخطوات التالية
- مراجعة تكوين الحاويات لإعدادات التكوين.
- راجع قيود حاوية LUIS لقيود الإمكانية المعروفة.
- راجع استكشاف الأخطاء وإصلاحها لحل المشكلات المتعلقة بوظائف LUIS.
- استخدام المزيد من حاويات Azure الذكاء الاصطناعي