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

مقالة
01/17/2024

يتوفر دعم الحاويات حاليا مع إصدار 2022-08-31 (GA) Document Intelligence لجميع النماذج وللقراءة 2023-07-31 (GA) والتخطيط فقط:

✔️ راجع تثبيت حاويات Document Intelligence v3.0 وتشغيلها للحصول على وثائق الحاوية المدعومة.

ينطبق هذا المحتوى على:v3.0 (GA)v3.1 (GA)

Azure الذكاء الاصطناعي Document Intelligence هي خدمة Azure الذكاء الاصطناعي تتيح لك إنشاء برامج معالجة البيانات التلقائية باستخدام تقنية التعلم الآلي. تمكنك ميزة Document Intelligence من تحديد واستخراج النص وأزواج المفاتيح/القيم وعلامات التحديد وبيانات الجدول والمزيد من المستندات. يتم تسليم النتائج كبيانات منظمة التي .. /يتضمن العلاقات في الملف الأصلي.

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

يتم دعم نماذج القراءة والتخطيط بواسطة حاويات Document Intelligence v3.1.
يتم دعم نماذج القراءة والتخطيط والمستند العام ومستند المعرف والإيصال والفاتورة وبطاقة العمل والنماذج المخصصة بواسطة حاويات Document Intelligence v3.0.
نموذج بطاقة العمل مدعوم حاليا فقط في حاويات v2.1.

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

للبدء، تحتاج إلى حساب Azure نشط. إذا لم يكن لديك حساب، يمكنك إنشاء حساب مجاني.

تحتاج أيضا إلى ما يلي لاستخدام حاويات Document Intelligence:

المطلوب	الغرض
الإلمام بـ Docker	يجب أن يكون لديك فهم أساسي لمفاهيم Docker، مثل السجلات والمستودعات والحاويات وصور الحاويات، بالإضافة إلى معرفة `docker`بالمصطلحات والأوامر الأساسية.
تثبيت محرك Docker	يتعين تثبيت Docker Engine على كمبيوتر مضيف. يوفر Docker حزما تقوم بتكوين بيئة Docker على macOS وWindows وLinux. للحصول على تمهيد حول Docker وأساسيات الحاوية، راجع نظرة عامة على Docker. يجب تكوين Docker للسماح للحاويات بالاتصال وإرسال بيانات الفواتير إلى Azure. في Windows، يجب أيضًا تكوين Docker لدعم حاويات Linux.
مورد تحليل معلومات المستند	خدمة واحدة Azure الذكاء الاصطناعي Document Intelligence أو مورد متعدد الخدمات في مدخل Microsoft Azure. لاستخدام الحاويات، يجب أن يكون لديك المفتاح المقترن وURI لنقطة النهاية. تتوفر كلتا القيمتين في صفحة Azure Portal Document Intelligence Keys and Endpoint : {FORM_RECOGNIZER_KEY}: أحد مفتاحي الموارد المتوفريْن. {FORM_RECOGNIZER_ENDPOINT_URI}: نقطة النهاية للمورد المُستخدم لتعقب معلومات الفوترة.

اختياري	الغرض
واجهة سطر الأوامر (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.

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

الحاويات الداعمة المطلوبة

يسرد الجدول التالي الحاوية (الحاويات) الداعمة لكل حاوية معلومات مستند تقوم بتنزيلها. لمزيد من المعلومات، راجع قسم الفواتير.

حاوية الميزات	الحاوية (الحاويات) الداعمة
مقروء	غير مطلوب
تخطيط	غير مطلوب
بطاقة العمل	مقروء
مستند عام	تخطيط
فاتورة	تخطيط
استلام	قراءة أو تخطيط
مستند المعرف	مقروء
قالب مخصص	تخطيط

الذاكرة والنواة الموصى بهما لوحدة المعالجة المركزية

إشعار

يعتمد الحد الأدنى والقيم الموصى بها على حدود 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 للقبول.
EULABillingيجب تحديد القيم و و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.0
    environment:
      - EULA=accept
      - billing={FORM_RECOGNIZER_ENDPOINT_URI}
      - apiKey={FORM_RECOGNIZER_KEY}
    ports:
      - "5000:5000"
    networks:
      - ocrvnet
networks:
  ocrvnet:
    driver: bridge