إدارة مستندات قاعدة المعرفة

الغرض من هذه الصفحة

صفحة المستندات (Documents) هي مساحة الإدارة للمحتوى الذي يستخدمه وكلاء الذكاء الاصطناعي. وهي منفصلة عن مكتبة المستندات العادية؛ تخزن المكتبة ملفات العمل، بينما تجهز هذه الصفحة المحتوى المحدد للبحث في قاعدة المعرفة.

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

فهم تخطيط الصفحة

للصفحة منطقتان رئيسيتان:

• تحتوي اللوحة اليسرى على إدخال المحتوى والبحث في المستندات وقائمة المستندات وعنصر تحكم الإعداد المسبق وإدارة السياسات (Manage Policies) وتحديث القائمة (Refresh list) والمزيد (More)؛
• تفتح المنطقة الرئيسية استوديو مسار المعالجة (Pipeline Studio) للمستند المحدد.

اختر مستندًا من اللوحة اليسرى قبل تغيير معالجته أو سياساته أو تضمينه أو اختباراته.

إضافة محتوى

توفر الصفحة الحالية طريقتي إدخال ظاهرتين: المستندات وMarkdown.

الاستيراد من المستندات

1. اختر المستندات.
2. انقر تصفح المستندات (Browse Documents).
3. ابحث في الملفات المتوافقة داخل مربع الاستيراد من المستندات (Import from Documents).
4. اختر ملفًا واحدًا، ثم انقر استيراد (Import).

تدعم قائمة الاستيراد محتوى PDF وDOCX وTXT وMD وHTML. الملف الذي يحمل علامة موجود في قاعدة المعرفة (In Knowledge) لديه مستند مطابق بالفعل؛ يؤدي اختياره إلى تحميل المستند القائم بدلًا من إنشاء نسخة أخرى.

إضافة Markdown

1. اختر Markdown.
2. أدخل اسم ملف المصدر (Source filename).
3. الصق Markdown، أو انقر تحميل ‎.md (Load .md) لتحميل ملف .md أو .txt.
4. انقر تشغيل مسار المعالجة (Run Pipeline).

يلزم اسم الملف ومحتوى Markdown معًا. ينشئ تشغيل مسار المعالجة المستند ويبدأ معالجته بالإعدادات الحالية.

العثور على مستند واختياره

استخدم البحث في المستندات (Search documents) لتصفية القائمة حسب اسم الملف. تعرض كل بطاقة اسم الملف ونوعه أو معلومات مصدره وحالة المعالجة الحالية وعنصر تحكم إعداد المعالجة المسبق.

تشمل النتائج المحتملة للقائمة:

• لا توجد مستندات بعد (No documents yet) — لم تُضف مستندات إلى قاعدة المعرفة؛
• لم يُعثر على تطابق (No match found) — لا يطابق نص البحث الحالي أي مستند؛ و
• مؤشر تحميل أثناء تحديث القائمة.

انقر تحديث القائمة بعد رفع خارجي أو مهمة مزامنة تلقائية إذا لم تظهر الحالة الجديدة بعد.

استخدام إعدادات المعالجة المسبقة

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

• اختيار إعداد محفوظ وتطبيقه على المستند؛
• حفظ الإعدادات الحالية كإعداد جديد؛
• تحديث إعداد بالحفظ بالاسم نفسه؛ أو
• حذف إعداد لم تعد تحتاج إليه.

لا يؤدي حذف إعداد مسبق إلى حذف مستند. راجع قواعد المزامنة التلقائية قبل الحذف، لأن قاعدة قد تعتمد عليه.

فهم استوديو مسار المعالجة

ينظم الاستوديو العمل في أربع خطوات رئيسية:

توضح مؤشرات المراحل ما إذا كان العمل لم يبدأ أو قيد التنفيذ أو مكتملًا أو فاشلًا. قد يظل إجراء لاحق مقفلًا حتى تصبح النتيجة السابقة المطلوبة جاهزة.

الخطوة 1: تشغيل مراحل المعالجة

1. تحليل Markdown

اختر كيفية تحويل المصدر إلى Markdown منظم:

• يقرأ الاستخراج المباشر (Direct Extract) ملفات PDF الرقمية والملفات النصية بسرعة. ولا يتعامل مع المستندات الممسوحة أو المبنية على الصور.
• يدعم المسار الكامل (Full Pipeline) التعرف البصري على الحروف والملفات الممسوحة والتخطيطات المعقدة.

عند اختيار المسار الكامل، قد تشمل خيارات التحليل (Parse Options):

• مستوى التحليل (Parsing Tier)؛
• الصفحات المستهدفة (Target Pages)؛
• الحد الأقصى للصفحات (Max Pages)؛
• حجم الدفعة (Batch Size)؛
• حفظ الصور (Save Images)؛
• لغات (Languages) المستند؛ و
• موجّه مخصص (Custom Prompt) اختياري.

انقر تشغيل تحليل Markdown (Run Markdown Parse). بعد الاكتمال، استخدم عرض / تحرير Markdown (View / Edit Markdown) لمعاينته أو تحريره أو حفظه أو نسخه أو تنزيله أو عرضه بملء الشاشة. وإذا كان استخراج الصور مفعّلًا، فاستخدم عرض الصور المستخرجة (View Extracted Images).

2. العُقد البنيوية والتقسيم إلى مقاطع

تحول هذه المرحلة Markdown إلى عناصر دلالية ومقاطع جاهزة للاسترجاع. تأتي عادة بعد التحليل بإعدادات افتراضية مناسبة.

