خادم MCP (claude.ai / Claude Desktop / Code / Cursor) - وثائق Entity Enricher

خادم MCP (Claude Desktop / Code / Cursor)

يأتي Entity Enricher مزوّدًا بخادم Model Context Protocol مضمّن على /api/mcp — اعرض قائمة مخططاتك، وأثرِ كيانًا، وافحص النتيجة، وعالِج تحذير تصنيف كل ذلك من داخل محادثة Claude واحدة. دون الحاجة إلى محرّر لسير العمل.

لماذا MCP، بينما يوجد بالفعل n8n + Make؟

شكل مختلف، وحالة استخدام مختلفة. يغلّف موصّلا n8n وMake واجهة الـ API من أجل أتمتة سير العمل: المشغّلات، والتشغيلات المجدولة، والمسارات متعددة الخطوات، والحالة الدائمة. أما MCP فيغلّفها من أجل المحادثة التفاعلية: الأسئلة الفورية، وعمليات الإثراء الاستكشافية، والتوضيحات اللاحقة. سير العمل ذو طابع الدُفعات، والمحادثات ذات طابع الحوار — يختلف السطح وتختلف تجربة المستخدم.

الميزة الأبرز التي لا يفتحها سوى MCP: استئناف التصنيف التفاعلي. عندما يرفض مُصنِّف ما قبل التشغيل كيانك (مثلاً طلبت إثراء "Titan" مقابل مخطّط لكوكب، لكن Titan قمر)، يضطر n8n/Make إلى الإلغاء التلقائي لأنهما غير تفاعليين. أما MCP فيُظهِر التحذير إلى Claude، فيطلب منك Claude التأكيد، وعند "نعم" تُعاد الأداة دون المُصنِّف. لا فشل في منتصف المسار، ولا إعادة تشغيل من البداية.

البدء السريع

الخيار 1 — OAuth (مُوصى به)

لأجل claude.ai وClaude Code وCursor وأي عميل MCP يدعم مسار OAuth القياسي. لا حاجة لإنشاء مفتاح API أو لصقه — إذ يكتشف العميل خادم التفويض تلقائيًا.

  1. أضف Entity Enricher كموصِّل (في claude.ai: Settings → Connectors → Add custom connector، أو اختره من الدليل) باستخدام الرابط https://entityenricher.ai/api/mcp/.
  2. يفتح متصفحك شاشة الموافقة الخاصة بـ Entity Enricher — سجّل الدخول إن لزم الأمر ثم انقر Authorize. ويعمل الاتصال نيابةً عنك بدورك الخاص.
  3. يمكنك إدارة الاتصال أو إلغاؤه في أي وقت من API Keys → Connected Apps — ويؤدي الإلغاء إلى قطع الوصول فورًا.

الخيار 2 — مفتاح API (تهيئة JSON ثابتة)

للعملاء الذين يُضبطون عبر ملف JSON بدلًا من تسجيل دخول تفاعلي (Claude Desktop وContinue وZed).

  1. 1. إنشاء مفتاح API
    في واجهة الويب لـ Entity Enricher: الإعدادات ← مفاتيح API ← مفتاح وصول جديد للمؤسسة. اختر دورًا (مشغّل للقراءة غالبًا، محرِّر لإنشاء/تعديل المخططات، مالك للتحكم الكامل). انسخ قيمة ent_… — فهي تُعرض مرة واحدة فقط.
  2. 2. سجّل في عميل MCP الخاص بك

    بالنسبة إلى 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" }
        }
      }
    }

    أعد تشغيل Claude Desktop. يعمل المقتطف نفسه مع Claude Code وCursor وContinue وZed — أي عميل متوافق مع MCP.

جرّبه

في محادثة جديدة: "اعرض مخططات Entity Enricher الخاصة بي، ثم أثرِ Sanofi وفق مخطط شركة الأدوية باستخدام Claude Sonnet." يكتشف Claude الأدوات تلقائيًا، ويختار الأداة المناسبة، ويطلب منك تأكيد اختيار النموذج والمخطط، ويبث النتيجة ضمن المحادثة.

الأدوات

