محرّر سير العمل - وثائق Entity Enricher

محرّر سير العمل

الصفحة التي تبني فيها عملية إثراء كاملة من البداية إلى النهاية — بيانات العيّنة والمخطط والنماذج والنتائج. وفي قلبها شجرة المخطط: محرِّر مرئي يتيح إعادة الترتيب بالسحب والإفلات، والتحرير المباشر، والتنقّل بلوحة المفاتيح، والتعديلات بمساعدة الذكاء الاصطناعي.

نظرة عامة

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

القدرات الرئيسية

تجميع الخبرات

خصائص مُجمَّعة حسب مجال الخبرة مع أقسام قابلة للطي. فعِّل التجميع أو عطِّله.

السحب والإفلات

عند إيقاف عرض «مُرتَّب»، يمكنك إعادة ترتيب الخصائص داخل المجموعات أو فيما بينها بالسحب — ويُحفظ الترتيب في المخطط. وتُظهر مؤشرات الإفلات المرئية المكان الذي ستستقر فيه العناصر.

التحرير المُضمَّن

انقر على أي خاصية لتحرير اسمها ونوعها ووصفها وأمثلتها مباشرةً في الشجرة.

التنقل بلوحة المفاتيح

مفاتيح الأسهم للتنقل وللطي أو التوسيع، وEnter للتحرير، وDelete للحذف، وCtrl+A لتحديد الكل. والتراجع والإعادة زرّان في شريط الأدوات، ويبقى سجل التغييرات محفوظًا عند تبديل المخططات أو إعادة تحميل الصفحة.

البحث والتصفية

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

تراجع / إعادة

سجلّ كامل للتعديلات اليدوية. التغييرات المولّدة بالذكاء الاصطناعي تحلّ محلّ السابقة دون إضافة إدخالات تراجع.

الأنواع ومجموعات القيم

تحتوي علامات التبويب في الأعلى على الأنواع المُسمّاة للمخطط. ينشئ زر + إما كائنًا (كيان متداخل بخصائصه الخاصة) أو Enum (قائمة مغلقة من القيم المسموح بها يمكنك توجيه أي خاصية نصية إليها).

عرض الرسم التخطيطي

يقوم عرض DIAGRAM المجاور لعرضَي SCHEMA وJSON برسم المخطط على هيئة رسم تخطيطي للكيانات — الكيانات المسمّاة كبطاقات ذات عناوين، والكائنات المتداخلة كبطاقات عادية تحمل اسم علاقتها، مع المراجع (1–1) والروابط (1–N) كحوافّ متقطعة. وهو يتابع تعديلاتك مباشرةً، والنقر على بطاقة كيان يفتحها في عرض SCHEMA.

شجرة الخصائص

يمثّل كل صف في المحرّر خاصية من خصائص المخطط مع عرض سماتها الرئيسية بلمحة واحدة:

تحديداسم الخاصيةالنوعالوصف
□company_name
🔍
stringالاسم القانوني للشركة
□revenuenumberالإيرادات السنوية بالدولار الأمريكي
□headquartersobjectالمقر الرئيسي للشركة
□ citystringاسم البلدية
□ country
🔍
stringالدولة التي يقع فيها المقر الرئيسي
□gmp_statusbooleanحالة شهادة GMP

تُزاح الخصائص المتداخلة (مثل city ضمن headquarters) لإظهار التسلسل الهرمي. تشير أيقونة العدسة المكبّرة إلى مفاتيح البحث — الحقول المستخدمة لتحديد الكيان.

مجموعات القيم (Enums)

تقيّد مجموعة القيم خاصية نصية بقائمة ثابتة من القيم المسموح بها — حالة أو درجة أو رمز تصنيف. وعندئذٍ لا يمكن للإثراء إرجاع أي شيء خارج تلك القائمة، مما يمنع وصول المفهوم نفسه بثلاث صيغ إملائية مختلفة عبر عمليات التشغيل.

العمل مع مجموعات القيم

أنشئ واحدة

اضغط + على علامات تبويب الأنواع، واختر Enum، وسمِّه. تفتح علامة التبويب الجديدة قائمة عناصره.

تحرير العناصر

أضِف القيم أو أعِد تسميتها أو ترتيبها أو احذفها. أضِف ملاحظة إلى عنصر عندما لا يكون معناه واضحًا من اسمه.

استخدامها

اضبط نوع أي خاصية نصية على مجموعة القيم (أو على مصفوفة منها) من مجموعة «مجموعات القيم» في القائمة المنسدلة للأنواع.

التراجع عنه

أعِد ضبط نوع الخاصية إلى نص، أو احذف مجموعة القيم — ستعود الخصائص التي تستخدمها خصائص نصية عادية مرة أخرى.

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

تحرير الخصائص

انقر على صف خاصية أو اضغط Enter للتبديل إلى وضع التحرير. في وضع التحرير، يمكنك تعديل:

