صندوق الوارد الذي يفكر معك: PaperOffice AI في n8n، خطوة بخطوة

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

النتيجة أولاً: تشغيل حقيقي، يتخذ البشر القرارات

قبل أن نبني أي شيء، دعونا نلقي نظرة على النتيجة أولاً. تشغيل حقيقي. بعد ذلك، سنقوم ببنائه خطوة بخطوة. مثالنا هو فحص دفعة يتكون من ست صفحات: أمر شراء واحد، وإيصال تسليم واحد، وأربع فواتير. في واحدة منها، يظهر رقم حساب بنكي جديد فجأة. أنا أرسل الفحص الدفعة إلى نقطة النهاية (webhook). ست صفحات في ملف PDF واحد، كما تخرج من الماسح الضوئي. في قائمة التنفيذ، يبدأ التشغيل. يقوم الفصل بفصل المستندات، وتقرأ IDP الحقول، وكل فاتورة تم وضع علامة عليها تخضع لفحص Ultra. يستغرق هذا بضع دقائق، لذا سأقوم بتسريع الوقت. لقد تعرف التشغيل على ست مستندات، وقام بأرشفتها، ومطابقة الطلبات. لكل مستند لديه سبب، تنتظره مهمة الآن. والعملية قيد الانتظار وتنتظر منا. في PaperOffice، يتم سرد المهام تحت قسم ‘الإنسان في الحلقة’ (Human in the Loop)، كل منها مع سببه. يعرف PaperOffice هذه الفاتورة بالفعل. إنها النسخة الثانية من فاتورة إيبيريكا، مع ختم استلام. تبلغ العملية عن التكرار، وتحدد عرض المراجعة الأصل. أرفضها، مع سبب. بالنسبة لهذه الفاتورة، يبلغ فحص المخاطر عن خطر احتيال مرتفع: المورد يقدم حساباً بنكياً جديداً. من درجة سبعة، يتم عزل المستند تلقائياً. أرفض هذه أيضاً. فاتورة السبعة والأربعين ألفاً وخمسمائة يورو غير ملحوظة. قبل أن أوافق عليها، أؤكد الحقول المستخرجة. ثم: الموافقة. أتخذ القرار المتبقي للمهام الثلاث الأخرى بنفس الطريقة. كل قرار يوقظ التشغيل عبر نقطة النهاية الثانية. بعد الأخير، ينتهي الأمر: حوالي ثلاثين دقيقة، ومعظم هذا الوقت كان في انتظارنا. النتيجة في PaperOffice: المستندات المعتمدة موجودة في مستندات نورستار (Northstar Documents)، والفواتير آمنة من المراجعة حتى نهاية عام 2036. تحت الأنشطة، توجد ملاحظة العملية. التكرار موجود في العزل Workspace، مع حجز قانوني وملاحظة أيضاً. لم يعد بإمكانه الحذف. وهذا بالضبط هو صندوق الوارد الذي نبنيه الآن، خطوة بخطوة، باستخدام عقدات HTTP عادية في n8n. عشر مراحل.

المرحلة 1 من 10: الإدخال

المرحلة الأولى هي الإدخال. لقد قمت بإعداد العقد (nodes) لكل مرحلة. ألصقها وأضعها في مكانها. يتلقى Webhook الملف عبر POST. وهو محمي بـ Header-Auth: فقط أولئك الذين يرسلون المفتاح الصحيح في الرأس يُمنحون الوصول. الردود ليست تلقائية ولكن يتم التعامل معها من خلال عقد استجابة مخصصة. إذا كان الملف مفقودًا، تنتقل العملية مباشرة إلى الاستجابة، ويتلقى المرسل على الفور رسالة خطأ واضحة.

المرحلة 2 من 10: Split Agent

المرحلة الثانية هي Split Agent. أقوم بتوصيلها بالإدخال، وتحديداً إلى الفرع الذي يحتوي على الملف. يتم إجراء استدعاء واحد لـ PaperOffice API، وهو طلب POST إلى واجهة المهام. تُخزن بيانات الاعتماد كـ Header-Auth في n8n، وليس داخل العقدة نفسها. يحتوي الجسم على قالب pdf_ai_split، والنموذج فائق الأداء (ultra model)، ومسار المعالجة، وقاعدة لأسماء الملفات، واللغة، وبالطبع الملف نفسه. تعمل المهمة في الخلفية. لذلك، يقوم سير العمل بالاستفسار عن حالة المهمة كل ست ثوانٍ حتى اكتمالها. بمجرد تقسيم الدفعة، يعيد سير العمل استجابة بـ 202 Accepted ويستمر في باقي الخطوات دون إبقاء المرسل في انتظار.

