الذكاء الاصطناعي في Document AI: حلقة Human in the Loop

1. مقدمة

‫Document AI API هو حلّ لفهم المستندات يستند إلى البيانات غير المنظَّمة، مثل المستندات والرسائل الإلكترونية وما إلى ذلك، ويسهّل فهم البيانات وتحليلها واستخدامها.

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

ملاحظة: قد تتغيّر واجهة مستخدم Console بمرور الوقت، لذا قد تبدو بيئتك مختلفة قليلاً. إذا واجهت أي مشاكل في هذه التجربة، يُرجى الإبلاغ عنها.

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

يستند هذا الدرس التطبيقي حول الترميز إلى المحتوى المقدَّم في دروس تطبيقية أخرى حول Document AI.

ننصحك بإكمال Codelabs التالية قبل المتابعة.

• التعرّف البصري على الأحرف (OCR) باستخدام Document AI (Python)
• تحليل النماذج باستخدام Document AI (Python)
• المعالِجات المتخصّصة باستخدام Document AI (Python)

ما ستتعلمه

• ضبط مراجعة يدوية لأحد المعالِجات
• إنشاء مجموعة موارد للمستخدمين الذين يجرون مراجعات يدوية
• إنشاء مهمة مراجعة تجريبية
• إسناد مهمة مراجعة إلى مستخدم
• إكمال مراجعة مستند.

المتطلبات

• مشروع Google Cloud
• متصفّح، مثل Chrome أو Firefox
• معرفة لغة Python 3

2. الإعداد

يفترض هذا الدرس العملي أنك أكملت خطوات إعداد Document AI المُدرَجة في الدرس العملي التمهيدي.

يُرجى إكمال الخطوات التالية قبل المتابعة:

• بدء Cloud Shell
• تفعيل واجهات برمجة التطبيقات Document AI وCloud Storage
• تثبيت مكتبة برامج Python

عليك أيضًا تفعيل Vertex AI API.

1. باستخدام شريط البحث في أعلى وحدة التحكّم، ابحث عن "Vertex AI API"، ثم انقر على تفعيل لاستخدام واجهة برمجة التطبيقات في مشروعك على Google Cloud.
2. بدلاً من ذلك، يمكن تفعيل واجهة برمجة التطبيقات باستخدام الأمر gcloud التالي.

gcloud services enable aiplatform.googleapis.com

3- إنشاء معالج

يجب أولاً إنشاء مثيل من "معالج النفقات" لاستخدامه في هذا المختبر.

1. في وحدة التحكّم، انتقِل إلى نظرة عامة على منصة Document AI.
2. انقر على إنشاء معالج، وانتقِل للأسفل إلى متخصّص، ثم اختَر محلّل النفقات.
3. أدخِل الاسم codelab-expense-parser (أو أي اسم آخر يمكنك تذكُّره) واختَر المنطقة الأقرب في القائمة.
4. انقر على إنشاء لإنشاء المعالج.
5. انسخ رقم تعريف المعالج. يجب استخدام هذا المعرّف في الرمز البرمجي لاحقًا.
6. في Cloud Shell، أنشئ حزمة تخزين باستخدام PROJECT_ID-hitl-results كاسم:

export PROJECT_ID=$(gcloud config get-value core/project)
gsutil mb gs://$PROJECT_ID-hitl-results

7. ربط حسابك بدور مشرف إدارة الهوية وإمكانية الوصول في Vertex AI في مشروع المختبر

export USER_ACCOUNT=$(gcloud config get-value core/account)
gcloud projects add-iam-policy-binding $PROJECT_ID --member=user:$USER_ACCOUNT --role=roles/aiplatform.admin

4. ضبط إعدادات "الذكاء البشري"

في هذه المهمة، ستضبط إعدادات المراجعة من قِبل موظف لمعالج النفقات الذي أنشأته سابقًا.

1. في وحدة التحكّم، افتح قائمة التنقّل واختَر Document AI.
2. انقر على الذكاء الاصطناعي الذي يتضمّن تدخّل العنصر البشري.
3. انقر على codelab-expense-parser لفتح صفحة "المراجعة من قِبل موظف" الخاصة بالمعالج.
4. انقر على ضبط ميزة "التحقّق من صحة المعلومات".

