خادم MCP لـ Codex وعملاء ذكاء اصطناعي آخرين

يتصل Codex وCursor وVS Code مع GitHub Copilot وClaude Code وClaude بخادم MCP نفسه الخاص بـ Entity Enricher. ويمكن لوكلائها تصميم المخططات، وإثراء الكيانات بعدة لغات، ودمج النماذج، وتنظيم الهويات الدلالية، وقياس أداء الجودة، ومزامنة الجداول العلائقية مع قاعدة بيانات — على نماذج المنصة، أو على نموذج العميل الخاص عندما تُفوّض المهمة استدعاءات LLM الخاصة بها — وسؤال مساعد دعم المنتج عندما يتعلق السؤال بـ Entity Enricher نفسه.

لا يضمن التحقق من صحة المخطط ولا توافق النماذج فيما بينها دقة المعلومات أو حداثتها. افحص المصادر والإخفاقات ونتائج قاعدة البيانات الجزئية. يوفّر MCP وصولًا حواريًا، بينما يوفّر n8n وMake أتمتة سير العمل على الخدمة نفسها.

شغّل المهام على نموذج عميلك

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

  1. ابدأ المهمة دون نموذج صريح (محذوف أو auto)، مع تحديدenable_web_search حيث تقبله الأداة: فإذا حُذف، تُرجع web_search_undecided لتسأل المستخدم أولًا، لأن البحث سيكون من جانبك. تتوقّف المهمة مؤقتًا بمجرد أن يصبح أول استدعاء نموذج فيها جاهزًا.
  2. اقرأ llm_requests في حالة المهمة: كل إدخال هو استدعاء نموذج واحد بصيغة MCP sampling/createMessage — موجّه النظام والرسائل والأدوات وtoolChoice — مع purpose يحدّد الخطوة ومهلة نهائية. يُشار إلى المرفقات الثنائية كمواردenricher://attachments/{id}، ولا تُضمَّن مباشرةً أبدًا؛ أما النص المستخرَج فموجود مسبقًا في الرسائل. العميل الذي رفع الملف يقرأ نسخته الخاصة، لذا لا يتطلب المرفق أبدًا نموذجًا من المنصة.
  3. شغّل الطلب على نموذجك الخاص وأعِد النتيجة عبرanswer_llm_request. تتحقق المنصة منها مقابل المخطط تمامًا كما تتحقق من إجابة أي مزوّد؛ وتعود الإجابة المرفوضة في صورة المحادثة نفسها مع الخطأ داخل نتيجة أداة فاشلة، لتصحيحها والإجابة مرة أخرى.
  4. كرّر ذلك حتى تكتمل المهمة. وتُوسَم السجلات بمفتاح النموذج mcp::client بتكلفة صفرية؛ وأي طلب يبقى دون إجابة يُفشل المهمة بعد خمس عشرة دقيقة.

تفاصيل البروتوكول والحالات الحدّية — الانسحاب، وقرار البحث على الويب، والطلبات المتزامنة، وطلبات الإصلاح في الإثراء، والمرفقات، ومُهَل الانتظار — موجودة في دليل استدعاءات LLM المُفوَّضة المذكور أدناه.

البدء السريع

تسجيل الدخول عبر OAuth

يتيح OAuth للعميل الاتصال دون مفتاح API. وتُحدّد شاشة الموافقة في Entity Enricher هوية العميل والمؤسسة والدور الممنوح للاتصال. ويمكن إدارة الوصول أو إلغاؤه ضمن مفاتيح API → التطبيقات المتصلة.

تستخدم هذه الأمثلة تسجيل الدخول من المتصفح (OAuth) ونقطة نهاية Streamable HTTP نفسها: https://entityenricher.ai/api/mcp/، بما في ذلك الشرطة المائلة في النهاية. ولكل عميل تنسيق إعداد خاص به.

Codex

يشارك Codex إعدادات MCP بين تطبيقه وواجهة الأوامر وإضافة بيئة التطوير عبر ~/.codex/config.toml. يسجّل الأمر الأول Entity Enricher، ويفتح أمر تسجيل الدخول صفحة الدخول في المتصفح عند الحاجة إلى المصادقة.

Codex CLI
codex mcp add entity-enricher --url https://entityenricher.ai/api/mcp/
codex mcp login entity-enricher
توثيق Codex

Cursor