المرحلة الثالثة من أصل 10: مستنداً تلو الآخر

تذهب المرحلة الثالثة مستنداً تلو الآخر. تأخذ الحلقة دائماً مستنداً واحداً بالضبط من نتيجة Split Agent. ثم يقوم سير العمل بتنزيل ملف المستند عبر رابط التنزيل الخاص به.

المرحلة الرابعة من أصل 10: IDP Agent

المرحلة الرابعة هي IDP Agent. مرة أخرى، مكالمة واحدة، باستخدام قالب document_idp. للفواتير وأوامر الشراء وإشعارات التسليم، يتم إرجاع الحقول التالية: المورد، الرقم، التاريخ، المبالغ والبنود التفصيلية، مع مواقعها المقابلة في المستند الأصلي.

المرحلة الخامسة من أصل 10: الأرشفة + Knowledge Graph

المرحلة الخامسة: الأرشفة و Knowledge Graph. يضع مستند-بوت المستند في Workspace n8n المشتريات. ثم يربط procurement_bind الفاتورة وإيصال التسليم بطلب الشراء الخاص بهما، باستخدام رقم أمر الشراء الذي وجده IDP Agent.

المرحلة 6 من 10: AI-DMS Ultra

المرحلة السادسة هي AI-DMS Ultra. لا يتطلب كل مستند تحليلاً كاملاً؛ لذلك، يتم توفير القواعد هنا. مبلغ يزيد عن 1,000 يورو، عدم تطابق في نوع المستند، مبلغ إلزامي مفقود، أو انحراف في المطابقة الثلاثية. إذا كانت قاعدة تنطبق، فإن سير العمل يطلب Ultra لهذا المستند تحديداً.

المرحلة 7 من 10: مهمة التدقيق والمراجعة

المرحلة السابعة: مهمة التدقيق والمراجعة. يقرأ سير العمل خطر الاحتيال وسببه من المستند. ومن خلال واجهة المهمة، ينشئ بعد ذلك مهمة للإنسان: تحديد من سيقوم بمراجعتها، الموعد النهائي، مستوى الاستعجال، والمستند المرتبط. هنا يصل المحلل إلى حدوده. يوفر LlamaParse و Mistral OCR النص والهيكل. لا يتضمنان عملية تحقق مع المهمة والتعيين والموعد النهائي والإثبات. ستحتاج إلى بناء ذلك بنفسك.

المرحلة 8 من 10: المطابقة الثلاثية

المرحلة الثامنة هي المطابقة الثلاثية. تحتوي الحلقة على مخرجين. يُفعّل المخرج الأول عند اكتمال جميع المستندات. أقوم بتوصيله بالمطابقة الثلاثية. يقوم مراجعة المشتريات (procurement_review) بفحص كل معاملة: هل تتطابق أمر الشراء، وإيصال التسليم، والفاتورة من حيث مبلغ الرأس والعناصر الفردية؟ إذا كانت هناك أي انحرافات، فسيتم إنشاء مهمة أيضًا.

المرحلة 9 من 10: انتظار التدخل البشري

المرحلة التاسعة: انتظار التدخل البشري. يسجل سير العمل عنوان الاستيقاظ الخاص به عند PaperOffice ثم يدخل في وضع السكون دون حد زمني. عند اتخاذ قرار في PaperOffice، يبلغ PaperOffice عن القرار عبر ويب هوك ثانٍ. يبحث عن التشغيل الذي ينتظر هذه المهمة ويقوم بإيقاظه.

المرحلة 10 من 10: تطبيق القرار

تطبق المرحلة العاشرة القرار. عند الموافقة، ترفع العملية قفل التدقيق، باستخدام المهمة المعتمدة كدليل. ثم ينتقل المستند إلى مستندات نورستار Workspace، وتصبح الفواتير آمنة من المراجعة، بفترة احتفاظ تبدأ في نهاية العام. في حالة الرفض، يبقى المستند مقفولاً ويُخصص له حجز قانوني. في كلتا الحالتين، تكتب العملية ملاحظة إلى الملف ثم تنتظر القرار التالي. عشر مراحل، عملية واحدة، وكل شيء يعمل على منصة واحدة: عقد واحد، بيانات في الاتحاد الأوروبي، لا يوجد معالجون فرعيون. البيانات داخلة، البيانات خارجة. وبمجرد دخول المستندات إلى PaperOffice، يصبح المزيد ممكناً دون مكون جديد: وكيل الهاتف، الأسئلة من Claude أو ChatGPT عبر MCP، البحث، والعمليات في التطبيق. في الحلقات القادمة، سنلقي نظرة أقرب على وكلاء فرديين، مثل Split وIDP وRedact. حتى ذلك الحين: بناء سعيد.