دليل
كيف تجعل وكلاء الذكاء الاصطناعي يذكرون المصادر في قاعدة معرفتك
لتجعل وكلاء الذكاء الاصطناعي يذكرون المصادر، اذكر كل مصدر في frontmatter المستند بمعرّف ثابت، واشترط حاشية مثل [^billing-export] بعد كل معلومة، وكلّف وكيلًا ثانيًا بالتحقق من أن كل حاشية تقول ما تقوله المعلومة. وما لا مصدر له لا يدخل الملاحظة. ثم يُظهر لك Knowtarium، قاعدة المعرفة المشفّرة تشفيرًا تامًا بين الطرفين، المصدر الذي وراء أي استشهاد تمرّر المؤشر فوقه.
بقلم Fadel Kaadan · آخر تحديث
كيف تُفسد معلومةٌ بلا مصدر قاعدةَ المعرفة
قد يكتب الوكيل جملة سلسة ودقيقة التفاصيل لكنها خاطئة، فتبدو تمامًا مثل جملة نقلها من مصدر. وما إن تُحفظ في ملاحظاتك حتى لا يعود هناك ما يميّز إحداهما من الأخرى.
في قاعدة معرفة يكتبها الوكلاء، لا تبقى تلك الجملة في مكانها. فالجلسة التالية تقرؤها على أنها سياق وتكررها، ثم تتسلل إلى ملخص. وبعد شهر تظهر في أربع ملاحظات وتبدو أمرًا محسومًا. لم يخترعها أحد عن قصد، ولا يستطيع أحد أن يعرف من أين جاءت.
والاستشهاد يحل المشكلة في اللحظة التي يكون فيها الحل أقل كلفة: حين يكتب الوكيل المعلومة، يعرف أي ملف أو صفحة قرأ، ويكفيه سطر واحد ليسجّل ذلك. أما معرفة المصدر لاحقًا فتعني قراءة كل المصادر من جديد. كما أن قاعدة «كل معلومة تحتاج إلى مصدر» تغيّر ما يكتبه الوكيل: حين لا يوجد مصدر، عليه أن يقول ذلك بدل أن يملأ الفراغ.
يشرح هذا الدليل كيف تُعدّ الاستشهادات يدويًا، في frontmatter بسيط يستطيع أي وكيل كتابته. وبعد كل خطوة، تشرح ملاحظة قصيرة الخطوة نفسها في Knowtarium، قاعدة المعرفة المشفّرة تشفيرًا تامًا بين الطرفين التي نصنعها لملاحظات يكتبها الناس والوكلاء معًا.
مصدر لكل معلومة، أم لكل مستند؟
يمكنك أن تشترط المصادر على مستويين، ومعظم قواعد المعرفة تحتاج إلى الاثنين معًا.
| المستوى | الطريقة | متى تستخدمه |
|---|---|---|
| لكل مستند | قائمة مصادر في frontmatter | الملخصات، والعروض العامة، والملاحظات المأخوذة من اجتماع واحد أو تقرير واحد |
| لكل معلومة | حاشية بعد الجملة، تشير إلى أحد تلك المصادر | الأرقام والتواريخ والأسماء والاقتباسات والقرارات: كل ما قد يبني عليه أحدٌ قرارًا أو تصرفًا |
وإن أردت قاعدة عامة جيدة: كل مستند يذكر مصادره، وكل جملة فيها رقم أو تاريخ أو اسم أو اقتباس تشير إلى واحد منها. أما الآراء واستنتاجاتك أنت فلا تحتاج إلى حاشية، لكن ينبغي أن يتضح للقارئ أنها آراء.
في Knowtarium
يظهر المستويان كلاهما في Knowtarium: مصادر المستند تحت Details في خصائصه، بجانب من كتبه (ومن تحقق منه، في المجلدات التي فُعّلت فيها المراجعة)، وكل حاشية في النص استشهاد يُظهر مصدره حين تمرّر المؤشر فوقه.
(تُفتح بحجمها الكامل في علامة تبويب جديدة)
(تُفتح بحجمها الكامل في علامة تبويب جديدة)كيف تسجّل OKF المصادر في frontmatter
يمكنك أن تبتكر صيغة استشهاد خاصة بك، لكن الصيغة المنشورة تقرؤها كل أداة وكل وكيل بالطريقة نفسها. فصيغة Open Knowledge Format (OKF)، وهي مواصفة مفتوحة تنشرها Google Cloud، تسجّل مصدر المحتوى في حقل sources وتربط المعلومات به عبر الحواشي:
---type: Metrictitle: Churngenerated: { by: claude-code/2.1, at: 2026-09-26T08:10:00Z }stale_after: 2026-12-31T00:00:00Zsources:- id: billing-exportresource: /references/billing-2026-09.csvtitle: تصدير الفوترة، سبتمبر 2026author: process:billing-synclast_modified: 2026-09-25T23:00:00Z- id: pricing-decisionresource: /decisions/2026-07-01-annual-plans.mdtitle: تحويل الفوترة إلى الخطط السنوية---انخفض معدل الإلغاء الشهري إلى 2.4% في سبتمبر.[^billing-export]وجاء الانخفاض بعد الانتقال إلى الخطط السنوية.[^pricing-decision][^billing-export]: تصدير الفوترة، سبتمبر 2026[^pricing-decision]: تحويل الفوترة إلى الخطط السنوية
يحتاج كل مدخل في sources إلى resource: رابط، أو مسار داخل قاعدة المعرفة، أو ملف في مجلد references/. أما الحقول الأخرى فاختيارية:
id: مفتاح ثابت. وتقول المواصفة إنه ينبغي أن يوجد كلما استشهد نص المستند بالمصدر.title: اسم واضح يقرؤه الإنسان.author: من أنتج المصدر، شخصًا كان أو عملية، بصيغة مثلhuman:mayaأوprocess:billing-sync.last_modified: متى تغيّر المصدر نفسه آخر مرة.usage_count: عدد مرات استخدام المصدر خلال فترة يحددها حقل مجاور هوusage_window.
تسمية الحاشية هي ما يربط المعلومة بمصدرها. وتشرح المواصفة لماذا تكون id لا رقمًا مثل «المصدر 2»: فالوكلاء يعيدون كتابة هذه المستندات باستمرار، والإحالة المرقّمة تشير إلى المصدر الخطأ بمجرد أن يعيد أحد ترتيب القائمة. أما المعرّف بالاسم فيبقى صحيحًا.
وحين يشير resource إلى مستند آخر في قاعدة المعرفة، يصبح هذا الرابط سلسلة الإسناد: يتتبعه القارئ حتى يصل إلى مصادر ذلك المستند نفسه. وتسجّل OKF هذه المؤشرات، لا درجة ثقة جاهزة. اقرأ القواعد كاملة في مواصفة OKF.
قواعد تجعل الوكلاء يستشهدون بالمصادر
يتبع الوكلاء ملف التعليمات الذي يقرؤونه في بداية الجلسة: AGENTS.md لمعظم الأدوات، وCLAUDE.md لـClaude Code. أضف إليه قسمًا للمصادر:
## المصادر- كل رقم وتاريخ واسم واقتباس وقرار يحتاج إلى مصدر.- أضف كل مصدر إلى `sources` بمعرّف `id` قصير وثابت، ومعه `resource`.- أشر إليه بحاشية بعد المعلومة مباشرة: [^the-id].- لا تستشهد إلا بمصدر فتحته في هذه الجلسة. ولا تخترع أبدًا رابطًاأو عنوانًا.- انقل الأرقام كما وردت في المصدر تمامًا، دون تقريب.- احفظ نسخة من صفحات الويب والملفات المصدّرة التي تستشهد بها في references/.- إن لم تجد مصدرًا، فلا تذكر المعلومة. ضعها تحت«## أسئلة مفتوحة» مع ما تحتاجه لتأكيدها.- لا تغيّر `id` أي مصدر بعد أن يستشهد به مستند.
قاعدتان منها تؤديان معظم العمل: «لا تستشهد إلا بمصدر فتحته» تمنع الوكيل من أن ينسب إلى صفحة ما يتذكر أنها قالته. و«إن لم تجد مصدرًا، فلا تذكر المعلومة» تعطيه مكانًا يضع فيه تخمينه بعيدًا عن ملاحظاتك. والقالب الكامل موجود في دليلنا عن ملف AGENTS.md لقاعدة معرفة.
واحتفظ بنسخ مما تستشهد به، فصفحات الويب تتغير والملفات المصدّرة يُكتب فوقها. وبنسخة محفوظة في references/ يبقى الاستشهاد قابلًا للتحقق حتى بعد عام.
اجعل وكيلًا ثانيًا يتحقق من الاستشهادات
القواعد تقلّل الاستشهادات الخاطئة، لكنها لا تلغيها. فقد يستشهد الوكيل بمصدر حقيقي على معلومة لا يقولها المصدر أصلًا. لذلك تحقق من الاستشهادات في خطوة مستقلة، على مرحلتين.
1. المرحلة الآلية
يجب أن تطابق كل حاشية معرّفًا في sources، وأن تشير حاشية ما إلى كل معرّف. ويمكنك أن ترى القائمتين من الطرفية:
# تسميات الحواشي المستشهد بها في نص المستند# المعرّفات المعلنة في frontmatter
2. مرحلة القراءة
ثم كلّف جلسة وكيل أخرى بمقارنة كل معلومة بمصدرها. ابدأها من الصفر، دون سياق جلسة الكتابة، لتقرأ المستند بعين غريب لا يعرفه. والأفضل من ذلك وكيل آخر تمامًا، كأن يتحقق Codex من عمل Claude Code.
تحقق من الاستشهادات في metrics/churn.md. لا تغيّر المستند.1. لكل حاشية، ابحث عن مدخل sources الذي يحمل المعرّف نفسه.أبلغ عن الحواشي التي لا مدخل لها، والمداخل التي لا تشير إليها أي حاشية.2. افتح كل resource. أبلغ عن أي مورد غير موجود.3. لكل معلومة مستشهد بها، اقتبس المقطع من المصدر الذييؤيدها، أو قل إنك لم تجد مقطعًا كهذا.4. أبلغ عن كل معلومة فيها رقم أو تاريخ أو اسم ولا تشير إلى أي مصدر.إن ثبتت صحة كل المعلومات، فأضف نفسك إلى `verified` معالوقت الحالي بتوقيت UTC. وإن لم تثبت، فاذكر المشكلات وتوقف.
والخطوة الأخيرة تسجّل التحقق. ففي OKF، مدخل verified من وكيل يجعل المستند machine-confirmed. وحين تقرؤه بنفسك وتضيف مدخلك human:، يصبح human-reviewed:
verified:- { by: second-agent/1.0, at: 2026-09-26T09:02:00Z } # الوكيل الذي يتحقق- { by: human:maya, at: 2026-09-26T10:30:00Z } # أنت، بعد قراءته
لا تدع وكيلًا يوقّع نيابة عنك
اطلب من الوكلاء ألّا يضيفوا مدخل human: أبدًا. فالبادئة human: هي ما يجعل التحقق يُحتسب مراجعةً من إنسان، ولذلك يجب ألّا يكتبها إلا إنسان.
في Knowtarium
في مجلدات Knowtarium التي فُعّلت فيها المراجعة، يمثّل المدخلان أعلاه وجهَي التحقق: فحص الوكيل يجعل المستند machine-confirmed، ومراجعتك أنت تضيف مدخل human:، ووجود الاثنين بعد آخر تغيير يجعله fully verified. ولا يستطيع الوكلاء أن يسجّلوا تحققًا باسم إنسان، فتبقى القاعدة أعلاه سارية حتى لو تجاهلها وكيل.
المصادر تتغير، والاستشهادات تنتهي صلاحيتها
صحة الاستشهاد مرهونة بوقت التحقق منه. فأعطِ المستندات التي فيها أرقام تاريخ stale_after، وسجّل last_modified للمصادر التي تعرف أنها تتغير. وحين يحل تصدير أكتوبر محل تصدير سبتمبر، ينبغي أن تعيد التحقق من ملاحظة معدل الإلغاء، لا أن تواصل الوثوق بها دون انتباه. ويصبح المستند قديمًا بمجرد أن يتجاوز الوقت الحالي تاريخ stale_after فيه، أيًّا كان من تحقق منه.
في Knowtarium
تعرض صفحة Stale and expiring في Knowtarium المستندات التي تجاوزت stale_after وتلك التي يقترب موعدها. وأي تحديث تغيير جديد: موقّع ويمكن التراجع عنه، وفي مجلد فُعّلت فيه المراجعة، ينتظر موافقتك.
تتبّع كل استشهاد في Knowtarium
يقرأ Knowtarium حقل sources والحواشي التي تشير إليه، ويضعها أمامك وأنت تقرأ. ولا يتغير شيء في الصيغة: الاستشهادات هي صيغة OKF البسيطة نفسها التي يكتبها وكلاؤك أصلًا، محفوظة في مساحة عملك ومشفّرة تشفيرًا تامًا بين الطرفين.
- لكل معلومة أثر تتتبعه. مرّر المؤشر فوق استشهاد لترى المصدر الذي وراءه، ومن أنشأه، ومتى تغيّر آخر مرة؛ وانقر عليه، فيُبرَز المصدر في تفاصيل المستند.
- خصائص واضحة، لا YAML خام. يظهر frontmatter في أعلى المستند: من كتبه (ومن تحقق منه، في المجلدات التي فُعّلت فيها المراجعة)، ومتى تنتهي صلاحيته، ومن أين جاء.
- مخطط لروابطك. يُظهر ما أصبح قديمًا، ومع تفعيل المراجعة، يستطيع أن يلوّن المستندات بحسب مستوى الثقة، فتبرز الملاحظات التي لم يتحقق منها أحد. أما الروابط إلى مستندات لم تُكتب بعد فتظهر عقدًا باهتة.
- بحث في النص الكامل. اعثر، بينما تكتب، على كل مستند يذكر رقمًا أو مصدرًا، مع النص المطابق. ويجري البحث في متصفحك، لأننا لا نستطيع قراءة ملاحظاتك (أما الوكلاء الذين تربطهم فيرون ما يقرؤونه).
(تُفتح بحجمها الكامل في علامة تبويب جديدة)
(تُفتح بحجمها الكامل في علامة تبويب جديدة)حين يتغير مصدر أو رقم
تظهر قيمة الاستشهادات حين يتغير شيء. فإن أعاد وكيل كتابة ملاحظة معدل الإلغاء، كان التغيير موقّعًا ومعلَّمًا على المستند، مع الفروقات وزر Undo؛ وفي مجلد فُعّلت فيه المراجعة، ينتظر على شكل فروقات حتى توافق عليه. وإن صحّحت رقمًا بنفسك في مجلد كهذا، بقي تعديلك بانتظار فحص وكيل: حين تطلب ذلك، يقرأ وكيلك الفروقات، ويتتبع الروابط والمستندات التي تشاركه المصدر، ثم يصحح القيمة القديمة أينما بقيت أو ينبّه إليها.
ولا يستدعي Knowtarium أي ذكاء اصطناعي من تلقاء نفسه؛ فالوكلاء الذين تستخدمهم أصلًا يتصلون عبر MCP ويتولون الكتابة والتحقق. اطّلع على كل الميزات.
أسئلة
كيف أجعل وكيل ذكاء اصطناعي يذكر مصادره؟
اكتب القاعدة في ملف التعليمات الذي يقرؤه، مثل AGENTS.md أو CLAUDE.md: كل رقم وتاريخ واسم واقتباس تتبعه حاشية تشير إلى مصدر مذكور في frontmatter. ثم كلّف وكيلًا ثانيًا بمقارنة كل استشهاد بمصدره.
هل تمنع الاستشهادات هلوسات الذكاء الاصطناعي في ملاحظاتي؟
لا تمنع الوكيل من اختلاق المعلومات، لكنها تكشف ما يختلقه. فالمعلومة التي بلا مصدر، أو المصدر الذي لا يقول ما تقوله المعلومة، يسهل اكتشافهما عند المراجعة. ومن دون استشهادات، تبدو المعلومة الخاطئة مثل الصحيحة تمامًا.
ما المقصود بحقول المصدر (provenance) في frontmatter؟
حقول في أعلى ملف markdown تسجّل من أين جاء المحتوى ومن تعامل معه. ففي Open Knowledge Format، يذكر sources المواد التي يُستمد منها المستند، ويسجّل generated من كتبه، ويسجّل verified من تحقق منه.
لماذا أستخدم معرّفات للحواشي بدل الاستشهادات المرقّمة؟
يعيد الوكلاء كتابة المستندات كثيرًا. والإحالة المرقّمة تشير إلى المصدر الخطأ ما إن يُعاد ترتيب القائمة، بينما يبقى المعرّف المسمّى مثل [^billing-export] مرتبطًا بالمصدر الصحيح.
هل ينبغي أن يتحقق من الملاحظة الوكيلُ نفسه الذي كتبها؟
الأفضل ألّا يفعل. استخدم جلسة جديدة أو وكيلًا آخر، كي لا يرث الفحص افتراضات الكاتب. وفي كل ما هو مهم، اقرأه بنفسك أيضًا وأضف مدخلك في verified.
كيف أرى المصدر الذي وراء استشهاد ما؟
في ملف markdown، ابحث عن مدخل sources الذي يطابق معرّفه تسمية الحاشية، وافتح ما في حقل resource. وفي Knowtarium، تمرّر المؤشر فوق الاستشهاد فيُظهر لك المصدر الذي وراءه، ومن أنشأه، ومتى تغيّر آخر مرة.