تغطي 54 أداة كامل مفردات الإثراء وتأليف المخططات ومزامنة قاعدة البيانات والمعرّفات الدلالية. والسلوك مطابق لنقاط نهاية REST التي تغلّفها (التحقق نفسه، والفوترة نفسها، وحدود الخطة نفسها) — فعندما تحصل واجهة الويب على إصلاح، يحصل عليه MCP أيضًا. أما المهام الطويلة (الإثراء بالدفعات، وتوليد العينات، وتشغيل اختبارات الأداء المرجعية) فهي غير متزامنة: تُعيد أداة البدء job_id، ويستعلم Claude من get_job_status، ثم يجلب المخرجات المحفوظة من سجلاتك بمجرد اكتمال المهمة.

الفئةأداةالوصف
الاكتشافlist_modelsاعرض مفاتيح النماذج والقدرات الاسمية والإعدادات الافتراضية المختارة تلقائيًا وحدود profile_limits الخاصة بخطتك. فضّل الاختيار التلقائي: فالتوفر لا يضمن كل حصة مزوّد أو كل وضع مدمج للوسائط/الأدوات.
المخططاتlist_schemasعرض مخططات JSON المحفوظة في مؤسستك، المثبّتة أولًا.
المخططاتget_schemaجلب المحتوى الكامل للمخطط باستخدام UUID.
المخططاتgenerate_sampleأنشئ من 1 إلى N عقد عينة قابلة للتحرير في مهمة واحدة (يحدّد العقد الأول مجموعة الحقول؛ والباقي عبارة عن نسخ سريعة بنفس الحقول) في وضع المعرفة (بدون مرفقات، مع بحث اختياري على الويب) أو وضع المصدر (تُعدّ المرفقات مرجعية وقد يطرح المُخطِّط أسئلة). راجع التعديلات المؤثرة مع المستخدم قبل إنشاء schema.
المخططاتcreate_schema_from_sampleأنشئ schema واحفظه تلقائيًا من entity_samples (من 1 إلى N عينة لنوع كيان واحد — اتحاد الحقول، قابلة لأن تكون فارغة عند غيابها، مع أمثلة حقيقية ملاحَظة)، أو من sample_record_id، أو من بيانات محرَّرة مع مرفقاتها المرتبطة بالسجل. المعرّفات الدلالية اختيارية؛ وتُراجَع الاقتراحات ولا تُطبَّق تلقائيًا أبدًا.
المخططاتsave_schemaاحفظ مخططًا ألّفه Claude مباشرة — دون استدعاء LLM، ودون تكلفة، مع التحقق على جانب الخادم.
المخططاتupdate_schemaإعادة تسمية مخطط محفوظ أو استبدال محتواه أو إعادة وسمه أو تثبيته أو تبديل فحص الالتباس فيه دون أي استدعاء لـ LLM.
المخططاتget_schema_partاقرأ جزءًا من المخطط دون المستند الكامل: فهرس الأنواع المسمّاة، أو تعريفًا من $defs/$enums، أو شجرة فرعية لكائن، أو بطاقة خاصية واحدة مع علاقاتها وأعلامها.
المخططاتupdate_schema_propertyعدّل خاصية واحدة حسب المسار — إعادة التسمية أو النوع أو $ref أو الوصف أو الأمثلة أو الأعلام — أو احذفها، مع تحقق من جانب الخادم؛ دون إرسال المحتوى كاملًا ذهابًا وإيابًا.
المخططاتadd_schema_propertyأضف خاصية قياسية أو كائنًا متداخلًا أو خاصية $ref إلى الجذر أو إلى كائن متداخل أو إلى نوع في $defs.
المخططاتmove_schema_propertyانقل خاصية واحدة إلى حاوية أخرى — الجذر أو كائنًا متداخلًا أو نوعًا في $defs — مع الاحتفاظ بعلاماتها ومجال خبرتها.
المخططاتpublish_schemaانشر النسخة العاملة لمخطط مرتبط بوصفها العقد الذي يعمل الإثراء ومزامنات قاعدة البيانات وفقه. لا تدخل التعديلات البنيوية حيز التنفيذ إلا هنا — ولا ترسل المزامنة المرتبطة حديثاً أي شيء حتى أول نشر لمخططها. validate_only=true يعرض معاينة لفرق الترحيل.
المخططاتanalyze_sampleتحليل عيّنة JSON بحثًا عن أسماء خصائص تحتمل أكثر من قراءة واحدة في سياق العنصر الأب — أو لا تحتمل أي قراءة على الإطلاق — وعن العناصر المرتبطة التي تخلط حقائق الكيان بحقائق خاصة بكل أب. تقرير عديم الحالة يعرض التفسيرات المتنافسة واقتراحات إعادة التسمية؛ دون تعديل أي شيء.
المخططاتanalyze_schemaتشغيل فحصَي الالتباس وتحديد نطاق الهوية على مخطط محفوظ وكتابة تعليقات توضيحية لكل خاصية — وصف معاد صياغته لكل اسم ملتبس، لأنّ المخطط النشط لا يمكن إعادة تسميته. تزايدي افتراضيًا، و force=true يعيد تحليل الكل.
المخططاتdelete_schemaاحذف مخططًا محفوظًا حذفًا مؤقتًا حسب UUID.
الإثراءenrich_entityإثراء متعدد النماذج مع دمج تلقائي اختياري. يقبل قائمة attachment_ids اختيارية. تُعيد حالات عدم تطابق التصنيف استجابة غير خاطئة حتى يتمكّن Claude من مطالبة المستخدم بالتأكيد وإعادة المحاولة.
الإثراءstart_batch_enrichmentأثرِ أي عدد من الكيانات (entities) بشكل غير متزامن — دون حد أقصى ثابت لحجم الدُّفعة (batch)، وضمن حدود حصة الاستخدام الحية لخطتك — مع تنفيذ خط المعالجة الكامل لكل كيان مع دمج (fusion) تلقائي. تُرجع الدالة job_id؛ وتظهر النتائج في سجلّاتك (records).
الإثراءfetch_entitiesاجلب مصفوفة JSON من الكيانات من خادم REST API خارجي على جانب الخادم (مصادقة bearer / api_key / basic) — يقترن بالإثراء بالدفعات.
الإثراءretry_expertisesأعد تشغيل نطاقات الخبرة الفاشلة فقط من سجلٍ ما، مع دمج القيم المستردة مجددًا — دون دفع مجدد مقابل ما نجح بالفعل.
الإثراءmerge_recordsادمج سجلين أو أكثر من السجلات الموجودة في نتيجة مدموجة واحدة — بناءً على القواعد أو باستخدام نموذج تحكيم LLM.
المهامget_job_statusاستعلِم عن المهام غير المتزامنة لمتابعة التقدم والنتائج والإخفاقات وأسئلة التوضيح. وبعد فشل توافق النموذج المحدد صراحةً، أعد المحاولة مرة واحدة بالاختيار التلقائي بدلًا من التنقل بين النماذج.
المهامcancel_jobألغِ مهمة معلّقة أو قيد التشغيل أو موقوفة مؤقتًا.
المهامanswer_job_questionأجب عن أسئلة التوضيح لمهمة موقوفة مؤقتًا واستأنفها — الجزء التفاعلي من generate_sample.
المعايير المرجعيةlist_benchmark_scenariosاعرض سيناريوهات المعايير المرجعية المحفوظة لديك (اختبارات إثراء قابلة لإعادة الاستخدام).
المعايير المرجعيةget_benchmark_scenarioسيناريو واحد مع نتائجه المسجَّلة لكل نموذج (الجودة / التكلفة / السرعة).
المعايير المرجعيةcreate_benchmark_scenarioأنشئ سيناريو: مخطط + كيان ثابت + استراتيجية + حَكَم تسجيل. يتطلب دور المالك + خطة تتضمن المعايير المرجعية.
المعايير المرجعيةupdate_benchmark_scenarioحدّث تعريف اختبار السيناريو أو إعداد التسجيل الخاص به؛ تُوسم النتائج الموجودة بأنها قديمة.
المعايير المرجعيةset_benchmark_referenceاحفظ المخرَج المرجعي الذهبي وضع علامة عليه بأنه مُتحقَّق منه — مطلوب قبل التشغيل.
المعايير المرجعيةdelete_benchmark_scenarioاحذف سيناريو ونتائجه.
المعايير المرجعيةrun_benchmarkشغّل سيناريو على قائمة نماذج محددة، أو على كل نموذج نشط للمزوّدين المختارين، أو على جميع النماذج النشطة — تُسجَّل كل نتيجة تلقائيًا مقابل المرجع.
السجلاتlist_recordsتصفَّح سجلات الإثراء، وتوليد العيّنة/المخطط، وتعديل المخطط، وساحة التجريب، والتصنيف، والتحكيم، وتحليل الالتباس، مع مرشّحات للنجاح والنموذج والمهمة والبحث.
السجلاتget_recordمخرجات منظّمة كاملة + أخطاء التحقق لسجلّ واحد.
السجلاتget_statsإحصائيات مجمَّعة للمؤسسة: الإجماليات، ومعدل النجاح، والرموز، والتكلفة.
المرفقاتupload_attachmentارفع ملفًا بترميز base64 وأعِد معرّف مرفقه إلى جانب قدرة النموذج المطلوبة. تمرير المعرّف إلى generate_sample يفعّل وضع المصدر.
المرفقاتdelete_attachmentحذف مرفق حسب المعرّف — خطوة تنظيف مفيدة بعد الإثراء.
Database Synclist_database_syncsاعرض قائمة بمزامنات قاعدة البيانات المسجّلة على مخطط محفوظ، مع أعداد الفروق المعلّقة وخيارات كل مزامنة.
Database Synccreate_database_syncاربط قاعدة بيانات بمخطط محفوظ لتحويل عمليات الإثراء الخاصة به إلى فروق SQL علائقية لقاعدة بيانات PostgreSQL الخاصة بك. يُربط المخطط دون نشره ويُصنَّف نموذج قاعدة البيانات في الخلفية — راجعه، ثم تبدأ publish_schema التغذية.
Database Syncclassify_database_modelأعد تشغيل تصنيف نموذج قاعدة البيانات بعد تعديل مخطط مرتبط: يقترح LLM المفتاح ونوع SQL والفهرس والملكية لكل خاصية جديدة أو مُعدَّلة. تُشغَّل المرحلة الأولى تلقائيًا عند اتصال قاعدة البيانات.
Database Syncdelete_database_syncاحذف مزامنة قاعدة بيانات والفروق المصطفّة الخاصة بها — دون المساس بجداول نسختك المتماثلة أبداً. كما تُسقط أعلام الإزالة الاختيارية حالة الكيان ونموذج قاعدة البيانات للمخططات التي بقيت دون قاعدة بيانات.
Database Synccreate_database_credential(إعادة) إصدار بيانات اعتماد عميل المزامنة لمزامنة قاعدة بيانات — خطوة الاقتران في سير عمل ee-database، تُعاد مع أمرَي التثبيت والاقتران.
Database Syncfetch_database_deltasاجلب نافذة FIFO التالية من فروق SQL لمزامنة قاعدة بيانات — claim=true يحجزها لتسليم مُقَرّ به، وclaim=false قراءة قابلة لإعادة التشغيل.
Database Syncack_database_deltasإقرار بالفروق المطبَّقة حتى معرّف معيّن: يحرّر الحجز ويطبّق خيارات التطهير الخاصة بالمزامنة.
Database Syncassign_sync_hostعيّن (أو امسح) مضيف المزامنة الذي يهيّئ مزامنة قاعدة بيانات في الوضع المُدار — يستحوذ المضيف على بيانات الاعتماد، وينشئ قاعدة البيانات الفعلية إن لم تكن موجودة، ويبدأ المزامنة، دون أي اقتران يدوي.
Database Synclist_entity_statesاستعرض حالة الكيانات الراهنة لمخطط ما — الصفوف المُزال تكرارها بقاعدة «آخر كتابة تفوز» التي تحتفظ بها طبقة الكيانات وتعكسها كل قاعدة بيانات مرتبطة، لا سجلات كل تشغيل الخاصة بـ list_records.
Database Syncsync_records_to_databaseاحقن مخرجات الإثراء المخزَّنة في Database Sync الخاص بمخطط ما — يُعاد التحقق منها مقابل العقد المنشور، ثم تمرّ عبر بوابة القبول.
المعرّفات الدلاليةlist_semantic_conceptsتصفّح مفردات مفاهيم المؤسسة مع أوجه أنواعها — أو، مع view="duplicates"، أزواج المفاهيم الواقعة أسفل عتبة المطابقة مباشرة.
المعرّفات الدلاليةget_semantic_conceptمفهوم واحد بالكامل: الصيغ الظاهرة، ومفاتيح مصادر الهوية، والسجلات المرتبطة، وأقرب جيرانه مع درجات التشابه (المعرَّفة فقط ضمن شريحة نوع المفهوم ونموذج التضمين الخاصة به).
المعرّفات الدلاليةprobe_semantic_conceptشغّل سلّم المطابقة لنص ما على سبيل التجربة — أي ما سيفعله الإثراء به — دون إنشاء أي شيء. استكشِف قبل الإضافة.
المعرّفات الدلاليةadd_semantic_conceptأضف مفهومًا بعدد استخدام 0، أو أضف عبر alias_of صيغة ظاهرة جديدة لمفهوم قائم. يُرفض الطلب مع إرجاع المفهوم القائم إذا كان النص مغطّى مسبقًا عند العتبة.
المعرّفات الدلاليةupdate_concept_aliasأزل صيغة ظاهرة من مفهوم، أو رقِّ إحداها لتكون الصيغة المعتمدة. تُرفض إزالة آخر صيغة ظاهرة — فحذف المفهوم نفسه مهمة مسار الحذف.
المعرّفات الدلاليةimport_semantic_conceptsطابِق ما يصل إلى 1000 نص هوية عبر سلّم الإثراء: تقرير لكل صف افتراضيًا، مع إنشاء المفاهيم غير المطابَقة عند mint=true (للمالك).
المعرّفات الدلاليةmerge_semantic_conceptsادمج مفهومًا داخل آخر. تُبلّغ impact_only=true (الافتراضي) بنطاق التأثير؛ أما الدمج نفسه (للمالك) فيعيد توجيه الأسماء المستعارة والكيانات ويحقّق التقارب في كل قاعدة بيانات مرتبطة.
المعرّفات الدلاليةdelete_semantic_conceptsاحذف المفاهيم حسب المعرّف، أو أنواعًا كاملة، أو غير المستخدمة فقط. تُبلّغ impact_only=true (الافتراضي) أولًا بالأعداد وبالمخططات/قواعد البيانات المتأثرة؛ والحذف يُصلح نفسه ذاتيًا لكنه يكسر التقارب مع المعرّفات المخزَّنة.
المعرّفات الدلاليةmigrate_semantic_embeddingsالحالة، أو معاينة التعارضات، أو بدء ترحيل نموذج التضمين في المؤسسة أو إلغاؤه — وهو السبيل الوحيد لنقل المفاهيم القائمة بين نماذج التضمين.

