مراجع السياق — استشهادات دقيقة

مرحبًا بعودتكم إلى سلسلتنا حول وكيل Hermes! اليوم سنغوص في ميزة تجعل وكيلك أكثر فائدة بشكل كبير: مراجع السياق. إذا كنت يومًا ما تمنيت أن يتمكن وكيلك من الإشارة إلى المكان المحدد الذي حصل منه على المعلومات — مثل ورقة بحثية حقيقية مع استشهادات — فهذه هي الميزة المناسبة لك.

ما هي مراجع السياق؟

تخيل مراجع السياق كحواشي سفلية في كتاب. عندما يعالج وكيلك مستندًا أو محادثة أو ملفًا، يمكنه الآن تذكر من أين جاءت أجزاء محددة من المعلومات. بدلًا من مجرد القول “السماء زرقاء”، يمكنه القول “السماء زرقاء (من weather_report.md، السطر 42)”.

هذه الميزة تغيّر قواعد اللعبة في:

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

كيف تعمل؟

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

إليك مثال بسيط:

hermes chat --with file:contract.pdf

اطرح سؤالًا مثل “ما هو شرط الإنهاء؟” وسيرد الوكيل مع استشهاد يشير إلى القسم المحدد في ملف PDF.

خيارات التكوين الجديدة

يقدّم التحديث الأخير طرقًا جديدة وقوية للتحكم في سلوك مراجع السياق. كل هذه الخيارات موجودة في ملف ~/.hermes/config.yaml الخاص بك.

التفعيل والتعطيل

بشكل افتراضي، مراجع السياق مفعّلة للمحتوى المستند إلى الملفات. لكن يمكنك التحكم بها لكل جلسة:

context_references:
  enabled: true              # المفتاح الرئيسي
  include_line_numbers: true # إضافة أرقام الأسطر إلى الاستشهادات
  max_citations: 5           # الحد الأقصى لعدد المراجع لكل رد

صيغ الاستشهادات

يمكنك اختيار كيفية ظهور الاستشهادات في الردود:

context_references:
  format: markdown  # الخيارات: markdown, plain, json

• markdown — [المصدر: file.md، السطر 12] (يظهر بشكل جميل في واجهات الدردشة)
• plain — (file.md:12) (مدمج، مناسب للطرفيات)
• json — مخرجات منظمة للاستخدام البرمجي

العمل مع الجلسات

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

hermes chat --session research-project

اسأل “ماذا تعلمنا عن التسعير سابقًا؟” وستحصل على استشهاد يشير إلى الرسالة المحددة من ساعتين مضت.

نصائح عملية

1. استخدم أسماء ملفات وصفية

الاستشهاد يتضمن اسم الملف، لذا اجعلها ذات معنى:

hermes chat --with docs/Q3-financial-report.md

أفضل من file1.txt، أليس كذلك؟

2. ادمجها مع الذاكرة

تعمل مراجع السياق بشكل رائع مع نظام الذاكرة في Hermes. عندما يخزن الوكيل شيئًا في memories/، يسجل أيضًا المصدر. لاحقًا، عندما يسترجع تلك الذاكرة، يمكنه إخبارك من أين جاءت المعلومة أصلًا.

3. تحقق من إعداداتك

بعد تحديث Hermes، قم بتشغيل:

hermes config check
hermes config migrate

هذا يضمن توفر جميع الخيارات الأحدث لديك.

مثال سريع

لنرَها أثناء العمل:

hermes chat --with ~/notes/meeting-notes.md

أنت: “ما بنود العمل التي اتفقنا عليها؟”

الوكيل: “بناءً على ملاحظات الاجتماع، اتفقتم على:

1. إنهاء ميزانية الربع الثالث (من meeting-notes.md، السطر 15)
2. جدولة عرض العميل (من meeting-notes.md، السطر 22)
3. تحديث الجدول الزمني للمشروع (من meeting-notes.md، السطر 28)“

لاحظ كيف أن كل بند له استشهاده الخاص؟ هذا هو عمل مراجع السياق.

تذكير بأولوية التكوين

تذكر، يتم حل الإعدادات بالترتيب التالي:

1. وسائط سطر الأوامر — الأولوية القصوى
2. config.yaml — ملف التكوين الرئيسي
3. .env — للأسرار فقط
4. القيم الافتراضية المدمجة — كخيار احتياطي

لذا يمكنك تجاوز إعدادات مراجع السياق لكل أمر:

hermes chat --with file:report.pdf --set context_references.format=plain

الخلاصة

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

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

استشهادًا سعيدًا! 🎯