يتصل Codex وCursor وVS Code مع GitHub Copilot وClaude Code وClaude بخادم MCP نفسه الخاص بـ Entity Enricher. ويمكن لوكلائها تصميم المخططات، وإثراء الكيانات بعدة لغات، ودمج النماذج، وتنظيم الهويات الدلالية، وقياس أداء الجودة، ومزامنة الجداول العلائقية مع قاعدة بيانات — على نماذج المنصة، أو على نموذج العميل الخاص عندما تُفوّض المهمة استدعاءات LLM الخاصة بها — وسؤال مساعد دعم المنتج عندما يتعلق السؤال بـ Entity Enricher نفسه.
لا يضمن التحقق من صحة المخطط ولا توافق النماذج فيما بينها دقة المعلومات أو حداثتها. افحص المصادر والإخفاقات ونتائج قاعدة البيانات الجزئية. يوفّر MCP وصولًا حواريًا، بينما يوفّر n8n وMake أتمتة سير العمل على الخدمة نفسها.
افتراضيًا، تُشغّل كل أداة بدء مهمتها على نموذجك الخاص (أما use_platform_models=true، أو تحديد اسم نموذج من نماذج المنصّة، فيُشغّلها على نماذج المنصّة المدفوعة بدلًا من ذلك). لا تُجري المهمة أي استدعاء لنموذج المنصّة ولا تستهلك أي أرصدة: فالنموذج الذي يقف خلف عميل MCP الخاص بك — وهو النموذج الذي يحتفظ بالفعل بمحادثتك ومستنداتك وأدواتك المتصلة — يجيب عن كل استدعاء نموذج في المهمة، وتتولّى المنصّة ما تُجيده: بناء الموجّهات، وفرض مخطط الإخراج، والتحقّق من كل إجابة وتوحيد صيغتها، وحفظ السجلات ومزامنة قواعد البيانات.
enable_web_search حيث تقبله الأداة: فإذا حُذف، تُرجع web_search_undecided لتسأل المستخدم أولًا، لأن البحث سيكون من جانبك. تتوقّف المهمة مؤقتًا بمجرد أن يصبح أول استدعاء نموذج فيها جاهزًا.llm_requests في حالة المهمة: كل إدخال هو استدعاء نموذج واحد بصيغة MCP sampling/createMessage — موجّه النظام والرسائل والأدوات وtoolChoice — مع purpose يحدّد الخطوة ومهلة نهائية. يُشار إلى المرفقات الثنائية كمواردenricher://attachments/{id}، ولا تُضمَّن مباشرةً أبدًا؛ أما النص المستخرَج فموجود مسبقًا في الرسائل. العميل الذي رفع الملف يقرأ نسخته الخاصة، لذا لا يتطلب المرفق أبدًا نموذجًا من المنصة.answer_llm_request. تتحقق المنصة منها مقابل المخطط تمامًا كما تتحقق من إجابة أي مزوّد؛ وتعود الإجابة المرفوضة في صورة المحادثة نفسها مع الخطأ داخل نتيجة أداة فاشلة، لتصحيحها والإجابة مرة أخرى.تفاصيل البروتوكول والحالات الحدّية — الانسحاب، وقرار البحث على الويب، والطلبات المتزامنة، وطلبات الإصلاح في الإثراء، والمرفقات، ومُهَل الانتظار — موجودة في دليل استدعاءات LLM المُفوَّضة المذكور أدناه.
يتيح OAuth للعميل الاتصال دون مفتاح API. وتُحدّد شاشة الموافقة في Entity Enricher هوية العميل والمؤسسة والدور الممنوح للاتصال. ويمكن إدارة الوصول أو إلغاؤه ضمن مفاتيح API → التطبيقات المتصلة.
تستخدم هذه الأمثلة تسجيل الدخول من المتصفح (OAuth) ونقطة نهاية Streamable HTTP نفسها: https://entityenricher.ai/api/mcp/، بما في ذلك الشرطة المائلة في النهاية. ولكل عميل تنسيق إعداد خاص به.
يشارك Codex إعدادات MCP بين تطبيقه وواجهة الأوامر وإضافة بيئة التطوير عبر ~/.codex/config.toml. يسجّل الأمر الأول Entity Enricher، ويفتح أمر تسجيل الدخول صفحة الدخول في المتصفح عند الحاجة إلى المصادقة.
codex mcp add entity-enricher --url https://entityenricher.ai/api/mcp/
codex mcp login entity-enricherيقرأ Cursor خوادم المشروع من .cursor/mcp.json، أو الخوادم الشخصية من ~/.cursor/mcp.json. ويستخدم مدخل الخادم البعيد mcpServers؛ ويتولّى Cursor مسار تسجيل الدخول عبر OAuth.
{
"mcpServers": {
"entity-enricher": {
"url": "https://entityenricher.ai/api/mcp/"
}
}
}يستخدم VS Code الملف .vscode/mcp.json مع كائن servers ونقل http صريح. وبدء تشغيل الخادم يجعل أدواته متاحة لوكيل GitHub Copilot بعد التفويض.
{
"servers": {
"entity-enricher": {
"type": "http",
"url": "https://entityenricher.ai/api/mcp/"
}
}
}يسجّل هذا الأمر خادم HTTP بعيداً في Claude Code. ويفتح الأمر /mcp داخل Claude Code عناصر التحكّم في الاتصال والمصادقة.
claude mcp add --transport http entity-enricher https://entityenricher.ai/api/mcp/في claude.ai وClaude Desktop، تتيح إعدادات الموصّلات إجراء "إضافة موصّل مخصّص". يأخذ الموصّل عنوان URL للخادم المذكور أعلاه ويفتح شاشة التفويض في Entity Enricher. يُضبط هذا الاتصال المُستضاف من خلال الموصّلات؛ أما claude_desktop_config.json فهو للخوادم المحلية.
تُنشأ مفاتيح وصول المؤسسة ضمن الإعدادات → مفاتيح API مع تحديد دور. ويمكن للعملاء إرسال المفتاح في رأس X-API-Key بدلاً من تسجيل الدخول عبر OAuth. على سبيل المثال، يقرأ إعداد Codex هذا المفتاح من متغيّر بيئة:
[mcp_servers.entity-enricher]
url = "https://entityenricher.ai/api/mcp/"
env_http_headers = { "X-API-Key" = "ENTITY_ENRICHER_API_KEY" }يجب أن يحتوي ENTITY_ENRICHER_API_KEY على المفتاح في بيئة العملية التي تُشغّل Codex. ويقبل كل من Cursor وVS Code رأس HTTP هذا في كائن الإعداد headers الخاص به. وتوضّح مراجع العملاء المذكورة أعلاه الإعدادات المدعومة لديها.
يعمل الطلب نفسه في جميع العملاء: "اعرض مخططاتي في Entity Enricher، ثم أثرِ Sanofi باستخدام مخطط شركة الأدوية الخاص بي وأظهر النتيجة المحفوظة."يكتشف العميل الأدوات ويستخدمها لاختيار مخطط وتشغيل الإثراء. وتعتمد مطالبات التأكيد وعرض التقدّم والوصول إلى الموارد على العميل.
تغطي 62 أداة تأليف المخططات والإثراء وقياسات الأداء وDatabase Sync والهويات الدلالية ودعم المنتج. وهي تعيد استخدام خدمات الواجهة الخلفية للتحقق والفوترة والمعالجة. وتُتيح كل أداة معاملاتها المدعومة الخاصة بها. أما المهام الطويلة (الإثراء بالدفعات، وتوليد العيّنات، وتشغيل قياسات الأداء) فهي غير متزامنة: تُعيد أداة البدء 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. |
| المخططات | publish_schema | نشر النسخة العاملة لمخطط مرتبط بقاعدة بيانات بوصفها العقد المستخدَم في الإثراء والنسخ المتماثلة. |
| المخططات | delete_schema | احذف مخططًا محفوظًا حذفًا مؤقتًا حسب UUID. |
| المخططات | analyze_sample | حلّل غموض خصائص العينة ونطاق هوية العلاقات قبل توليد المخطط. |
| المخططات | analyze_schema | حلّل غموض خصائص مخطط محفوظ ونطاق هوية العلاقات، مع كتابة التعليقات التوضيحية في المخطط. |
| الإثراء والدمج | start_batch_enrichment | ابدأ إثراءً غير متزامن ومدفوعًا لقائمة كيانات مقابل واحد فقط من schema_id أو target_schema. |
| الإثراء والدمج | enrich_entity | أثرِ كيانًا واحدًا مقابل schema_id أو target_schema حصرًا (أحدهما فقط)، مع إرجاع مخرجات مهيكلة وrecord_id والتكاليف وأي نتيجة تخص قاعدة البيانات. |
| الإثراء والدمج | retry_expertises | إعادة محاولة مجالات الخبرة الفاشلة فقط في سجل قائم، ثم تحديث مخرجاته ومحاولة إجراء الدمج/المزامنة الخاصة بالتشغيل. |
| الإثراء والدمج | merge_records | ادمج سجلين أو أكثر للكيان نفسه في سجل تحكيم جديد. |
| التحكم في المهام | get_job_status | قراءة حالة المهمة وتقدّمها والملخص النهائي المختصر مع معرّفات السجلات المحفوظة. |
| التحكم في المهام | cancel_job | طلب إلغاء مهمة LLM معلّقة أو قيد التشغيل أو متوقفة مؤقتًا. |
| التحكم في المهام | answer_job_question | استئناف مهمة متوقفة مؤقتًا بتقديم إجابات عن الأسئلة المُعادة أثناء الإيقاف المؤقت. |
| التحكم في المهام | answer_llm_request | أرسِل نتيجة استدعاء نموذج معلّق واحد لمهمة مفوَّضة: مهمة بدأها المستخدم على نموذج العميل الخاص (الإعداد الافتراضي لكل أداة بدء ما لم تكن use_platform_models=true أو… |
| السجلات والإحصاءات | 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 | احفظ المرجع الذهبي لاختبار مرجعي للإثراء أو لتوليد المخططات. |
| المعايير المرجعية | revert_benchmark_reference_updates | التراجع عن التعديلات التلقائية التي أجرتها جولة تقييم على مرجع السيناريو. |
| المعايير المرجعية | 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 | get_database_setup_instructions | إرجاع تعليمات التثبيت غير السرّية، والاقتران المُؤكَّد من المتصفح، والتشغيل لعميل ee-database sync. |
| 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 | فحص فضاء تضمين المفاهيم الخاص بالمؤسسة أو ترحيله. |
| دعم المنتج | ask_support | اطرح على Rupert، مساعد دعم المنتج في Entity Enricher، سؤالاً عن التطبيق نفسه: كيف تعمل ميزة أو أداة أو إعداد، وما معنى error_code أو حدّ أو حالة… |
| دعم المنتج | get_support_conversation | اقرأ إحدى سلاسل الدعم الخاصة بك مع كل أدوار المحادثة: أسئلتك (الدور user)، وأجوبة Rupert (assistant)، ومتابعات فريق الدعم (admin، مع author_name). |
| دعم المنتج | list_support_conversations | سلاسل الدعم الخاصة بك، مرتَّبة من الأحدث نشاطًا، مع message_count و unread_for_user (متابعة من فريق الدعم لم تقرأها بعد). |
تشرح تعليمات الخادم سير العمل المتاح، بينما تشرح أوصاف الأدوات كل استدعاء على حدة. لاتخاذ قرارات النمذجة أو للتعافي، يمكن لعميلك قراءة فهرس الأدلة على enricher://docs واختيار دليل عبر موارد MCP. قراءة الدليل لا تُشغّل أي نموذج. تفتح الروابط أدناه الأدلة الإنجليزية نفسها في المستودع العام.
بشكل افتراضي، تعمل كل مهمة تبدأها على نموذجك الخاص: أجب عن كل استدعاء نموذج فيها باستخدام `answer_llm_request`، واترك للمنصة التحقق من كل إجابة مقابل المخطط. أما `use_platform_models=true` فيشغّل المهمة على المنصة بدلاً من ذلك، باستخدام النموذج الأفضل لهذه المهمة وفق قياس الأداء في المؤسسة.
صمّم مخططًا قابلًا لإعادة الاستخدام انطلاقًا من أمثلة مراجَعة، بما يشمل الهوية والعلاقات والحقول متعددة اللغات.
قراءة مستندات مخططات Entity Enricher وإنشاؤها وتعديلها دون الخلط بين JSON Schema المُسلسل والبيانات النموذجية ومسارات أدوات الخصائص.
اختر الاستخراج أو الإثراء المعرفي أو مزيجًا من مرحلتين، مع الحفاظ على مصدر المرفقات عبر الاستدعاءات.
أثرِ كيانًا، وفسّر نتيجته الفعلية، وعالج حالات فشل النماذج الجزئية دون تكرار العمل الناجح.
أثرِ قائمة كيانات بشكل غير متزامن، وميّز بين النتائج المتخطَّاة والفاشلة والمدمَجة والمقبولة في قاعدة البيانات.
قارن النماذج في الإثراء أو توليد العينات أو توليد المخططات، باستخدام المرجع الصحيح والتفسير الصحيح للدرجات.
حوِّل مخططات الإثراء إلى جداول علائقية في قاعدة بياناتك الخاصة، وتحقّق من القبول والترحيل وتسليم النسخة المطابقة كلٌّ على حدة.
التعرّف على الكيانات المتكررة عبر أشكالها السطحية، ومراجعة التطابقات غير المؤكدة، وفهم أثر تغييرات المفردات على النسخ المتماثلة.
اطرح على Rupert، مساعد دعم المنتج، أي سؤال عن Entity Enricher نفسه، وتابع السلسلة التي فتحتها، واقرأ متابعات فريق الدعم.
تعرض الموارد بيانات المخططات والسجلات إضافةً إلى أدلة سير العمل بصيغة Markdown. ويختار العملاء طريقة اكتشافها وتحميلها؛ ومع ذلك قد يستهلك محتوى الموارد سياق النموذج.
| قالب URI | الوصف |
|---|---|
| enricher://docs | فهرس أدلة سير العمل، وكل دليل متاح على عنوان URI المورد المذكور له. |
| enricher://schemas/{schema_id} | نسخة عمل من مخطط محفوظ بصيغة Markdown؛ استخدم get_schema مع version="published" للحصول على العقد المرتبط النشط. |
| enricher://records/{record_id} | سجل إثراء سابق معروض بصيغة Markdown — بيانات وصفية + مخرجات منظَّمة + أخطاء تحقق. |
| enricher://attachments/{attachment_id} | وحدات بايت المرفق المرفوع، تُقدَّم بنوع الوسائط الحقيقي — وهي الطريقة التي تُسلِّم بها مهمةٌ تفوِّض استدعاءات LLM الخاصة بها إلى عميلك ملفَّ PDF أو صورةً أو ملفًا صوتيًا لم يرفعه بنفسه. |
عندما يتعلق السؤال بـ Entity Enricher نفسه — كيف تعمل ميزة أو أداة، وما معنى رمز خطأ أو حدّ أو تحذير، ولماذا تظهر النتيجة بهذا الشكل — ولا تجيب عنه الأدلّة، توجّه تعليمات الخادم الوكيل إلى سؤال Rupert، مساعد دعم المنتج، عبر ask_support بدلًا من التخمين. ويُعيد الاستدعاء الإجابة الكاملة ومعرّف المحادثة التي فتحها؛ وتمرير ذلكconversation_id إلى السؤال التالي يحفظ سياق التبادل.
يُحتسب كل سؤال من حصة الدعم اليومية للمؤسسة، ويظهر المتبقي فيquestions_remaining. وقد يجيب فريق الدعم داخل المحادثة: فيُعيد استدعاء ask_support التالي عليها تلك الردود فيnew_admin_messages، كما يقرأget_support_conversation المحادثة كاملة. وتظهر المحادثات نفسها في دردشة الدعم بتطبيق الويب، ولدى المالكين في تبويب «المناقشات» بصفحة «المستخدمين»، موسومة بأنها فُتحت بواسطة وكيل ذكاء اصطناعي.
عندما تطلب من enrich_entity استخدام نموذج تصنيف ولا يطابق الكيان نوع المخطّط، تُرجع الأداة ردًّابلا خطأ مع تفاصيل مُهيكلة. يقرأه العميل ويعرض لك التفسير، ثم (بعد تأكيدك) يعيد المحاولة باستخدام 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 مع مستندات مصدر، قد يتوقّف المخطّط لطرح أسئلة توضيحية عن البنية. ينقلها العميل إليك ثم يتابع المهمة عبر 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 | ⚡ ليس خطأً: رفض المُصنِّف الأولي الكيان. تحمل الاستجابة سياق التصنيف حتى يتمكّن العميل من مطالبة المستخدم بالتأكيد وإعادة المحاولة باستخدام force_after_classification_warning=true. |
| benchmarks_not_in_plan | لا تتضمن خطة المؤسسة الاختبارات المرجعية للنماذج (HTTP 403). كما تتحقق أدوات الاختبار المرجعي التي تُجري تعديلات من دور المالك. |
| support_question_limit_reached | استُنفدت حصة المؤسسة اليومية من أسئلة الدعم (HTTP 402). يتضمن جسم الاستجابة limit وused؛ وتُبلّغ كل نتيجة ask_support عن questions_remaining. |
| support_requires_user | تم استدعاء ask_support بمفتاح وصول خاص بالمؤسسة (HTTP 403). محادثة الدعم تخصّ شخصًا: سجّل الدخول عبر OAuth أو بمفتاح API شخصي. |
| support_unavailable | لم يتمكن مساعد الدعم من الإجابة (فشل في التمرير). ومع ذلك يُحتسب السؤال والمحادثة موجودة: اقرأها لاحقًا عبر get_support_conversation بدلًا من إعادة السؤال فورًا. |
| web_search_undecided | تم استدعاء أداة بدء دون enable_web_search لمهمة تعمل على نموذجك. اسأل المستخدم عمّا إذا كان يُسمح لنموذجك باستخدام البحث على الويب، ثم استدعِ الأداة مرة أخرى مع enable_web_search=true أو false. |
| delegation_requires_auto | واجهت مهمة تعمل على نموذجك نموذجًا صريحًا من نماذج المنصّة أُدخل بعد الإطلاق، مثل الإعداد الافتراضي للمؤسسة (HTTP 400). ابدأ المهمة باستخدام use_platform_models=true، أو أزِل ذلك الإعداد الافتراضي. |
| request_not_pending | أشار answer_llm_request إلى طلب تمت الإجابة عنه أو انتهت صلاحيته أو ينتمي إلى مهمة تابعت سيرها. راجع get_job_status(job_id).llm_requests لمعرفة الطلبات المعلّقة حاليًا. |
| llm_request_pending | تم استدعاء answer_job_question على مهمة متوقفة مؤقتًا بسبب طلبات LLM مفوَّضة، وليس بسبب سؤال. أجب عنها باستخدام answer_llm_request. |
| llm_request_timeout | لم تتلقَّ مهمة تفوّض استدعاءات LLM الخاصة بها أي إجابة على طلب معلّق خلال 15 دقيقة، فأخفقت المهمة. المهام المفوَّضة ليس لها إجابة افتراضية. |
| 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 الملخصات على جانب المحادثة؛ أما لوحات المعلومات الكاملة فتبقى في التطبيق.