أوضاع توليد العيّنات

وضع المعرفة

احذف attachment_ids. يصمّم النموذج عيّنة قابلة لإعادة الاستخدام من معرفته، ويمكن أن يوثّق enable_web_search=true حقائق خارجية.

وضع المصدر

مرِّر attachment_ids. يتعامل المخطِّط مع الملفات باعتبارها مرجعية: فينسخ قيم المستندات أو يصف الخصائص المرئية في الصورة فقط. ولا يمكن للحقول والتعليمات الإضافية أن تضيف حقائق خارجية غير ذات صلة.

تعليماتك الإضافية مُلزِمة

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

بالنسبة إلى طلب هجين مثل التعرّف على سيارة من صورة والبحث عن ظهوراتها العلنية، استدعِ generate_sample مرتين: أولًا في وضع المصدر مع إيقاف البحث على الويب، ثم دون مرفقات باستخدام الهوية المؤكَّدة مع تفعيل البحث على الويب. اجمع النتائج في المحادثة؛ إذ يحتفظ Entity Enricher بسجلات منفصلة كي تحتفظ ملاحظات المصدر والحقائق المستنتجة بمصدرها المتمايز.

أبقِ model=auto ما لم تكن بحاجة صريحة إلى نموذج محدد. يراعي الاختيار التلقائي متطلبات المهمة والمرفقات والبحث على الويب؛ ومع ذلك قد يواجه مفتاح نموذج متاح حصة خاصة بالمزوّد أو قيودًا على الأدوات المدمجة.

