موصّل n8n - وثائق Entity Enricher

موصّل n8n

تتيح لك عقدة مجتمع Entity Enricher لـ n8n بناء خطوط أنابيب إثراء آلية باستخدام محرر مرئي بالسحب والإفلات. اتصل بأكثر من 400 تطبيق دون كتابة أي كود.

التثبيت

ثبّت عقدة المجتمع في نسخة n8n الخاصة بك:

npm install n8n-nodes-entity-enricher

أو ثبّته عبر واجهة n8n: انتقل إلى الإعدادات ← عُقد المجتمع وابحث عن n8n-nodes-entity-enricher.

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

مفتاح API— أنشئ مفتاح وصول للمؤسسة في Entity Enricher. راجع وثائق مفاتيح API للاطلاع على التفاصيل. صيغة المفتاح هي ent_XXXXXXXXXXXX.

عنوان URL الأساسي— عنوان URL الخاص بنسخة Entity Enricher لديك (مثل https://entityenricher.ai أو عنوان URL المُستضاف ذاتيًا).

إعداد بيانات الاعتماد— في n8n، أنشئ بيانات اعتماد Entity Enricher API باستخدام مفتاح API وعنوان URL الأساسي. ستستخدم جميع العُقد بيانات الاعتماد هذه.

العمليات المتاحة

يعرض الموصّل 10 عمليات عبر 6 فئات موارد:

المورد	عملية	الوصف
Enrichment	Enrich Entity	إثراء كيان واحد بنموذج ذكاء اصطناعي واحد أو أكثر. يبثّ النتائج عبر SSE مع تتبّع التقدّم في الوقت الفعلي.
Enrichment	Batch Enrich	إثراء جميع عناصر الإدخال كدفعة واحدة. معالجة متوازية مع تتبّع التقدّم لكل كيان.
Schema	List Schemas	عرض المخططات المحفوظة المتاحة للاختيار في سير عمل الإثراء.
Schema	Get Schema Details	استرجاع المحتوى الكامل للمخطط مع الخصائص الرئيسية المستخرجة لمخطط محدد.
Record	List Records	استعلم عن سجلات الإثراء باستخدام مرشحات النوع والنجاح. نتائج مقسّمة إلى صفحات.
Record	Get Record	استرجاع نتيجة إثراء محددة بواسطة المعرّف مع مخرجات مُهيكلة كاملة.
Fusion	Merge Results	دمج النتائج من سجلّات إثراء متعددة مع تحكيم اختياري بواسطة LLM.
Attachment	Add Attachment	رفع خاصية ثنائية من عنصر الإدخال (multipart) وإرجاع معرّف المرفق الخاص بها.
Attachment	Delete Attachment	حذف مرفق حسب المعرّف — خطوة تنظيف مفيدة بعد الإثراء.
Configuration	Get Options	جلب النماذج واللغات والاستراتيجيات وحدود الخطط المتاحة للتهيئة الديناميكية.

إثراء كيان مفرد

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

مثال على سير العمل — إثراء كيان واحد:

إعداد العقدة — عملية إثراء الكيان:

إعدادات عقدة Entity Enricher للإثراء المفرد

التهيئة

حدّد مخططًا من القائمة المنسدلة الديناميكية، واختر نموذجًا واحدًا أو أكثر من النماذج، وأدخل بيانات الكيان كحقول مفتاح-قيمة. تملأ العقدة تلقائيًا حقول مفاتيح البحث بناءً على المخطط المحدد.

تشمل الإعدادات الاختيارية الاستراتيجية (مرور واحد أو متعددة الخبرات)، واللغات للمخرجات متعددة اللغات، ونموذج التصنيف للتحقق من نوع الكيان، ونموذج التحكيم لحل التعارضات بين عدة نماذج، ومفاتيح مخطط الاستجابة / المخرجات المنظمة الصارمة التي تفرض مخرجات مطابقة للمخطط على النماذج القادرة.

زوّد حقل معرّفات المرفقات (معرّفات UUID مفصولة بفواصل من استدعاءات إضافة مرفق السابقة) لتغذية المستندات المصدرية في عملية الإثراء — متاح أيضًا في الإثراء بالدفعة.

الإثراء بالدفعات

عالج جميع عناصر الإدخال كدفعة واحدة. مثالي لإثراء القوائم من جداول البيانات أو قواعد البيانات أو استجابات API. تُعالَج جميع الكيانات بالتوازي مع تحديد المعدّل لكل مزوّد.

إعداد العقدة — عملية الإثراء بالدُّفعات:

إعدادات عقدة Entity Enricher للإثراء بالدفعات

كيف تعمل وضعية الدُفعات

جمع العناصر — تجمع العُقدة كل عناصر الإدخال من العُقدة السابقة (مثل الصفوف من جدول بيانات).
بدء مهمة الدُّفعة — تُرسَل كل الكيانات عبر POST /api/batch/start وتُعالَج بالتوازي.
بثّ التقدّم — تستهلك العُقدة تدفّق SSE حتى تكتمل كل الكيانات أو تنتهي المهلة الزمنية.
نتائج المخرجات — عنصر مخرجات واحد لكل كيان يحتوي على البيانات المنظمة المُثراة، جاهز للمعالجة اللاحقة.

الميزات الرئيسية

القوائم المنسدلة الديناميكية

تجلب محدِّدات المخطط والنموذج واللغة والاستراتيجية خياراتها من نسخة Entity Enricher الخاصة بك عند الإعداد.

بث SSE

تستهلك عمليات الإثراء بث SSE في الوقت الفعلي، وتنتظر الاكتمال قبل إعادة النتائج إلى العقدة التالية.

المتابعة التلقائية

عندما يكتشف التصنيف المسبق عدم تطابق، يواصل الموصّل تلقائيًا (فسير عمل n8n غير تفاعلي).

مهلة قابلة للتهيئة

مهلة افتراضية مدتها 300 ثانية لكل طلب إثراء، قابلة للتعديل لكل عقدة للمخططات الكبيرة أو النماذج البطيئة.

دعم النماذج المتعددة

حدّد عدة نماذج لكل عملية إثراء. عند استخدام نموذجين أو أكثر، تُدمج النتائج تلقائيًا.

تنظيف المخرجات افتراضيًا

يحتوي الناتج افتراضيًا على حقول البيانات المُثرَاة فقط. فعِّل خيار "تضمين البيانات الوصفية للإثراء" لإضافة التكلفة والرموز وتفاصيل الدمج ومعرّفات السجلات.

المخرجات لكل نموذج

يمكنك اختياريًا إخراج نتائج كل نموذج على حدة إلى جانب النتيجة المدموجة للمقارنة لاحقًا.

إدراك حدود الخطة

تعرض القوائم المنسدلة للنموذج واللغة حدود الخطة عند تكوينها. وتظهر أخطاء HTTP 402 الناتجة عن فرض الحصة كرسائل واضحة وقابلة للتنفيذ مع تفاصيل الحد. ويتضمن مخرج البيانات الوصفية حدود الخطة الحالية للتوجيه اللاحق.

أفكار سير العمل

الأنماط الشائعة لبناء خطوط معالجة الإثراء باستخدام n8n:

إثراء CRM— شغّله عند إضافة جهات اتصال جديدة في HubSpot/Salesforce، وأثرِها ببيانات الشركة، وحدّث سجل CRM.

خط معالجة جداول البيانات— اقرأ الكيانات من Google Sheets، وأثرِها على دفعات، واكتب النتائج في ورقة جديدة.

الإثراء المتتالي— اربط خطوات إثراء متعددة بمنطق شرطي — استخدم نموذجاً سريعاً أولاً، ثم أعد إثراء حالات الفشل بنموذج أكثر قدرة.

تحديث مجدول— التشغيل وفق جدول cron لإعادة إثراء السجلات القديمة بأحدث نماذج الذكاء الاصطناعي.

مُشغَّل عبر Webhook— اعرض نقطة نهاية webhook تقبل بيانات الكيان وتثريها وتُعيد النتيجة بشكل متزامن.