اكتشف خصائص المخطط التي تتباين قيمها بين النماذج أو بين التشغيلات، وأصلحها قبل أن تلوّث بياناتك — للحصول على إثراءات قابلة للتكرار والمقارنة والدقّة.
يتعامل Entity Enricher مع نماذج LLM بوصفها قواعد معرفة قابلة للاستعلام. ولا ينجح ذلك إلا حين يحدّد اسم الخاصية إجابةً واحدة قابلة للتكرار. خاصية مثل annual_revenue لا تفعل ذلك: أيّ سنة مالية؟ أيّ عملة؟ بالملايين أم بالوحدات؟ فكل نموذج — وكل إعادة تشغيل للنموذج نفسه — حرّ في اختيار إطار مختلف، فتتضارب القيم حتى لو لم يكن أيّ نموذج مخطئًا.
الخصائص المتقلبة تضرّ بكل ما يليها: يرى دمج النماذج المتعدد تعارضات هي في الحقيقة اختلافات في التأطير، وتتّسع مديات اتساق القياس المرجعي لأسباب لا علاقة لها بجودة النموذج. يعثر فحص عدم الحتمية على هذه الخصائص ويخبرك كيف تثبّتها.
تُصنَّف كل خاصية مُعلَّمة ضمن أحد أربعة أسباب، ولكلٍّ منها علاجه الخاص:
| السبب | مثال | العلاج |
|---|---|---|
| زمني | ceo, stock_priceceo_2025 | حقيقة متغيّرة بلا تاريخ مرجعي — حدّد الفترة، أو أعد الهيكلة إلى مصفوفة مفهرسة حسب الفترة. |
| غامض | annual_revenuerevenue_fy2024_usd_millions | الاسم لا يثبّت الوحدة أو العملة أو الفترة أو النطاق — ضمّن الإطار المفقود في الاسم أو الوصف. |
| ذاتي | reputationesg_risk_rating_sustainalytics | لا وجود لحقيقة مرجعية موضوعية — استبدلها بمؤشّر قابل للقياس أو مقياس ثابت؛ وإلا ستبقى مُعلَّمة كإرشادية. |
| متعدّد القيم | top_competitorstop_3_competitors_by_revenue | عدة إجابات صحيحة بالتساوي، عادةً قائمة غير محدودة — قيّدها وحدّد معيار الترتيب. |
إعادة التسمية ليست الحل الوحيد: بالنسبة لخصائص المخطط يقترح المحلّل أيضًا إصلاحًا للوصف يثبّت الإطار المفقود. الوصف الأدقّ يصل إلى الذكاء الاصطناعي المُثري تمامًا كما يصل الاسم، لكنه لا يكسر أبدًا عقد بياناتك — لذا فهو العلاج المفضّل للمخططات المستخدَمة بالفعل.
بعد توليد العيّنة، يراجعها المحلّل. تُطبَّق عمليات إعادة التسمية الواضحة تلقائيًا على المفاتيح التي اخترعها الذكاء الاصطناعي (وليس أبدًا على الحقول التي سمّيتها بنفسك)، وتُعاد التصحيحات البنيوية إلى المولّد لما يصل إلى جولتَي تصحيح. تُتخطّى العيّنات المستندة إلى المستندات المرفقة — فقيمها تأتي من المستند المصدر لا من استرجاع النموذج.
بمجرد حفظ مخطط مُولَّد، تقوم عملية لاحقة بتوصيف كل خاصية بمستوى عدم الحتمية الخاص بها. هذه الخطوة تبذل قصارى جهدها: إذا فشلت، فلن يتأثر التوليد نفسه.
يحلّل زر إعادة الفحص الخصائص التي لا تحمل توصيفاً بعد فقط، ثم يتحوّل إلى إعادة تحليل كاملة بمجرد توصيف كل خاصية.
يمكن تحليل عينة JSON التي تلصقها لإنشاء مخطط دون حالة — فتحصل على تقرير بأسماء الخصائص الخطرة دون تعديل أي شيء.
الفحص استشاري فقط. فهو لا يعيق التوليد أبداً، ولا يرفض إثراءً أبداً، وتُجرَّد توصيفاته من كل موجّه يُرسَل إلى نماذج الإثراء — إنه يُعلمك أنت لا الذكاء الاصطناعي.
تعرض الخصائص المُعلَّمة شارة «متباين» في محرّر المخطط: كهرمانية للمخاطر المتوسطة، وحمراء للمخاطر العالية. وتمرير المؤشر فوق الشارة يُظهر ملاحظة المحلّل التي تشرح ما الذي يتباين ولماذا. أما الخصائص التي يُحكم بأنها حتمية فلا تحمل أي شارة.
يصدر الحكم على اسم الخاصية ووصفها معًا — لذا فإن إعادة تسمية خاصية أو تعديل وصفها يُسقط تعليقها التوضيحي. يبرز المحرّر مثل هذه الخصائص باعتبارها قديمة ويعرض إعادة فحص تحلّل ما هو مفقود فقط. وهذا بالضبط ما تريده بعد تطبيق إعادة تسمية مقترحة: تؤكّد إعادة الفحص ما إذا كان الاسم الجديد حتميًا.
يمكن إيقاف الفحص لكل مخطط من قائمة التجاوز في محرّر المخطط. عند تعطيله، تُتخطّى العملية اللاحقة للتوليد وتُخفى الشارات وزر إعادة الفحص وتحذيرات القِدَم. تُحفَظ التوصيفات القائمة (تُخفى فقط)، وإعادة تفعيل الفحص على مخطط لم يُحلَّل قط تشغّله تلقائياً.
المخططات المُولَّدة من مستندات مرفقة تبدأ والفحص معطّل: فقيمها منسوخة من المستند المصدر، لذا لا ينطبق تباين معرفة النموذج من تشغيل لآخر.
تُكتب ملاحظات المحلّل بلغة واجهتك — يرى المستخدم الفرنسي شروحًا بالفرنسية، والمستخدم الياباني باليابانية. أما أسماء الخصائص المقترحة فتبقى بالإنجليزية، تماشيًا مع أعراف تسمية المخطط.
كل تحليل هو استدعاء نموذج فعلي (زهيد التكلفة)، يُسجَّل كمطالبة خاصة به على السجل ويُخصم من الأرصدة كأي استخدام آخر للذكاء الاصطناعي. أما عمليات إعادة الفحص التدريجية فتُحتسب فقط على الخصائص التي جرى تحليلها فعلًا.
توليد المخطط نفسه مُوجَّه لإنتاج أسماء وأوصاف حتمية (فترات ووحدات ومعايير ترتيب مثبّتة)، لذا تخرج معظم المخططات نظيفة ولا يتعيّن على المحلّل سوى التقاط المتأخرات.
الفحص متاح برمجياً:
| السطح | الوصف |
|---|---|
POST /api/schema/analyze-sample | تحليل عيّنة JSON ملصقة — تقرير عديم الحالة، لا يُعدَّل أي شيء |
POST /api/schema/saved/{id}/analyze | تحليل مخطط محفوظ وكتابة تعليقات توضيحية — تدريجيًا بشكل افتراضي، وbـ force=true يعيد تحليل الكل |
analyze_sample_determinism | أداة MCP — تقرير العيّنة عديم الحالة نفسه من Claude أو أي عميل MCP |
analyze_schema_determinism | أداة MCP — أضف تعليقات توضيحية إلى مخطط محفوظ؛ اجمعها مع edit_schema لتطبيق إعادة تسمية مقترحة |
راجع مرجع API ودليل خادم MCP للاطّلاع على المصادقة وكتالوج الأدوات الكامل.