وافِق على العيّنة، ثم راجِع المخطط

العيّنة هي العقد

قبل توليد المخطط، يراجع العميل نطاق الكيان والمفاتيح والأنواع والتعددية والحقول التمثيلية المفقودة والعلاقات المتداخلة. وتُجمَّع التعديلات المؤثرة لطلب موافقتك، ولا تُغيَّر القيم الواقعية والبنية في صمت أبدًا.

اختر معرّفات دلالية ثابتة عند الحاجة

بالنسبة إلى الجداول العلائقية أو البيانات الرئيسية أو الرسوم البيانية المعرفية أو الكيانات المتداخلة القابلة لإعادة الاستخدام، يسأل العميل عمّا إذا كان ينبغي توليد معرّفات دلالية. فهي تتطلب نموذج تضمين خاصًا بالمؤسسة وتضيف تكلفة تضمين، ولذلك تبقى معطّلة افتراضيًا.

مرِّر entity_data لعيّنة جديدة أو معدَّلة، أو sample_record_id لإعادة استخدام JSON المخزّن ومرفقاته المرتبطة. تمرير الاثنين معًا يستخدم JSON المعدَّل مع الاحتفاظ بالمرفقات. ويتجاوز attachment_ids الصريح الوراثةَ، بما في ذلك القائمة الفارغة.

