استخدم Entity Enricher من عميل متوافق مع MCP لتحويل معارف النماذج والمستندات إلى بيانات منظّمة. صمّم المخططات، وأثرِ الكيانات بلغات متعددة، وادمج النماذج، ونسّق الهويات الدلالية، وقِس الجودة عبر اختبارات مرجعية، وزامن الجداول العلائقية مع قاعدة بياناتك الخاصة.
لا يضمن التحقق من صحة المخطط ولا توافق النماذج فيما بينها دقة المعلومات أو حداثتها. افحص المصادر والإخفاقات ونتائج قاعدة البيانات الجزئية. يوفّر MCP وصولًا حواريًا، بينما يوفّر n8n وMake أتمتة سير العمل على الخدمة نفسها.
لأجل claude.ai وClaude Code وCursor وأي عميل MCP يدعم مسار OAuth القياسي. لا حاجة لإنشاء مفتاح API أو لصقه — إذ يكتشف العميل خادم التفويض تلقائيًا.
https://entityenricher.ai/api/mcp/.للعملاء الذين يُضبطون عبر ملف JSON بدلًا من تسجيل دخول تفاعلي (Claude Desktop وContinue وZed).
ent_… — فهي تُعرض مرة واحدة فقط.بالنسبة إلى Claude Desktop، عدّل ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) أو %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"entityenricher": {
"url": "https://entityenricher.ai/api/mcp/",
"headers": { "X-API-Key": "ent_your_key_here" }
}
}
}استخدم نقطة النهاية والترويسة أعلاه ضمن إعدادات MCP البعيدة في عميلك. تعتمد صيغة الإعداد ودعم نقل HTTP على العميل.
في محادثة جديدة: «اعرض مخططات Entity Enricher الخاصة بي، ثم أثرِ Sanofi وفق مخطط شركة الأدوية باستخدام Claude Sonnet.»يمكن للعميل اكتشاف الأدوات واستخدامها لاختيار مخطط وتشغيل الإثراء. أما مطالبات التأكيد وعرض التقدّم والوصول إلى الموارد فتعتمد على العميل.
تغطي أدوات 58 تأليف المخططات والإثراء والاختبارات المرجعية ومزامنة قاعدة البيانات والهويات الدلالية. وهي تعيد استخدام خدمات الواجهة الخلفية للتحقق والفوترة والمعالجة. وتكشف كل أداة المعاملات المدعومة الخاصة بها. أما الأعمال طويلة التنفيذ (الإثراء بالدفعات، وتوليد العينات، وتشغيل الاختبارات المرجعية) فغير متزامنة: تُرجع أداة البدء job_id، ويستعلم العميل get_job_statusثم يقرأ السجلات الناتجة أو نتائج الاختبار المرجعي. افحص حالات الفشل والنتائج الجزئية قبل الإبلاغ عن النجاح.
| الفئة | أداة | الوصف |
|---|---|---|
| الاكتشاف | list_models | عرض مفاتيح النماذج المتاحة والقدرات الاسمية واللغات والاستراتيجيات والإعدادات الافتراضية المحددة تلقائيًا وقيم profile_limits للمؤسسة. |
| المخططات | generate_sample | ولّد عينة JSON قابلة للتحرير من طلب نصي حر لتأليف المخططات. |
| المخططات | list_schemas | عرض المخططات المحفوظة في مؤسستك، بدءًا من المثبّتة. |
| المخططات | get_schema | قراءة مخطط محفوظ مع خصائصه وتعليقاته التوضيحية وقيمة input_contract. |
| المخططات | create_schema_from_sample | ولّد مخططًا واحفظه تلقائيًا انطلاقًا من عينات مراجَعة، مع إرجاع schema_id ومحتوى المخطط وروابط السجلات. |
| المخططات | save_schema | احفظ مخططًا مُحرَّرًا مباشرةً وأعِد معرّفه ورابطه. |
| المخططات | update_schema | عدّل البيانات الوصفية لمخطط محفوظ أو استبدل محتواه schema_content بالكامل دون استدعاء LLM. |
| المخططات | get_schema_part | قراءة جزء المخطط اللازم للتعديل فقط. |
| المخططات | get_enum_candidates | عرض القيم المرصودة خارج المفردات الحالية لكل تعداد مفتوح، مع الأعداد المستمدة من سجلات الإثراء الأخيرة. |
| المخططات | update_schema_property | عدّل خاصية واحدة أو احذفها عبر مسارها دون استبدال المخطط بالكامل. |
| المخططات | add_schema_property | أضف خاصية تحت الجذر (parent_path=') أو تحت مسار كائن أو '$defs.X'. |
| المخططات | move_schema_property | نقل خاصية واحدة إلى الجذر أو إلى مسار كائن أو إلى '$defs.X'، مع الحفاظ على أعلامها وخبرتها. |
| المخططات | resolve_unify_proposal | البتّ في اقتراح معلّق واحد لتوحيد نوع كيان وارد من get_schema. |
| المخططات | nest_schema_region | تداخُل منطقة كيان مسطّحة من x-entityMap الخاص بـ get_schema داخل كائن فرعي ضمن الكائن الذي يحمل حقولها: الأعضاء المسطّحة للمنطقة (مثل product_id وproduct_name في طلب… |
| المخططات | publish_schema | نشر النسخة العاملة لمخطط مرتبط بقاعدة بيانات بوصفها العقد المستخدَم في الإثراء والنسخ المتماثلة. |
| المخططات | delete_schema | احذف مخططًا محفوظًا حذفًا مؤقتًا حسب UUID. |
| المخططات | analyze_sample | حلّل غموض خصائص العينة ونطاق هوية العلاقات قبل توليد المخطط. |
| المخططات | analyze_schema | حلّل غموض خصائص مخطط محفوظ ونطاق هوية العلاقات، مع كتابة التعليقات التوضيحية في المخطط. |
| الإثراء والدمج | start_batch_enrichment | ابدأ إثراءً غير متزامن ومدفوعًا لقائمة كيانات مقابل واحد فقط من schema_id أو target_schema. |
| الإثراء والدمج | fetch_entities | اجلب الكيانات من API REST خارجي عبر طلب GET من جهة الخادم. |
| الإثراء والدمج | enrich_entity | أثرِ كيانًا واحدًا مقابل schema_id أو target_schema حصرًا (أحدهما فقط)، مع إرجاع مخرجات مهيكلة وrecord_id والتكاليف وأي نتيجة تخص قاعدة البيانات. |
| الإثراء والدمج | retry_expertises | إعادة محاولة مجالات الخبرة الفاشلة فقط في سجل قائم، ثم تحديث مخرجاته ومحاولة إجراء الدمج/المزامنة الخاصة بالتشغيل. |
| الإثراء والدمج | merge_records | ادمج سجلين أو أكثر للكيان نفسه في سجل تحكيم جديد. |
| التحكم في المهام | get_job_status | قراءة حالة المهمة وتقدّمها والملخص النهائي المختصر مع معرّفات السجلات المحفوظة. |
| التحكم في المهام | cancel_job | طلب إلغاء مهمة LLM معلّقة أو قيد التشغيل أو متوقفة مؤقتًا. |
| التحكم في المهام | answer_job_question | استئناف مهمة متوقفة مؤقتًا بتقديم إجابات عن الأسئلة المُعادة أثناء الإيقاف المؤقت. |
| السجلات والإحصاءات | list_records | عرض سجلات مختصرة ومقسّمة إلى صفحات في مؤسستك، بدءًا من الأحدث. |
| السجلات والإحصاءات | get_record | قراءة قيم structured_output وentity_input_data وأخطاء التحقق وأحكام مجالات الخبرة والمقاييس لسجل محفوظ واحد. |
| السجلات والإحصاءات | get_stats | قراءة إجماليات السجلات على مستوى المؤسسة ومعدل النجاح والرموز وملخص التكلفة. |
| المعايير المرجعية | list_benchmark_scenarios | عرض ملخصات مختصرة لسيناريوهات قياس الأداء مع الإجمالي. |
| المعايير المرجعية | get_benchmark_scenario | قراءة سيناريو قياس أداء واحد مع نتائج الجودة والتكلفة والسرعة لكل نموذج. |
| المعايير المرجعية | get_benchmark_scenario_results | رشّح نتائج الاختبار المرجعي لكل نموذج في سيناريو ما، ورتّبها، وحدّد عددها. |
| المعايير المرجعية | create_benchmark_scenario | أنشئ اختبارًا مرجعيًا قابلًا لإعادة الاستخدام مع حَكَم تقييم إلزامي. |
| المعايير المرجعية | update_benchmark_scenario | عدّل تعريف اختبار مرجعي أو إعدادات تقييمه. |
| المعايير المرجعية | set_benchmark_reference | احفظ المرجع الذهبي لاختبار مرجعي للإثراء أو لتوليد المخططات. |
| المعايير المرجعية | delete_benchmark_scenario | احذف سيناريو اختبار مرجعي ونتائجه المخزَّنة. |
| المعايير المرجعية | run_benchmark | ابدأ تنفيذًا وتقييمًا غير متزامنين ومدفوعين لاختبار مرجعي. |
| المرفقات | upload_attachment | ارفع بايتات الملف بترميز base64 كمادة مصدرية قابلة لإعادة الاستخدام؛ تُعاد القيمتان id وrequires_capability. |
| المرفقات | delete_attachment | حذف مرفق في مؤسستك نهائيًا، بما في ذلك ملفه المخزَّن. |
| Database Sync | list_database_syncs | عرض تسجيلات قاعدة البيانات والمخططات المرتبطة والخيارات ومضيفي المزامنة لمخطط محفوظ. |
| Database Sync | list_entity_states | استعرض صفوف الكيانات المدمَجة الحالية لمخطط ما، لا سجلات كل تشغيل على حدة. |
| Database Sync | create_database_sync | تسجيل مخطط محفوظ للمزامنة العلائقية مع PostgreSQL أو MySQL أو SQLite. |
| Database Sync | assign_sync_host | عيّن أو أزل المضيف الذي يوفّر مزامنة قاعدة البيانات. |
| Database Sync | classify_database_model | ابدأ تحليلًا مدفوعًا يقترح مفاتيح قاعدة البيانات وأنواع SQL والفهارس وملكية العلاقات على مخطط مرتبط. |
| Database Sync | delete_database_sync | احذف تسجيل قاعدة بيانات والفروق المنتظرة في طابورها، ما يوقف تغذيتها. |
| Database Sync | create_database_credential | إصدار بيانات اعتماد لمرة واحدة لعميل المزامنة مع اقتراحات أوامر التثبيت والإقران والتشغيل. |
| Database Sync | fetch_database_deltas | قراءة النافذة المرتبة التالية من فروق SQL والحمولات المعيارية لمزامنة قاعدة بيانات. |
| Database Sync | ack_database_deltas | أكّد استلام كل فرق (delta) عبر up_to_id بعد تطبيقه بنجاح، ما يحرّر حجزه. |
| Database Sync | sync_records_to_database | تحقّق من صحة مخرجات الإثراء المخزّنة أو المُقدَّمة وأدخِلها في طبقة الكيانات وعمليات المزامنة المرتبطة. |
| المعرّفات الدلالية | list_semantic_concepts | استعرض مفاهيم المؤسسة مع الأسماء المستعارة وعدد مرات الاستخدام وأوجه النوع/النموذج. |
| المعرّفات الدلالية | get_semantic_concept | قراءة الأسماء البديلة لمفهوم واحد ومفاتيح مصدر الهوية والسجلات المرتبطة وأقرب الجيران ضمن شريحة نوعه/نموذجه. |
| المعرّفات الدلالية | probe_semantic_concept | معاينة تحليل الهوية دون إضافة مفهوم أو زيادة استخدامه. |
| المعرّفات الدلالية | add_semantic_concept | أضف مفهوم هوية باستخدام صفري، أو أضف نصًا كاسم مستعار عبر alias_of. |
| المعرّفات الدلالية | update_concept_alias | إزالة اسم بديل لمفهوم أو ترقيته باستخدام معرّفات الأسماء البديلة من get_semantic_concept. |
| المعرّفات الدلالية | import_semantic_concepts | تحليل من 1 إلى 1000 نص مقابل نوع مفهوم واحد. |
| المعرّفات الدلالية | merge_semantic_concepts | دمج مفهوم خاسر في مفهوم فائز. |
| المعرّفات الدلالية | delete_semantic_concepts | احذف المفاهيم المحدَّدة عبر ids أو concept_types أو unused_only. |
| المعرّفات الدلالية | migrate_semantic_embeddings | فحص فضاء تضمين المفاهيم الخاص بالمؤسسة أو ترحيله. |
تشرح تعليمات الخادم سير العمل المتاح، بينما تشرح أوصاف الأدوات كل استدعاء على حدة. لاتخاذ قرارات النمذجة أو للتعافي، يمكن لعميلك قراءة فهرس الأدلة على enricher://docs واختيار دليل عبر موارد MCP. قراءة الدليل لا تُشغّل أي نموذج. تفتح الروابط أدناه الأدلة الإنجليزية نفسها في المستودع العام.
صمّم مخططًا قابلًا لإعادة الاستخدام انطلاقًا من أمثلة مراجَعة، بما يشمل الهوية والعلاقات والحقول متعددة اللغات.
قراءة مستندات مخططات Entity Enricher وإنشاؤها وتعديلها دون الخلط بين JSON Schema المُسلسل والبيانات النموذجية ومسارات أدوات الخصائص.
اختر الاستخراج أو الإثراء المعرفي أو مزيجًا من مرحلتين، مع الحفاظ على مصدر المرفقات عبر الاستدعاءات.
أثرِ كيانًا، وفسّر نتيجته الفعلية، وعالج حالات فشل النماذج الجزئية دون تكرار العمل الناجح.
أثرِ قائمة كيانات بشكل غير متزامن، وميّز بين النتائج المتخطَّاة والفاشلة والمدمَجة والمقبولة في قاعدة البيانات.
قارن النماذج في الإثراء أو توليد العينات أو توليد المخططات، باستخدام المرجع الصحيح والتفسير الصحيح للدرجات.
حوِّل مخططات الإثراء إلى جداول علائقية في قاعدة بياناتك الخاصة، وتحقّق من القبول والترحيل وتسليم النسخة المطابقة كلٌّ على حدة.
التعرّف على الكيانات المتكررة عبر أشكالها السطحية، ومراجعة التطابقات غير المؤكدة، وفهم أثر تغييرات المفردات على النسخ المتماثلة.
تعرض الموارد بيانات المخططات والسجلات إضافةً إلى أدلة سير العمل بصيغة Markdown. ويختار العملاء طريقة اكتشافها وتحميلها؛ ومع ذلك قد يستهلك محتوى الموارد سياق النموذج.
| قالب URI | الوصف |
|---|---|
| enricher://docs | فهرس أدلة سير العمل، وكل دليل متاح على عنوان URI المورد المذكور له. |
| enricher://schemas/{schema_id} | نسخة عمل من مخطط محفوظ بصيغة Markdown؛ استخدم get_schema مع version="published" للحصول على العقد المرتبط النشط. |
| enricher://records/{record_id} | سجل إثراء سابق معروض بصيغة Markdown — بيانات وصفية + مخرجات منظَّمة + أخطاء تحقق. |
عندما تطلب من enrich_entity استخدام نموذج تصنيف ولا تتطابق الكينونة مع نوع المخطط، تُعيد الأداة استجابة غير مخطئة مع تفاصيل مُهيكلة. يقرؤها Claude، ويُظهر لك سبب القرار، و(بعد تأكيدك) يعيد المحاولة باستخدام force_after_classification_warning=true — الذي يُسقط المُصنِّف عند إعادة المحاولة.
{
"success": false,
"error_code": "classification_warning",
"message": "Pre-flight classification rejected the entity. ...",
"classification": {
"status": "mismatch",
"reasoning": "Titan is a moon of Saturn, not a planet.",
"confidence": 0.97
},
"job_id": "..."
}تحتفظ استجابة MCP بتفاصيل التصنيف ليتمكن عميلك من شرح القرار قبل بدء استدعاء جديد.
يُشغِّل التفاعل نفسه تدفقًا ثانيًا: عندما يعمل generate_sample مع مستندات مصدرية، قد يتوقف مخطِّطه مؤقتًا لطرح أسئلة توضيحية بنيوية. ينقلها Claude إليك ويستأنف المهمة باستخدام answer_job_question — جولة تلو الأخرى، حتى يتم توليد العينة.
تُعيد معظم أخطاء الأدوات كائنًا منظمًا يتضمن حقل error_code ليتمكن العميل من التمييز بين أعطال الحصة والتصنيف والمهلة والمزوّد. وتحمل بعض الاستجابات الأقدم حقل error أو message فقط؛ افحص النتيجة الفعلية إضافةً إلى حالة النقل.
| error_code | متى |
|---|---|
| invalid_request | معرّف UUID غير صالح، أو وسائط متنافية (schema_id + target_schema)، أو فشل التحقق من صحة نص الطلب. |
| prompt_limit_reached | استُنفدت حصة الموجّهات اليومية / الأسبوعية / الشهرية (HTTP 402). يتضمّن المحتوى الفترة والحدّ والمستخدَم والمطلوب. |
| insufficient_credits | المؤسسة قد فعّلت الفوترة لكن رصيدها منخفض جدًا لبدء المهمة (HTTP 402). يتضمن المتن الرصيد ورابط الشراء. |
| model_limit_exceeded | تم طلب عدد نماذج أكبر مما تسمح به الخطة (HTTP 402). يردّد الحد الأقصى والعدد المطلوب. |
| language_limit_exceeded | تم طلب عدد لغات أكبر مما تسمح به الخطة (HTTP 402). |
| concurrent_job_limit_reached | عدد كبير جدًا من مهام الإثراء النشطة لهذه المؤسسة. انتظر أو قم بترقية الخطة. |
| classification_warning | ⚡ ليست خطأً: رفض المصنّف التمهيدي الكيان. تحمل الاستجابة سياق التصنيف كي يتمكن Claude من طلب التأكيد من المستخدم وإعادة المحاولة باستخدام force_after_classification_warning=true. |
| benchmarks_not_in_plan | لا تتضمن خطة المؤسسة الاختبارات المرجعية للنماذج (HTTP 403). كما تتحقق أدوات الاختبار المرجعي التي تُجري تعديلات من دور المالك. |
| ambiguity_check_disabled | تم استدعاء analyze_schema على مخطط فحص الالتباس فيه معطَّل (HTTP 400). أعِد تفعيله أولًا عبر update_schema مع ambiguity_check_enabled=true. |
| enrichment_timeout | تجاوزت المهمة timeout_seconds. نقترح تقليل عدد النماذج أو تقسيم الكيان. |
| schema_generation_timeout | تجاوز توليد المخطط timeout_seconds. |
| schema_generation_failed | خطأ في LLM المصدر أثناء توليد المخطط (HTTP 502). |
| model_output_invalid | أرجع النموذج مخرجات لا تطابق الـ schema (HTTP 502). يذكر المتن اسم النموذج، ومسار الخاصية المخالفة، وretryable: true — استدعِ الأداة مرة أخرى، أو اختر نموذجاً أقوى. |
| cancelled | أُلغيت المهمة أثناء التشغيل (HTTP 499). |
| not_found | معرّف المخطط أو السجل غير موجود في مؤسستك. |
| http_error | معالج شامل لأخطاء HTTP التي لا تحتوي على نص تفاصيل مهيكل. |
get_stats الملخصات على جانب المحادثة؛ أما لوحات المعلومات الكاملة فتبقى في التطبيق.