الاسممفتاح الخاصية في مخرجات JSON. استخدم snake_case لأجل الاتساق.
النوعاختر من بين سلسلة نصية أو رقم أو عدد صحيح أو قيمة منطقية أو مصفوفة أو كائن. يؤدي تغيير النوع إلى تحديث تنسيق مخرجات الإثراء.
الوصفوصف سياقي يوجّه الذكاء الاصطناعي أثناء الإثراء. المزيد من التفاصيل يؤدي إلى نتائج أفضل.
أمثلةقيمتان أو ثلاث قيم مثالية واقعية. تساعد هذه القيم الذكاء الاصطناعي على فهم التنسيق والمحتوى المتوقعين.
الخبرةأي خبير مجال يوفّر هذه القيمة. يحدّد التجميع في الإثراء متعدد مجالات الخبرة.
قابل للإبطال (Nullable)ما إذا كان بإمكان نسخة حقيقية أن تفتقر فعلًا إلى هذه القيمة. الحقول غير القابلة للقيمة الفارغة مطلوبة للقبول في قاعدة البيانات — فأي إثراء يعجز عن ملئها يرفضه بوّابة الجودة. غير متاح على مفتاح قاعدة البيانات (فالقيمة الفارغة لا تُعرِّف أي صف) وعلى حقل محفوظ (مُدخلك يوفّره دائمًا).
متعدد اللغاتما إذا كان ينبغي إثراء الحقل بعدة لغات.
الحفاظما إذا كان يجب الإبقاء على قيمة الإدخال الأصلية دون تغيير. للقيم التي يملكها نظامك الخاص — مُعرّف قاعدة بيانات، أو SKU داخلي، أو مرجع عميل — وليس للمُعرّفات العامة (CAS، ISBN، EAN، رمز التداول) التي يمكن للإثراء البحث عنها نيابةً عنك. وعندئذٍ يجب أن يوفّر كل إثراء قيمةً لها.

اختصارات لوحة المفاتيح

يدعم محرّر المخطط سير عمل كامل يعتمد على لوحة المفاتيح للتحرير بكفاءة:

اختصارإجراء
Arrow Up / Downالتنقّل بين الخصائص (اضغط مع الاستمرار على Shift لتوسيع التحديد)
Arrow Left / Rightطيّ الكائن المحدد أو توسيعه
Home / Endالانتقال إلى الخاصية الأولى أو الأخيرة
Enterتبديل وضع التحرير على الخاصية المحددة
Delete / Backspaceإزالة الخاصية المحددة
Ctrl+A / Cmd+Aتحديد كل الخصائص
Escapeالخروج من وضع التحرير أو مسح التحديد

إعادة الترتيب بالسحب والإفلات

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

عند تفعيل التجميع حسب مجال الخبرة، فإن إفلات خاصية داخل مجموعة مختلفة يُحدّث تلقائيًا تعيين مجال خبرتها. وهذا يجعل إعادة تنظيم المخططات الكبيرة أمرًا بديهيًا — ما عليك سوى سحب حقل من ”المحلل المالي“ إلى ”خبير التنظيم“ ويتحدّث مجال خبرته وفقًا لذلك.

جزء تحرير الذكاء الاصطناعي

أسفل شجرة الخصائص، يتيح لك جزء التحرير بالذكاء الاصطناعي تعديل المخطط باستخدام اللغة الطبيعية. اكتب تعليمة مثل «أضِف مرجع parent_company» فيطبّق الذكاء الاصطناعي التغيير مع الحفاظ على بنيتك الحالية.

اقتراحات الذكاء الاصطناعي

بعد كل عملية توليد أو تحرير، يقدّم الذكاء الاصطناعي 5 اقتراحات للتحسين تُعرض على هيئة شرائح قابلة للنقر. انقر اقتراحًا لملء حقل التحرير تلقائيًا وتطبيقه. تغطي الاقتراحات اكتمال البيانات والجودة والعلاقات والتوطين والتحسينات الخاصة بالمجال.

تعرّف على المزيد حول تحرير المخطط بالذكاء الاصطناعي في دليل إنشاء المخطط بالذكاء الاصطناعي.

شارات الالتباس

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

زر إعادة الفحص

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

العلاج هنا هو الوصف

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

توصيفات قديمة

إعادة تسمية خاصية أو تحرير وصفها يُسقط توصيفها — إذ صدر الحكم بناءً على كليهما. يُبرز المحرّر هذه الخصائص ويقدّم إعادة فحص.

مفتاح تبديل لكل مخطط

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

الآلية الكاملة — الحكمان، والتفسيرات وراء كلٍّ منهما، ولماذا يكون الإصلاح إعادة تسمية قبل وجود المخطط لكنه وصف بعد أن يصبح نشطًا — مشروحة في دليل فحص الالتباس.

إدارة المخطط

يتيح لك مُحدِّد المخطط إنشاء المخططات وتحميلها وتثبيتها ونسخها وحذفها. تُحفظ المخططات لكل مؤسسة وتكون متاحة لجميع أعضاء الفريق.

الحفظ التلقائي

تُحفظ التغييرات تلقائياً بعد توقّف لمدة ثانيتين، مع إزالة التكرار عبر تجزئة المحتوى لتجنّب عمليات الكتابة غير الضرورية.

تثبيت المخططات

ثبّت المخططات كثيرة الاستخدام لإبقائها في أعلى قائمة المحدِّد.

تكرار

أنشئ نسخة من أي مخطط لتجربة التغييرات دون التأثير على المخطط الأصلي.

الحذف المرن

يمكن استعادة المخططات المحذوفة. الحذف الدائم إجراء منفصل.

الخطوات التالية