بعد التوليد، يتحقق العميل من مطابقة العيّنة والمفاتيح والتعليقات التوضيحية ومجال الخبرة والعلاقات وتغطية المعرّفات الدلالية. تتطلب الاقتراحات البنيوية تعديل العيّنة وإعادة التوليد، بينما تظل التعديلات المقتصرة على التعليقات التوضيحية بحاجة إلى موافقتك. ولا يُطبَّق شيء تلقائيًا.

الموارد

تتيح الموارد لـ Claude تصفّح البيانات دون استهلاك استدعاء أداة — إذ يتعامل معها عميل LLM كأنها ملفات. ويُعرض كلا نوعَي الموارد بصيغة Markdown لعرض مضمَّن منخفض التكلفة.

قالب URIالوصف
enricher://schemas/{schema_id}مخطط محفوظ معروض بصيغة Markdown — ترويسة بيانات وصفية + GeneratedJsonSchema ككتلة JSON محاطة بأسوار.
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": "..."
}

يُلغي n8n وMake تلقائياً في هذه الحالة لأنهما لا يستطيعان سؤال المستخدم في منتصف سير العمل. أما MCP فيستطيع، وهذا الفرق الوحيد هو سبب وجود الموصّل.

يُشغِّل التفاعل نفسه تدفقًا ثانيًا: عندما يعمل generate_sample مع مستندات مصدرية، قد يتوقف مخطِّطه مؤقتًا لطرح أسئلة توضيحية بنيوية. ينقلها Claude إليك ويستأنف المهمة باستخدام answer_job_question — جولة تلو الأخرى، حتى يتم توليد العينة.

رموز الأخطاء

تُسقَط أخطاء الأدوات في قواميس منظّمة تحتوي على حقل error_code حتى يتمكّن Claude من مطابقة الأنماط بدلًا من تحليل النص الحر. تُطابَق طبقة HTTP بوضوح: 402 → خطأ في الحصة أو الرصيد، 422 → تحذير تصنيف، 504 → انتهاء المهلة، 502 → فشل LLM أعلى المصدر.

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 التي لا تحتوي على نص تفاصيل مهيكل.

إغفالات متعمَّدة

انظر أيضًا