موصّل n8n
تتيح لك عقدة مجتمع Entity Enricher لـ n8n بناء خطوط أنابيب إثراء آلية باستخدام محرر مرئي بالسحب والإفلات. اتصل بأكثر من 400 تطبيق دون كتابة أي كود.
التثبيت
ثبّت عقدة المجتمع في نسخة n8n الخاصة بك:
npm install n8n-nodes-entity-enricher
أو ثبّته عبر واجهة n8n: انتقل إلى الإعدادات ← عُقد المجتمع وابحث عن n8n-nodes-entity-enricher.
المتطلبات الأساسية
ent_XXXXXXXXXXXX.https://entityenricher.ai أو عنوان URL المُستضاف ذاتيًا).العمليات المتاحة
يوفّر الموصّل 18 عملية موزّعة على 7 فئات من الموارد:
| المورد | عملية | الوصف |
|---|---|---|
| Enrichment | Enrich Entity | أثرِ كياناً واحداً — ما عليك سوى اختيار مخطط؛ ويُختار تلقائياً أفضل نموذج واستراتيجية في مؤسستك. يبثّ النتائج عبر SSE مع تتبّع التقدّم في الوقت الفعلي. |
| Enrichment | Enrich Entity Advanced | أثرِ كياناً واحداً مع تحكّم كامل في النماذج والدمج والاستراتيجية والتصنيف والمخرجات المُهيكلة. |
| Enrichment | Batch Enrich | أثرِ جميع عناصر الإدخال كدفعة واحدة باستخدام النموذج والاستراتيجية التلقائيين. معالجة متوازية مع تتبّع التقدّم لكل كيان. |
| Enrichment | Batch Enrich Advanced | أثرِ جميع عناصر الإدخال كدفعة واحدة باستخدام مجموعة المعاملات الكاملة. |
| Schema | List Schemas | عرض المخططات المحفوظة المتاحة للاختيار في سير عمل الإثراء. |
| Schema | Get Schema Details | استرجاع المحتوى الكامل للمخطط مع الخصائص الرئيسية المستخرجة لمخطط محدد. |
| Schema | Generate Sample | وَلِّد من 1 إلى N كائن JSON واقعي كعينات من نوع كيان واحد في مهمة واحدة — وهي نقطة الدخول إلى حلقة تأليف المخطط. وتكون اللغة تلقائية افتراضيًا، تُستنتَج من كلمات طلبك أنت. |
| Schema | Generate Schema | وَلِّد مخطط JSON واحفظه تلقائيًا — كل عنصر مُدخَل هو عينة من نوع الكيان نفسه: اتحاد الحقول، وقابلية القيمة العدمية حين يغيب حقل في بعض العينات، وقيم حقيقية مرصودة كأمثلة. ويحدد خيار اللغة اللغةَ التي يصف بها المخطط نفسه. |
| Record | List Records | استعلم عن سجلات الإثراء باستخدام مرشحات النوع والنجاح. نتائج مقسّمة إلى صفحات. |
| Record | Get Record | استرجاع نتيجة إثراء محددة بواسطة المعرّف مع مخرجات مُهيكلة كاملة. |
| Record | Sync Records to Database | أرسِل مخرجات إثراء مخزَّنة (أو محوَّلة) إلى مزامنة قاعدة البيانات الخاصة بمخططها — بعد إعادة التحقق منها وفق العقد المنشور، ثم تمريرها عبر بوابة القبول. |
| Fusion | Merge Results | دمج النتائج من سجلّات إثراء متعددة مع تحكيم اختياري بواسطة LLM. |
| Attachment | Add Attachment | ارفع ملفًا ثنائيًا واحدًا أو أكثر من عنصر الإدخال (طلب متعدد الأجزاء واحد) وأعِد عنصرًا واحدًا لكل معرّف مرفق. |
| Attachment | Delete Attachment | حذف مرفق حسب المعرّف — خطوة تنظيف مفيدة بعد الإثراء. |
| Database Sync | List Database Syncs | اعرض عمليات مزامنة قاعدة البيانات المسجَّلة على مخطط، مع أعداد الفروق المعلّقة. |
| Database Sync | Fetch Deltas | اجلب نافذة FIFO التالية من فروق قاعدة البيانات (SQL + JSON)، مع إمكانية حجزها للتأكيد. |
| Database Sync | Acknowledge Deltas | أكّد الفروق المطبَّقة حتى معرّف مُحدّد — يحرّر الحجز، ووفقًا لخيارات المزامنة، يحذف النسخ المُسلّمة. |
| Configuration | Get Options | جلب النماذج واللغات والاستراتيجيات وحدود الخطط المتاحة للتهيئة الديناميكية. |
عقدة المُطلِق
تتضمّن الحزمة أيضًا عقدة Entity Enricher Trigger منفصلة — مُطلِق webhook يبدأ سير عمل عند أحداث المخطط، ويسجّل اشتراكه تلقائيًا:
بالاقتران مع عمليات Database Sync، يُبقي المُطلِق قاعدة بيانات خارجية متقاربة من n8n وحده — راجع وثائق Database Sync.
إثراء كيان مفرد
أبسط سير عمل: التفعيل عند ورود بيانات جديدة، وإثراء كيان واحد، ودفع النتيجة إلى وجهتك. تنتظر العقدة اكتمال الإثراء بالكامل قبل تمرير المخرجات المُهيكلة إلى المرحلة التالية.
مثال على سير العمل — إثراء كيان واحد:
إعداد العقدة — عملية إثراء الكيان:
التهيئة
تُظهر عمليتا إثراء الكيان والإثراء بالدفعة الافتراضيتان الأساسيات فقط: المخطط ورفع الملف واللغات والبحث على الويب. يعمل Entity Enricher تلقائياً بأفضل نموذج في مؤسستك — النموذج الافتراضي المثبّت لديك، أو النموذج الأعلى تقييماً في اختبار الأداء المرجعي — ويختار استراتيجية الإثراء من مخططك. أما عمليتا إثراء الكيان المتقدّم والإثراء بالدفعة المتقدّم فتُظهران المجموعة الكاملة من الخيارات أدناه.
حدّد مخططًا من القائمة المنسدلة الديناميكية، واختر نموذجًا واحدًا أو أكثر من النماذج، وأدخل بيانات الكيان كحقول مفتاح-قيمة. تملأ العقدة تلقائيًا حقول مفاتيح البحث بناءً على المخطط المحدد.
تشمل الإعدادات الاختيارية الاستراتيجية (مرور واحد أو متعددة الخبرات)، واللغات للمخرجات متعددة اللغات، ونموذج التصنيف للتحقق من نوع الكيان، ونموذج التحكيم لحل التعارضات بين عدة نماذج، ومفاتيح مخطط الاستجابة / المخرجات المنظمة الصارمة التي تفرض مخرجات مطابقة للمخطط على النماذج القادرة.
لإدخال المستندات المصدرية إلى عملية الإثراء، فعّل خيار Upload Input Binary Files: تُحمّل العقدة الملفات الثنائية الخاصة بعنصر الإدخال بوصفها مرفقات في طلب واحد (جميعها، أو فقط تلك المحددة في Binary Fields to Upload)، ومع خيار Delete Uploaded Attachments After Enrichment (مفعّل افتراضيًا) تُنظّفها بمجرد انتهاء الإثراء — دون الحاجة إلى خطوتي Add Attachment / Delete Attachment منفصلتين. وبدلًا من ذلك، يمكنك تزويد حقل Attachment IDs (معرّفات UUID مفصولة بفواصل من استدعاءات Add Attachment السابقة) لإعادة استخدام مستندات حُمّلت مرة واحدة عبر عمليات إثراء متعددة؛ ويمكن الجمع بين المصدرين. كما أنه متاح أيضًا في Batch Enrich، حيث تُجمع الملفات من جميع عناصر الإدخال وتُطبّق على كل كيان في المهمة. وإذا كانت عقدة Edit Fields موجودة بين مصدر الملف وعقدة الإثراء، فعّل مفتاح Include Other Input Fields فيها — وإلا فإنها ستزيل البيانات الثنائية.
الإثراء بالدفعات
عالج جميع عناصر الإدخال كدفعة واحدة. مثالي لإثراء القوائم من جداول البيانات أو قواعد البيانات أو استجابات API. تُعالَج جميع الكيانات بالتوازي مع تحديد المعدّل لكل مزوّد.
إعداد العقدة — عملية الإثراء بالدُّفعات:
كيف تعمل وضعية الدُفعات
- جمع العناصر — تجمع العُقدة كل عناصر الإدخال من العُقدة السابقة (مثل الصفوف من جدول بيانات).
- بدء مهمة الدُّفعة — تُرسَل كل الكيانات عبر
POST /api/batch/startوتُعالَج بالتوازي. - بثّ التقدّم — تستهلك العُقدة تدفّق SSE حتى تكتمل كل الكيانات أو تنتهي المهلة الزمنية.
- نتائج المخرجات — عنصر مخرجات واحد لكل كيان يحتوي على البيانات المنظمة المُثراة، جاهز للمعالجة اللاحقة.
الميزات الرئيسية
العمليات البسيطة والمتقدّمة
تُظهر عمليتا إثراء الكيان والإثراء بالدفعة الافتراضيتان المخطط ورفع الملف واللغات والبحث على الويب فقط — ويُختار أفضل نموذج واستراتيجية تلقائياً. أما العمليتان المتقدّمتان فتمنحان تحكّماً كاملاً في النماذج والدمج والاستراتيجية والمخرجات المُهيكلة.
القوائم المنسدلة الديناميكية
تجلب محدِّدات المخطط والنموذج واللغة والاستراتيجية خياراتها من نسخة Entity Enricher الخاصة بك عند الإعداد.
بث SSE
تستهلك عمليات الإثراء بث SSE في الوقت الفعلي، وتنتظر الاكتمال قبل إعادة النتائج إلى العقدة التالية.
المتابعة التلقائية
عندما يكتشف التصنيف المسبق عدم تطابق، يواصل الموصّل تلقائيًا (فسير عمل n8n غير تفاعلي).
مهلة قابلة للتهيئة
مهلة افتراضية مدتها 300 ثانية لكل طلب إثراء، قابلة للتعديل لكل عقدة للمخططات الكبيرة أو النماذج البطيئة.
دعم النماذج المتعددة
حدّد عدة نماذج لكل عملية إثراء. عند استخدام نموذجين أو أكثر، تُدمج النتائج تلقائيًا.
تنظيف المخرجات افتراضيًا
يحتوي الناتج افتراضيًا على حقول البيانات المُثرَاة فقط. فعِّل خيار "تضمين البيانات الوصفية للإثراء" لإضافة التكلفة والرموز وتفاصيل الدمج ومعرّفات السجلات.
المخرجات لكل نموذج
يمكنك اختياريًا إخراج نتائج كل نموذج على حدة إلى جانب النتيجة المدموجة للمقارنة لاحقًا.
إدراك حدود الخطة
تعرض القوائم المنسدلة للنموذج واللغة حدود الخطة عند تكوينها. وتظهر أخطاء HTTP 402 الناتجة عن فرض الحصة كرسائل واضحة وقابلة للتنفيذ مع تفاصيل الحد. ويتضمن مخرج البيانات الوصفية حدود الخطة الحالية للتوجيه اللاحق.
استخدمه من وكيل ذكاء اصطناعي، أو ابدأ من مثال
أداة لوكيل ذكاء اصطناعي
يمكن إرفاق عقدة Entity Enricher بـAI Agent في n8n كأداة، فيقرّر الوكيل بنفسه متى يُثري كيانًا أو يجلب مخططًا أثناء المحادثة. أما عقدة المُشغِّل فلا تُتاح بهذه الطريقة عن قصد — فالمُشغِّل يبدأ سير عمل، وليس شيئًا يستدعيه الوكيل.
ستة مسارات عمل قابلة للاستيراد
تتضمّن الحزمة ملفات سير عمل جاهزة — إثراء مفرد، ودفعة، ومن مستند إلى إثراء، ومن صورة إلى عيّنة إلى مخطط، ومن عيّنات إلى مخطط، وتفريغ تغذية الفروق إلى PostgreSQL. استورد أحدها واستبدل به بيانات اعتمادك الخاصة بدلًا من إعداده من الصفر.
أفكار سير العمل
الأنماط الشائعة لبناء خطوط معالجة الإثراء باستخدام n8n: