تقسيم المستندات باستخدام Split Agent في n8n

مرحبًا بكم في أكاديمية PaperOffice AI. يتناول هذا الحلقة موضوع Split Agent في n8n: حيث تُدخل مسوحات دفعية، وتخرج وثائق فردية.

النتيجة أولاً: إدخال مسح دفعي، وإخراج وثائق

لنلقِ نظرة على النتيجة أولاً. يحتوي المسح الدفعي القادم من قسم البريد لدينا على سبع صفحات، مع وجود ورقة فاصلة بينها. يحدد Split Agent حيث تنتهي وثيقة وتبدأ الأخرى. تعود خمس وثائق، لكل منها نوعها، واسم وصفي وصفحاتها. إليك كيف يبدو ذلك في n8n. كاختبار، أبدأ سير العمل في المحرر وأرسل المسح الدفعي إلى نقطة النهاية (webhook). الآن يعمل سير العمل عقدة تلو الأخرى. تنتقل مهمة التقسيم إلى PaperOffice، وتستمر الحلقة في التحقق حتى يكتمل الأمر. بعد أقل من أربعين ثانية، ينتهي كل شيء. يحتفظ عقدة القطع (Pieces node) بالنتيجة: خمس إدخالات، واحدة لكل وثيقة. هذه هي الوثائق الخمس: أمر شراء، إيصال تسليم، فاتورة، نشرة خدمة، وتقدير فحص. تحتوي نشرة الخدمة على صفحتين، وتبقى معًا. اكتشف Split Agent ورقة الفاصل في الصفحة الثالثة وقام بإزالتها. وكل وثيقة تحصل على اسم وصفي بناءً على قاعدتنا. كل قطعة هي ملف PDF مستقل. إليك نشرة الخدمة: الصفحتان في ملف واحد، مسماة وفقًا لقاعدتنا. تتضمن النتيجة رابط التنزيل، لكنه صالح لفترة وجيزة فقط. إليك دفعة ثانية، وهي أصعب: ست صفحات بثلاث لغات. أمر شراء بالإنجليزية، وإيصال تسليم بالإسبانية، وفاتورة إسبانية، وإشعار ائتمان، وفاتورة شحن عليها بقعة قهوة، وصورة ملتوية لهاتف لوثيقة فاتورة. يفصل Split Agent جميع الوثائق الست ويسماها بشكل متسق باللغة الإنجليزية. وهذا هو كيفية بنائها، في أربع مراحل: الإدخال، مهمة التقسيم، الانتظار، والقطع.

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

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

المرحلة 2 من 4: مهمة التقسيم

في المرحلة الثانية، يتم إرسال الدفعة إلى Split Agent، عبر مكالمة HTTP واحدة إلى PaperOffice API. تتضمن هذه العملية القالب المقسم، ونموذج Ultra، وقاعدة لتسمية الأجزاء: نوع المستند، والتاريخ، والمرسل. في حقل النموذج، تختار النطاق. يقوم Basic باكتشاف الحدود وتسمية الأجزاء. كما يقرأ Premium نوع المستند، والتاريخ، والمرسل. يوفر Ultra بالإضافة إلى ذلك التبرير لكل عملية قطع ويوفر سجلاً تدقيقياً (Audit Trail). يتم الفوترة بناءً على عدد الصفحات. يحدد عاملان السعر: النطاق ومسار المعالجة. اخترنا الخيار الفوري، مما يعني بدءاً فورياً. بدون ضمان للبدء وبدون اتفاقية مستوى خدمة (SLA)، يكون التكلفة أقل. يمكنك العثور على الأسعار الحالية على موقعنا الإلكتروني تحت قسم التسعير.

المرحلة 3 من 4: في انتظار التنفيذ

يعمل المهمة في الخلفية. كل ست ثوانٍ، يتحقق الحلقة من حالتها. عند الانتهاء، تستمر العملية. إذا فشلت، تنتهي العملية برسالة.

المرحلة 4 من 4: الأجزاء

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

قم ببنائه بنفسك: بيانات الاعتماد والاستدعاء من الخارج

لإنشاء هذا بنفسك، تحتاج إلى بيانات اعتماد اثنتين، وكلاهما كمصادقة رأسية في n8n. تختار مفتاح الويب هوك الخاص بك بنفسك، مع اسم رأس مخصص. بالنسبة لـ PaperOffice، تستخدم مفتاح API من حسابك، تحت قسم API والمطورين. يتم إدخاله في رأس المصادقة (Authorization). من الخارج، تستدعي سير العمل بإرسال طلب POST إلى عنوان URL للويب هوك: الملف في حقل الملف، والمفتاح في الرأس. يمكن أن يكون ذلك سكريبتًا، أو برنامجًا آخر، أو سير عمل ثانٍ. ما يعود هو قائمة المستندات، جاهزة للخطوة التالية. ثلاث نصائح من الممارسة العملية: أولاً: لا تحتاج إلى أوراق فاصلة؛ حيث يكتشف Split Agent الحدود من المحتوى. ثانياً: تضبط قاعدة التسمية في حقل تعليمات التسمية، على سبيل المثال التاريخ، المرسل، نوع المستند. وثالثاً: قم بتنزيل الأجزاء فوراً أو أرشفتها مباشرة، لأن الروابط تنتهي صلاحيتها بعد وقت قصير. كان هذا هو Split Agent في n8n: ويب هوك، استدعاء، حلقة تكرارية وقائمة. في PaperOffice، يمكنك أيضاً استخدامه مباشرة عند الرفع. يعرض الفيديو الرئيسي لصندوق الوارد كيف تستمر المستندات الفردية من هناك. إلى اللقاء القادم في أكاديمية PaperOffice AI.