5. انقر على فلتر على مستوى المستند.
6. اضبط شريط التمرير النسبة المئوية لحدّ الدقة على %50.
7. اترك خيار المتخصصون مضبوطًا على استخدام المتخصصين الخاصين بي.

8. انقر في مربّع القائمة المنسدلة مجموعة المتخصّصين، ثمّ انقر على مجموعة متخصّصين جديدة.
9. في حقل اسم مجموعة المتخصّصين، أدخِل Codelab HITL Pool في مربّع الحوار مجموعة المتخصّصين الجديدة.
10. أدخِل عنوان بريدك الإلكتروني الشخصي في حقلَي مدراء مجموعة والمتخصصون.
11. انقر على إنشاء مجموعة.

سيستغرق إكمال هذه الخطوة بضع دقائق. من المفترض أن تتلقّى رسالة إلكترونية من Vertex AI [e-mail].

ملاحظة: انقر على إعادة المحاولة إذا واجهت أي مشاكل في الأذونات. يجب أن يتوفّر لك إذن aiplatform.specialistPools.create في Cloud IAM، والذي يتطلّب تعيين دورroles/aiplatform.admin لحساب المستخدم على مستوى المشروع.

roles/project.owner لا يكفي وحده.

12. لا تضع علامة في المربّع التخصيص التلقائي.
13. ضَع علامة في مربّع الاختيار في قسم تأكيد الرسوم.
14. انقر على موقع التعليمات وانسخ موقع التخزين هذا: - لا تضمّن البادئة gs:// في المسار

cloud-samples-data/documentai/codelabs/hitl/hitl-instructions.pdf

ملاحظة: هذا المستند هو نسخة من الإرشادات الخاصة بإنشاء مجموعات تعليمات المراجعين، وليس مثالاً عمليًا.

15. في موقع النتائج، انقر على تصفّح واختَر حزمة Cloud Storage التي أنشأتها سابقًا.
16. انقر على اختيار.
17. انقر على حفظ الضبط.

ستعرض وحدة التحكّم الآن الرسالة جارٍ إعداد ميزة "التحقّق من صحة البيانات من قِبل موظف"، وسيستغرق إكمال هذه العملية بضع دقائق.

18. عند اكتمال عملية الضبط، ستطلب منك وحدة التحكّم تفعيل ميزة "التحقّق من صحة المعلومات من قِبل موظف".

• انقر على زر التبديل لتفعيلها.
• بعد ذلك، انقر على تفعيل في مربّع الحوار المنبثق.

تحميل نموذج استمارة نفقات

1. لدينا نموذج يمكن استخدامه ومخزَّن في Google Cloud Storage. يمكنك تنزيله باستخدام الزر أو الأمر أدناه:

تنزيل expense-claim.pdf

gsutil cp gs://cloud-samples-data/documentai/codelabs/hitl/expense-claim.pdf .

2. بعد تفعيل ميزة "التدخّل البشري"، انقر على الزر تحميل المستند وابحث عن المستند النموذجي الذي نزّلته للتو.
3. انقر على تحميل وانتظر إلى أن تكتمل العملية.

5- إسناد عنصر لمراجعته

1. في هذه الصفحة، من المفترض أن تظهر لك روابط تؤدي إلى "وحدة تحكّم مدير مجموعة الموارد" و"وحدة تحكّم الخبير". ستظهر هذه الروابط أيضًا في رسالة إلكترونية من Vertex AI [e-mail].
   • يجب أن تبدو على النحو التالي: https://datacompute.google.com/cm/cloudml_data_specialists_us_central1_xxxxxxx/tasks
   • انقر على رابط وحدة تحكّم المشرف.

2. بعد الدخول إلى "وحدة تحكّم تصنيف البيانات"، انقر على عنوان علامة التبويب المهام لفتح صفحة تعيين المهام.
3. انقر على مربّع الاختيار لم يتم التعيين. من المفترض أن يظهر لك إدخال جديد مُدرَج في قائمة انتظار المهام codelab-expense-parser-P1.