يقرأ Cursor خوادم المشروع من .cursor/mcp.json، أو الخوادم الشخصية من ~/.cursor/mcp.json. ويستخدم مدخل الخادم البعيد mcpServers؛ ويتولّى Cursor مسار تسجيل الدخول عبر OAuth.

.cursor/mcp.json
{
  "mcpServers": {
    "entity-enricher": {
      "url": "https://entityenricher.ai/api/mcp/"
    }
  }
}
توثيق Cursor

VS Code / GitHub Copilot

يستخدم VS Code الملف .vscode/mcp.json مع كائن servers ونقل http صريح. وبدء تشغيل الخادم يجعل أدواته متاحة لوكيل GitHub Copilot بعد التفويض.

.vscode/mcp.json
{
  "servers": {
    "entity-enricher": {
      "type": "http",
      "url": "https://entityenricher.ai/api/mcp/"
    }
  }
}
توثيق VS Code / GitHub Copilot

Claude Code

يسجّل هذا الأمر خادم HTTP بعيداً في Claude Code. ويفتح الأمر /mcp داخل Claude Code عناصر التحكّم في الاتصال والمصادقة.

Claude Code CLI
claude mcp add --transport http entity-enricher https://entityenricher.ai/api/mcp/
توثيق Claude Code

Claude / Claude Desktop

في claude.ai وClaude Desktop، تتيح إعدادات الموصّلات إجراء "إضافة موصّل مخصّص". يأخذ الموصّل عنوان URL للخادم المذكور أعلاه ويفتح شاشة التفويض في Entity Enricher. يُضبط هذا الاتصال المُستضاف من خلال الموصّلات؛ أما claude_desktop_config.json فهو للخوادم المحلية.

توثيق موصّل Claude
  1. 1المؤسسة التي يقتصر عليها التفويض
  2. 2يعمل الاتصال بدورك أنت، ولا يتجاوزه إلى دور أوسع أبدًا
  3. 3يمكن إبطاله في أي وقت من «التطبيقات المتصلة»
تُحدّد شاشة الموافقة هوية العميل الطالب والمؤسسة والدور الممنوح للاتصال.

المصادقة بمفتاح API

تُنشأ مفاتيح وصول المؤسسة ضمن الإعدادات → مفاتيح API مع تحديد دور. ويمكن للعملاء إرسال المفتاح في رأس X-API-Key بدلاً من تسجيل الدخول عبر OAuth. على سبيل المثال، يقرأ إعداد Codex هذا المفتاح من متغيّر بيئة:

~/.codex/config.toml
[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 Synclist_database_syncsعرض تسجيلات قاعدة البيانات والمخططات المرتبطة والخيارات ومضيفي المزامنة لمخطط محفوظ.
Database Synclist_entity_statesاستعرض صفوف الكيانات المدمَجة الحالية لمخطط ما، لا سجلات كل تشغيل على حدة.
Database Synccreate_database_syncتسجيل مخطط محفوظ للمزامنة العلائقية مع PostgreSQL أو MySQL أو SQLite.
Database Syncassign_sync_hostعيّن أو أزل المضيف الذي يوفّر مزامنة قاعدة البيانات.
Database Syncclassify_database_modelابدأ تحليلًا مدفوعًا يقترح مفاتيح قاعدة البيانات وأنواع SQL والفهارس وملكية العلاقات على مخطط مرتبط.
Database Syncdelete_database_syncاحذف تسجيل قاعدة بيانات والفروق المنتظرة في طابورها، ما يوقف تغذيتها.
Database Syncget_database_setup_instructionsإرجاع تعليمات التثبيت غير السرّية، والاقتران المُؤكَّد من المتصفح، والتشغيل لعميل ee-database sync.
Database Syncfetch_database_deltasقراءة النافذة المرتبة التالية من فروق SQL والحمولات المعيارية لمزامنة قاعدة بيانات.
Database Syncack_database_deltasأكّد استلام كل فرق (delta) عبر up_to_id بعد تطبيقه بنجاح، ما يحرّر حجزه.
Database Syncsync_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. قراءة الدليل لا تُشغّل أي نموذج. تفتح الروابط أدناه الأدلة الإنجليزية نفسها في المستودع العام.

الموارد

تعرض الموارد بيانات المخططات والسجلات إضافةً إلى أدلة سير العمل بصيغة 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 التي لا تحتوي على نص تفاصيل مهيكل.

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

انظر أيضًا