وسّع خيارات التقسيم (Chunking Options) فقط عندما تحتاج إلى تغيير:

• الحد الأقصى لرموز المقطع (Max Chunk Tokens) — أكبر حجم لكل مقطع؛ أو
• تداخل المقاطع (Chunk Overlap) — مقدار السياق المشترك بين المقاطع المتجاورة.

بعد الاكتمال، يمكنك استخدام عرض / تحرير Chunk JSON (View / Edit Chunk JSON) وتصفح العُقد (Browse Nodes) لفحص الإخراج.

3. ملخصات الجداول

تنتج هذه المرحلة ملخصات بلغة طبيعية تجعل الجداول قابلة للبحث. تُتجاوز تلقائيًا عندما لا يحتوي المستند على جداول.

اختر نموذج التلخيص (Summary Model)، وراجع موجّه التلخيص (Summary Prompt) أو عدّله، ثم انقر تشغيل ملخصات الجداول (Run Table Summaries). استخدم عرض ملخصات الجداول (View Table Summaries) لفحص النتيجة.

4. إثراء LLM

تضيف هذه المرحلة إلى كل مقطع ملخصات سياقية وكيانات مسماة واكتشاف معلومات حساسة ونتائج استخراج مخصصة اختيارية.

الإعدادات الظاهرة هي:

• نموذج الإثراء (Enrichment Model)؛
• إضافة موجّه المستخدم (User Prompt Add-on)؛
• موجّه الإثراء الأساسي (Base Enrichment Prompt)؛ و
• قواعد الاستخراج (JSON) (Extraction Rules).

تمنع صيغة JSON غير الصالحة لقواعد الاستخراج تشغيل المرحلة. بعد الاكتمال، انقر عرض نتائج الإثراء (View Enrichment Results) لفحص المقاطع والكيانات وفئات المعلومات الحساسة والنتائج المخصصة.

إدارة إصدارات المراحل

يمكن لكل مرحلة مكتملة الاحتفاظ بإصدارات عدة. يتيح لك منتقي الإصدار:

• اختيار النتيجة التي ستُمرر إلى المرحلة التالية؛ و
• حذف إصدار متقادم للمرحلة.

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

الخطوة 2: تطبيق سياسات الوصول

تعرض خطوة سياسة الوصول أولًا ملخص السياسات الحالي:

• سياسة المستند؛
• استثناءات الصفحات؛ و
• استثناءات العُقد.

استخدم تعيين سياسة (Assign Policy) واختر إحدى علامات التبويب:

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

تؤثر تغييرات السياسة في عمليات التضمين اللاحقة. إذا كان المستند مضمّنًا بالفعل، فانقر مزامنة الوصول (Sync Access) تحت مزامنة الوصول إلى فهرس البحث (Sync Access to Search Index) حتى تستخدم نتائج البحث الحالية أحدث بيانات السياسة الوصفية.

استخدم إدارة السياسات أعلى قائمة المستندات لإنشاء تعريفات السياسات المتاحة أو تحريرها. راجع إدارة سياسات الوصول إلى قاعدة المعرفة.

الخطوة 3: تضمين المستند

يحول التضمين المتجهي (Vector Embedding) المقاطع المعالجة إلى تمثيل قابل للبحث.

1. اختر نموذج تضمين (Embedding Model).
2. اختر أبعاد تضمين (Embedding Dimensions) يدعمها النموذج.
3. راجع ملخص النموذج والأبعاد.
4. انقر تضمين المستند (Embed Document).

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

لا يحل التضمين محل نجاح التحليل والتقسيم. تأكد من المرحلتين أولًا.

الخطوة 4: اختبار النتيجة

اختبار التشابه

أدخل:

• استعلامًا ذا صلة (Relevant Query) ينبغي أن يطابق المستند المحدد؛
• استعلامًا غير ذي صلة (Irrelevant Query) ينبغي ألا يطابقه؛ و
• الحد الأدنى (Threshold) المطلوب.

انقر تشغيل اختبار التشابه (Run Similarity Test). تعرض النتيجة الدرجتين وحكم نجاح (PASS) أو فشل (FAIL). قد يعني الفشل أن الاستعلام ذا الصلة لا يصف المستند جيدًا، أو أن الحد صارم جدًا، أو أن المستند يحتاج إلى المعالجة والتضمين مجددًا.

اختبار أقرب عنصر مجاور

أدخل استعلامًا وانقر تشغيل (Run). تعيد الصفحة أقرب ثلاثة مقاطع من المستند المحدد، بما فيها الدرجة وصفحة المصدر ومسار القسم عند توفره ومعاينة المحتوى.

استخدم الاختبار للتأكد من استرجاع المقطع المتوقع، لا من ارتفاع الدرجة الرقمية فحسب.

فتح صفحات الإدارة ذات الصلة

افتح المزيد في رأس المستندات للوصول إلى:

• قواعد المزامنة التلقائية (Auto-Sync Rules) — إنشاء قواعد المعالجة التلقائية وإدارتها؛
• سجل المزامنة (Sync History) — فتح المزامنة التلقائية مباشرة على سجل المهام؛ و
• إحصاءات المزامنة (Sync Stats) — فتح المزامنة التلقائية مباشرة على الإحصاءات.

راجع إدارة المزامنة التلقائية لقاعدة المعرفة.

حذف مستند من قاعدة المعرفة

اختر المستند، ثم انقر حذف المستند (Delete document) في رأسه. لا تؤكد إلا عندما ينبغي إزالة المستند من قاعدة المعرفة.

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

استكشاف الأخطاء وإصلاحها