4. اختَر codelab-expense-parser-P1.
5. انقر على إدارة المهمة.
6. أدخِل عنوان بريدك الإلكتروني الشخصي في مربّع النص تضمين خبراء حسب البريد الإلكتروني، ثم اختَره من القائمة المنسدلة.
7. انقر على تطبيق.

تعرض الشاشة الآن أنّ المهمة تم تعيينها لك. قد يستغرق نشرها وظهورها بضع دقائق.

8. اختَر المستخدم الجديد وانقر على رمز القائمة.
9. انقر على تعيين إلى جميع المهام من القائمة المنبثقة التي تظهر.

10. انقر على تنفيذ التغييرات.
11. انقر على تنفيذ.

6. تنفيذ مهمة المراجعة

1. ارجع إلى صفحة إعداد Human-in-the-Loop في Cloud Console.

انقر على الرابط للانتقال إلى وحدة تحكّم "المتخصّص" (العامل). سيبدو ذلك على النحو التالي: https://datacompute.google.com/w/cloudml_data_specialists_us_central1_xxxxxxxxxxx.

من المفترض أن يتم فتح وحدة تحكّم العامل وعرض مهمتك الجديدة.

2. مرِّر مؤشر الماوس فوق عنصر الحملة الذي يحتوي على اجتماع مع 4m وانقر على رمز التعديل (القلم الرصاص).
3. عدِّل القيمة لتغيير النص إلى اجتماع مع آدم. قد تحتاج إلى التمرير للأسفل في مربّع النص لرؤية النص.
4. انقر على تطبيق.
5. انقر على رمز تأكيد (علامة صح خضراء) للعنصر أدناه.
6. انقر على رمز تأكيد للعناصر المميزة الأخرى.
7. انقر على إرسال. تمت الآن إزالة مهمة المراجعة من قائمة انتظار المصنّف.

7. عرض المهام المكتملة

1. ارجع إلى "وحدة تحكّم المشرف".
2. انقر على المهام واختَر جارية
3. انقر على المتخصّصون.
4. اختَر عنوان بريدك الإلكتروني.
5. انقر على إدارة المهمة.
6. اختَر expense-processor-P1 من القائمتَين المنسدلتَين Select specialists working on specific tasks وSelect tasks. انقر على تطبيق لكل اختيار. في قائمة السياق الخاصة بـ expense-processor-P1 التي تمّ تعيينها لك، انقر على عرض المتخصّصين (View Specialists).

بعد أن يرسل مصنّف البيانات مهمة التصنيف، سيتم تعديل عدد المهام التي تمّت الإجابة عنها وإجمالي الوقت المستغرَق، ولكن قد يستغرق ظهور البيانات في طريقة العرض هذه بضع دقائق.

7. أغلِق النافذة المنبثقة الخاصة بالخبراء واطّلِع على علامة التبويب الخبراء.
8. انقر على قائمة السياق لاسم المستخدم واختَر عرض المهام.

تعرض طريقة العرض هذه قائمة بمهام المستخدم وأرقام إكمالها ومقدار الوقت المستغرَق كما هو موضّح أدناه:

8. تهانينا

تهانينا، لقد نجحت في استخدام ميزة "دور الإنسان" في Document AI لإعداد مراجعة بشرية للمستندات التي تتم معالجتها باستخدام أداة معالجة النفقات في Document AI.

تنظيف

لتجنُّب تحمّل رسوم في حسابك على Google Cloud مقابل الموارد المستخدَمة في هذا البرنامج التعليمي، اتّبِع الخطوات التالية:

• في Cloud Console، انتقِل إلى صفحة إدارة الموارد.
• في قائمة المشاريع، اختَر مشروعك ثم انقر على "حذف".
• في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على "إيقاف" لحذف المشروع.

مزيد من المعلومات

يمكنك مواصلة التعرّف على Document AI من خلال تجربة Codelabs التالية.

• إدارة معالِجات Document AI باستخدام Python

المراجع

• مستقبل المستندات - قائمة تشغيل على YouTube
• مستندات Document AI
• مكتبة برامج Document AI Python
• أمثلة على Document AI

الترخيص

يخضع هذا العمل لترخيص المشاع الإبداعي مع نسب العمل إلى مؤلفه 2.0 Generic License.