تثبيت الحاويات وتشغيلها
يتوفر دعم الحاويات حاليا مع إصدار 2022-08-31 (GA)
تحليل معلومات المستند لجميع النماذج ولنماذج 2023-07-31 (GA)
القراءة والتخطيط ومستند المعرف والإيصال والفاتورة:
- واجهة برمجة تطبيقات REST
2022-08-31 (GA)
- واجهة برمجة تطبيقات REST
2023-07-31 (GA)
- استهداف مكتبات العملاء
REST API 2022-08-31 (GA)
- استهداف مكتبات العملاء
REST API 2023-07-31 (GA)
✔️ راجع تثبيت حاويات Document Intelligence وتشغيلها للحصول على وثائق الحاوية المدعومة.
ينطبق هذا المحتوى على: v3.0 (GA) v3.1 (GA)
Azure الذكاء الاصطناعي Document Intelligence هي خدمة Azure الذكاء الاصطناعي تتيح لك إنشاء برامج معالجة البيانات التلقائية باستخدام تقنية التعلم الآلي. تمكنك ميزة Document Intelligence من تحديد واستخراج النص وأزواج المفاتيح/القيم وعلامات التحديد وبيانات الجدول والمزيد من المستندات. يتم تسليم النتائج كبيانات منظمة التي .. /يتضمن العلاقات في الملف الأصلي.
في هذه المقالة، ستتعرف على كيفية تنزيل حاويات Document Intelligence وتثبيتها وتشغيلها. تمكنك الحاويات من تشغيل خدمة Document Intelligence في بيئتك الخاصة. وتعد الحاويات رائعة لمتطلبات الأمان وإدارة البيانات المحددة.
يتم دعم نماذج القراءة والتخطيط ومستند المعرف والإيصال والفاتورة بواسطة حاويات Document Intelligence v3.1.
يتم دعم نماذج القراءة والتخطيط والمستند العام وبطاقة العمل والنماذج المخصصة بواسطة حاويات Document Intelligence v3.0.
المتطلبات الأساسية
للبدء، تحتاج إلى حساب Azure نشط. إذا لم يكن لديك حساب، يمكنك إنشاء حساب مجاني.
تحتاج أيضا إلى ما يلي لاستخدام حاويات Document Intelligence:
المطلوب | الغرض |
---|---|
الإلمام بـ Docker | يجب أن يكون لديك فهم أساسي لمفاهيم Docker، مثل السجلات والمستودعات والحاويات وصور الحاويات، بالإضافة إلى معرفة المصطلحات والأوامر الأساسيةdocker . |
تثبيت محرك Docker |
|
مورد تحليل معلومات المستند | خدمة واحدة Azure الذكاء الاصطناعي Document Intelligence أو مورد متعدد الخدمات في مدخل Microsoft Azure. لاستخدام الحاويات، يجب أن يكون لديك المفتاح المقترن وURI لنقطة النهاية. تتوفر كلتا القيمتين في صفحة Azure Portal Document Intelligence Keys and Endpoint :
|
اختياري | الغرض |
---|---|
واجهة سطر الأوامر (CLI) في Azure | تمكّنك واجهة سطر الأوامر في Azure من استخدام مجموعة من الأوامر عبر الإنترنت لإنشاء موارد Azure وإدارتها. وهي متوفرة للتثبيت في بيئات Windows وmacOS وLinux، ويمكن تشغيلها في حاوية Docker وAzure Cloud Shell. |
متطلبات الكمبيوتر المضيف
المضيف هو كمبيوتر يستند إلى إصدار x64 ويشغّل حاوية Docker. وقد يكون هذا أحد أجهزة الكمبيوتر الموجودة في موقعك أو خدمة استضافة Docker في Azure، مثل:
- خدمة Azure Kubernetes.
- Azure Container Instances.
- تم توزيع مجموعة Kubernetes في Azure Stack. لمزيد من المعلومات، يرجى مراجعة نشر Kubernetes في Azure Stack.
إشعار
لاحظ أنه لا يمكن نشر حاوية Studio وتشغيلها في Azure Kubernetes Service. يتم دعم حاوية Studio فقط ليتم تشغيلها على الجهاز المحلي.
متطلبات الحاوية وتوصياتها
الحاويات الداعمة المطلوبة
يسرد الجدول التالي حاوية دعم واحدة أو أكثر لكل حاوية معلومات مستند تقوم بتنزيلها. لمزيد من المعلومات، راجع قسم الفواتير.
حاوية الميزات | الحاويات الداعمة |
---|---|
مقروء | غير مطلوب |
تخطيط | غير مطلوب |
بطاقة العمل | مقروء |
مستند عام | تخطيط |
فاتورة | تخطيط |
وصل | قراءة أو تخطيط |
مستند المعرف | مقروء |
قالب مخصص | تخطيط |
الذاكرة والنواة الموصى بهما لوحدة المعالجة المركزية
إشعار
يعتمد الحد الأدنى والقيم الموصى بها على حدود Docker، وليس على موارد الجهاز المضيف.
حاويات ذكاء المستند
الحاوية | الحد الأدنى | مستحسن |
---|---|---|
Read |
8 الذاكرة الأساسية، ذاكرة 10 غيغابايت |
8 الذاكرة الأساسية، ذاكرة 24 غيغابايت |
Layout |
8 الذاكرة الأساسية، ذاكرة 16 غيغابايت |
8 الذاكرة الأساسية، ذاكرة 24 غيغابايت |
Business Card |
8 الذاكرة الأساسية، ذاكرة 16 غيغابايت |
8 الذاكرة الأساسية، ذاكرة 24 غيغابايت |
General Document |
8 الذاكرة الأساسية، ذاكرة 12 غيغابايت |
8 الذاكرة الأساسية، ذاكرة 24 غيغابايت |
ID Document |
8 الذاكرة الأساسية، ذاكرة 8 غيغابايت |
8 الذاكرة الأساسية، ذاكرة 24 غيغابايت |
Invoice |
8 الذاكرة الأساسية، ذاكرة 16 غيغابايت |
8 الذاكرة الأساسية، ذاكرة 24 غيغابايت |
Receipt |
8 الذاكرة الأساسية، ذاكرة 11 غيغابايت |
8 الذاكرة الأساسية، ذاكرة 24 غيغابايت |
Custom Template |
8 الذاكرة الأساسية، ذاكرة 16 غيغابايت |
8 الذاكرة الأساسية، ذاكرة 24 غيغابايت |
- يجب أن يكون كل نواة 2.6 غيغاهيرتز على الأقل (غيغاهرتز) أو أسرع.
- تتوافق النواة والذاكرة مع إعدادات
--cpus
و--memory
التي تُستخدم كجزء من الأمرdocker compose
أوdocker run
.
تلميح
يمكنك استخدام أمر docker images لسرد صور الحاوية التي تم تنزيلها. على سبيل المثال، يسرد الأمر التالي المعرف والمستودع والعلامة لكل صورة حاوية تم تنزيلها، منسقة كجدول:
docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"
IMAGE ID REPOSITORY TAG
<image-id> <repository-path/name> <tag-name>
تشغيل الحاوية باستخدام الأمر docker-compose up
استبدل القيمتين {ENDPOINT_URI} و{API_KEY} بـ URI لنقطة نهاية موردك والمفتاح من صفحة مورد Azure.
تأكد من
EULA
تعيين القيمة لقبولها.EULA
Billing
يجب تحديد القيم و وApiKey
؛ وإلا لا يمكن بدء تشغيل الحاوية.
هام
يتم استخدام المفاتيح للوصول إلى مورد Document Intelligence. لا تشارك مفاتيحك. قم بتخزينها بأمان - على سبيل المثال، باستخدام Azure Key Vault. نوصي أيضاً بإعادة تجديد هذه المفاتيح بانتظام. مفتاح واحد فقط ضروري لإجراء استدعاء واجهة برمجة التطبيقات. عند تجديد المفتاح الأول، يمكنك استخدام المفتاح الثاني للوصول المستمر إلى الخدمة.
نموذج التعليمات البرمجية التالي هو مثال قائم بذاته docker compose
لتشغيل حاوية Document Intelligence Layout. باستخدام docker compose
، يمكنك استخدام ملف YAML لتكوين خدمات تطبيقك. بعد ذلك، باستخدام docker-compose up
الأمر ، يمكنك إنشاء جميع الخدمات وبدء تشغيلها من التكوين الخاص بك. أدخل قيم {FORM_RECOGNIZER_ENDPOINT_URI} و{FORM_RECOGNIZER_KEY} لمثيل حاوية التخطيط.
version: "3.9"
services:
azure-form-recognizer-read:
container_name: azure-form-recognizer-read
image: mcr.microsoft.com/azure-cognitive-services/form-recognizer/read-3.1
environment:
- EULA=accept
- billing={FORM_RECOGNIZER_ENDPOINT_URI}
- apiKey={FORM_RECOGNIZER_KEY}
ports:
- "5000:5000"
networks:
- ocrvnet
networks:
ocrvnet:
driver: bridge
الآن، يمكنك بدء تشغيل الخدمة باستخدام الأمر docker compose:
docker-compose up
التحقق من أن الخدمة قيد التشغيل
هناك عدة طرق للتحقق من أن الحاوية قيد التشغيل:
توفر الحاوية صفحة رئيسية في
\
كتحقق مرئي من أن الحاوية قيد التشغيل.يمكنك فتح متصفح الويب المفضل لديك والانتقال إلى عنوان IP الخارجي والمنفذ المكشوف للحاوية المعنية. استخدم عناوين URL للطلب المدرجة للتحقق من تشغيل الحاوية. عناوين URL لطلب المثال المدرجة هي
http://localhost:5000
، ولكن يمكن أن تختلف الحاوية المحددة. تذكّر أنك ستتنقل إلى عنوان IP الخارجي للحاوية والمنفذ المكشوف.URL للطلب الغرض http://localhost:5000/ توفر الحاوية صفحةً رئيسيةً. http://localhost:5000/ready هذا الطلب المطلوب باستخدام GET يوفر تحققاً من استعداد الحاوية لقبول الاستعلام مقابل النموذج. يمكن استخدام هذا الطلب لـ Kubernetes تحقيقات الاستعداد والجاهزية. http://localhost:5000/status هذا الطلب المطلوب باستخدام GET يتحقق مما إذا كانت واجهة برمجة التطبيقات المُستخدمة أو المفتاح المُستخدم لبدء تشغيل الحاوية صالح/صالحة بدون التسبب في استعلام نقطة نهاية. يمكن استخدام هذا الطلب لـ Kubernetes تحقيقات الاستعداد والجاهزية. http://localhost:5000/swagger توفر الحاوية مجموعةً كاملةً من الوثائق لنقاط النهاية وميزة Try it out. باستخدام هذه الميزة، يمكنك إدخال إعداداتك في نموذج HTML مستند إلى الويب وإجراء الاستعلام بدون الحاجة إلى كتابة أية تعليمة برمجية. بعد إرجاع الاستعلام، يتم توفير مثال لأمر CURL لتوضيح عناوين HTTP المطلوبة وتنسيق النص الأساسي.
إيقاف الحاويات
لإيقاف الحاويات، استخدم الأمر التالي:
docker-compose down
الفوترة
ترسل حاويات Document Intelligence معلومات الفوترة إلى Azure باستخدام مورد Document Intelligence على حساب Azure الخاص بك.
تتم فوترة الاستعلامات إلى الحاوية في مستوى التسعير لمورد Azure المستخدم لواجهة برمجة التطبيقات Key
. يتم حساب الفوترة لكل مثيل حاوية يستخدم لمعالجة المستندات والصور.
إذا تلقيت الخطأ التالي: الحاوية ليست في حالة صالحة. فشل التحقق من صحة الاشتراك مع نفاد الحصة النسبية لمفتاح واجهة برمجة تطبيقات الحالة 'OutOfQuota'. إنه مؤشر على أن الحاويات الخاصة بك ليست اتصالا بنقطة نهاية الفوترة.
قم بالاتصال بـ Azure
تحتاج الحاوية إلى قيم وسيطة للفوترة لتشغيلها. تسمح هذه القيم للحاوية بالاتصال بنقطة نهاية الفوترة. تشير الحاوية إلى الاستخدام كل 10 إلى 15 دقيقة تقريباً. إذا لم تتصل الحاوية بـ Azure خلال الفترة الزمنية المسموح بها، فسيستمر تشغيل الحاوية ولكنها لن تخدم الاستعلامات حتى تُستعاد نقطة نهاية الفوترة. تمت محاولة الاتصال 10 مرات في نفس الفاصل الزمني من 10 إلى 15 دقيقة. إذا تعذر الاتصال بنقطة نهاية الفوترة خلال 10 محاولات، فستتوقف الحاوية عن تقديم الطلبات. راجع الأسئلة المتداولة حول حاوية Azure الذكاء الاصطناعي للحصول على مثال على المعلومات المرسلة إلى Microsoft للفوترة.
وسائط الفوترة
يبدأ الأمر docker-compose up الحاوية عند توفير جميع الخيارات الثلاثة التالية بقيم صالحة:
خيار | الوصف |
---|---|
ApiKey |
مفتاح مورد خدمات Azure الذكاء الاصطناعي المستخدم لتعقب معلومات الفوترة. يجب تعيين قيمة هذا الخيار إلى مفتاح للمورد المقدم المحدد في Billing . |
Billing |
نقطة نهاية مورد خدمات Azure الذكاء الاصطناعي المستخدمة لتعقب معلومات الفوترة. يجب تعيين قيمة هذا الخيار إلى عنوان URI لنقطة النهاية لمورد Azure المتاح. |
Eula |
يشير إلى أنك قبلت ترخيص الحاوية. يجب تعيين قيمة هذا الخيار على accept. |
لمزيد من المعلومات بشأن هذه الخيارات، راجع تكوين الحاويات.
الملخص
هكذا! في هذه المقالة، تعلمت المفاهيم وسير العمل لتنزيل حاويات Document Intelligence وتثبيتها وتشغيلها. في ملخص
- يوفر Document Intelligence سبع حاويات Linux ل Docker.
- يتم تنزيل صور الحاوية من mcr.
- يتم تشغيل صور الحاوية في Docker.
- يجب تحديد معلومات الفوترة عند إنشاء مثيل لحاوية.
هام
لا يتم ترخيص حاويات Azure الذكاء الاصطناعي للتشغيل دون الاتصال ب Azure لقياسها. يحتاج العملاء إلى تمكين الحاويات من توصيل معلومات الفوترة مع خدمة القياس في جميع الأوقات. لا ترسل حاويات Azure الذكاء الاصطناعي بيانات العميل (على سبيل المثال، الصورة أو النص الذي يتم تحليله) إلى Microsoft.
الخطوات التالية
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