حفظ معرف المقطع: كيف يعود القارئ إلى المصدر؟

الخلاصة السريعة

احفظ رابطا واضحا بين المقطع ونسخة المصدر وموضعه، ثم افحصه بعد تجهيز النص أو تحديث الفهرس. المعرف الداخلي ليس مرجعا جاهزا للقارئ.

• يميز معرف العقدة سجلا في LlamaIndex، ويمكن توليده أو تحديده؛ ذلك لا ينشئ وحده رابطا للقارئ إلى الأصل. ^[1]
• اربط المعرف بالمصدر والنسخة والموضع والنص المختار، وميز موضع الأصل عن ترتيب النص بعد معالجته.
• افحص العلاقة عند تحديث التقسيم أو المصدر؛ لا تفترض بقاء المعرف أو رقم الصفحة صالحا تلقائيا.
• اختبر الوصول إلى الفقرة ومطابقة معناها؛ فتح ملف صحيح لا يثبت أن المرجع يساند كل عبارة في الجواب.

ما الذي يسميه المعرف؟

تصف وثائق LlamaIndex العقدة كمقطع من مستند يحمل معلومات وعلاقات، وتوضح أن معرفها ينشأ تلقائيا أو يحدد يدويا ويستخدم في إدارة العقد والعلاقات. ^[1]

في مثالنا، يشرح كتيب نشاط للأقنعة الورقية أن الخيط يوزع في نهاية العمل. نعطي المقطع اسما تعليميا «قناع-07». هذا اسم اخترناه، وليس ناتج برنامج. يستطيع النظام بهذا الاسم تمييز سجل، لكن القارئ لا يعرف منه اسم الكتيب أو الفقرة. وقد يظهر الاسم نفسه في شرحنا دون أن يوجد أي ملف قابل للفتح.

أي علاقة نحتاج إلى حفظها؟

نقترح سجلا يربط «قناع-07» بكتيب «نشاط الأقنعة»، ونسخته المعتمدة، وفقرة «توزيع الأدوات»، وموضع نص توزيع الخيط. أضف الوجهة التي يستطيع القارئ الوصول إليها فعلا، وفق صلاحياته. ليست هذه حقولا تضمنها كل أداة تلقائيا؛ إنها طريقة تنظيم مقترحة.

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

ماذا يتغير عند إعادة البناء؟

افترض أننا غيرنا طول المقاطع فدخل توزيع الخيط في مقطع آخر. راجع العلاقة المحفوظة بدلا من الاعتماد على اسم قديم. وإذا أضيفت صفحة مقدمة إلى الكتيب، راجع موضع الفقرة في النسخة الجديدة. لا تعني إضافة مصدر إلى الفهرس أن كل إحالة محفوظة حدثت تلقائيا.

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

كيف نفحص ما يصل إليه القارئ؟

اقترح مراجعة إحالة محددة: افتح الوجهة المعلنة، ثم اعثر على فقرة توزيع الخيط وقارنها بما استعمل في الجواب. إذا فتح الرابط بداية الكتيب فقط، وضح للقراء موضع الفقرة إن كان معلوما؛ لا تدع وجود رابط يوحي بأنه يأخذهم مباشرة إلى السطر المطلوب.

ثم افحص العبارة نفسها. نص «يوزع الخيط في النهاية» لا يدعم وعدا بأن كل مشارك يحصل على خيط بلون معين. وإذا تعذر الوصول أو لم تعد النسخة محفوظة، سجل هذا الحد ولا تخترع وجهة بديلة. المقال يشرح علاقة مقترحة بين سجل ومرجع، ولم ننشئ فهرسا أو نجرب فتح الملفات هنا.