صوّر صندوق بريد يحتوي على فواتير ممسوحة ضوئيًا، حيث يحمل كل صفحة رمزًا شريطيًا يحدد أمر الشراء. يمكن لوكيل ذكاء اصطناعي قراءة كل رمز في المجلد محليًا، دون رفع أي ملفات، وتزويدك بجدول يطابق كل ملف مع سجله. الوكيل يمكن أن يكون Claude أو Cursor أو GitHub Copilot؛ وتتم عملية القراءة عبر خادم GroupDocs.Signature.Mcp. طلب واحد يكفي لهذا الغرض:

لكل ملف PDF في المجلد، اقرأ الرمز الشريطي، وامنحني جدولًا يحتوي على اسم الملف، قيمة الرمز الشريطي، والصفحة.

النسخة التفصيلية خطوة بخطوة مع الإعدادات واستكشاف الأخطاء موجودة في الوثائق: كيفية استخراج بيانات رموز QR والرموز الشريطية من المستندات باستخدام الذكاء الاصطناعي.

السيناريو: من كومة ملفات إلى طابور موجه

غرفة البريد، فريق الحسابات المستحقة أو مكتب إدارة القضايا يتلقون مستندات بكميات كبيرة. كل مستند يحمل رمزًا قابلًا للقراءة آليًا موضعًا هناك لهذا الغرض بالذات. بدون أتمتة، يقوم شخص ما بكتابة القيمة في النظام التالي. مع وكيل، تكون السلسلة كالتالي:

  1. تصل المستندات إلى المجلد الذي تم تكوين الخادم لاستخدامه (GROUPDOCS_MCP_STORAGE_PATH).
  2. يستدعي الوكيل الدالة search_barcodes على كل ملف ويجمع القيم المفكوكة، الصفحات، والمواقع.
  3. يُرجع الوكيل الجدول. هذا الجدول هو مفتاح الربط بين الملفات والسجلات في نظام ERP أو المخزن أو نظام القضايا الخاص بك.
  4. شخصًا ما، أو خطوة آلية لاحقة تتحكم فيها، تقوم بالبحث والتوجيه.

الخطوة 4 تبقى خارج نطاق الوكيل عن قصد. راجع قسم “ما لا ينبغي أتمتته” أدناه.

أي أداة تقرأ أي رمز؟

search_qr_codes تقرأ رموز QR. search_barcodes تقرأ الرموز الشريطية أحادية البعد مثل Code39 وCode128 وEAN. كل منهما تُعيد النص المفكوك، الصفحة، وموقع كل نتيجة. إذا لم تكن متأكدًا من نوع الرمز الموجود في المستند، اطلب كليهما:

اقرأ رموز QR والرموز الشريطية في invoice.pdf وأخبرني بما تحتويه.

كيف تجد رمزًا واحدًا بين العديد؟

كلا الأداتين تقبلان مرشح text يُعيد فقط الرموز التي تحتوي على السلسلة المحددة:

ابحث عن الرمز الشريطي الذي يبدأ بـ SHIP وأخبرني في أي صفحة هو موجود.

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

حافظ على صغر حجم الاستجابات

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

جلسة مثال (مختصرة)

You:    For every PDF in the folder, read the barcode, and give me a table
        of file name, barcode value, page.

Agent:  [search_barcodes] file=invoice-0007.pdf   found: 1
        [search_barcodes] file=invoice-0008.pdf   found: 1
        [search_barcodes] file=scan-0009.pdf      found: 0
        | file             | barcode value | page |
        | invoice-0007.pdf | PO-448210     | 1    |
        | invoice-0008.pdf | PO-448377     | 1    |
        scan-0009.pdf has no barcode in the pages that were processed.

الإخراج التوضيحي: أسماء الملفات وقيم الرموز الشريطية مختلقة. الأداة تُعيد الحقول الموضحة أعلاه.

Signature أو Parser: أي خادم يقرأ الرمز؟

استخدم GroupDocs.Signature.Mcp عندما يكون الرمز عنصر توقيع تضيفه أنت، أو عندما تتدفق المستندات في كلا الاتجاهين: اقرأ المرجع الوارد، نفّذ العملية، ثم استدعِ sign على المستند الصادر مع رمز QR يحمل المرجع الجديد. استخدم GroupDocs.Parser.Mcp (متوفر كصورة Docker فقط؛ أداة extract_barcodes الخاصة به) عندما تستخرج بيانات من مسحات عشوائية وتحتاج أيضًا إلى النصوص أو الجداول أو البيانات الوصفية من نفس الملفات. هذا الخادم يقرأ التواقيع والرموز، لكنه لا يستخرج التخطيط أو الحقول أو الجداول.

ما لا ينبغي أتمتته

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

حدود التقييم

بدون ترخيص يتم معالجة الصفحتين الأوليين فقط من المستند، وتُطبع علامة تجريبية على كل صفحة. الرمز الموجود في الصفحة الثالثة ببساطة لا يُعثر عليه، وتظهر النتيجة الفارغة كأنها “لا رمز”. اطلب من الوكيل استدعاء get_license_status قبل الاعتماد على نتيجة فارغة.

الأسئلة المتكررة

هل يستطيع Claude قراءة رمز QR في هذا PDF؟
نعم. عندما يكون الخادم متصلًا، يستدعي Claude search_qr_codes ويُبلغ عن النص المفكوك، الصفحة، والموقع، محليًا.

كيف أستخرج قيمة رمز شريطي من فاتورة باستخدام الذكاء الاصطناعي؟
اطلب من الوكيل قراءة الرموز الشريطية في الملف. سيستدعي search_barcodes ويُرجع القيمة المفكوكة؛ أضف مرشح text إذا كنت تريد رمزًا محددًا.

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

تعمق أكثر