الذاكرة: اجعله يتذكر السياق
بعد قراءة هذا القسم، سيظل الـ Agent الخاص بك يتذكر ما فعله سابقًا حتى بعد إغلاقه وإعادة فتحه؛ ولن تنفجر المحادثة حتى عندما تصبح طويلة جدًا.
النموذج نفسه لا يتذكر أي شيء
في كل مرة تستدعي فيها النموذج، يكون «اللقاء الأول معك». والسبب في شعورنا بأنه يتذكر المحادثة السابقة هو أننا نعيد إرسال المحادثة كاملة (قائمة messages) إليه في كل مرة. حلقة القسم السابق تفعل ذلك بالضبط.
إذن ذاكرة الـ Agent، ببساطة، هي إدارة هذه القائمة:
- احفظها: اكتبها في ملف قبل خروج البرنامج، واقرأها مجددًا عند الإقلاع التالي؛
- لا تجعلها طويلة جدًا: الطول الذي يستطيع النموذج رؤيته محدود، والطول الزائد يجعله أبطأ وأكثر تكلفة.
الحفظ على القرص: ذاكرة عبر الجلسات
MEMORY = HERE / ".agent" / "history.json" # 对话记忆存在这里,下次启动接着聊
def load_memory():
return json.loads(MEMORY.read_text(encoding="utf-8")) if MEMORY.exists() else []
def save_memory(messages):
MEMORY.parent.mkdir(exist_ok=True)
MEMORY.write_text(json.dumps(messages, ensure_ascii=False, indent=1), encoding="utf-8")احفظ مرة واحدة في نهاية كل جولة حوار. هكذا تحققنا من ذلك: شغّلناه مرة واحدة ليجمع التقرير الأسبوعي (وفقًا لمتطلبات المهارة، عرض النص الكامل على المستخدم قبل كتابة الملف، ثم انتهى البرنامج)؛ ثم أطلقنا عملية جديدة وقلنا جملة واحدة فقط:
python agent.py "确认,就按这个写入文件"ينبغي أن ترى:
[1] write_file({"path": "./周报.md", "content": "# 周报\n## 本周完成\n- 周一:修复登录页在 Safari 上的样式错位\n- ……"})
⚠️ كتابة الملف ./周报.md (175 حرف)؟ [y/N] y
Agent: تم إنشاء ملف 周报.md، ويتضمن ملخص أعمال هذا الأسبوع والخطة.في العملية الجديدة لم يقرأ تلك الملفات المسجّلة قط، لكنه يعرف ماذا يعني «هذا» وما هو محتوى التقرير الأسبوعي، لأن الذاكرة قُرئت مجددًا من history.json.
ماذا لو صارت طويلة جدًا: الضغط إلى ملخص
def compact(messages):
if len(json.dumps(messages, ensure_ascii=False)) < KEEP_CHARS:
return messages
old, recent = messages[:-8], messages[-8:]
while recent and recent[0]["role"] == "tool": # 别把工具结果和它对应的调用拆开
old, recent = old + recent[:1], recent[1:]
summary = client.chat.completions.create(model=MODEL, messages=[
{"role": "user", "content": "把下面的对话压缩成要点(事实、决定、未完成的事),不超过 300 字:\n"
+ json.dumps(old, ensure_ascii=False)[:20000]}]).choices[0].message.content
return [{"role": "user", "content": "【之前对话的摘要】" + summary},
{"role": "assistant", "content": "好的,我记住了。"}] + recentالفكرة: الاحتفاظ بآخر 8 رسائل بالنص الأصلي، وما هو أقدم يُترك للنموذج ليضغطه بنفسه إلى ملخص واحد يوضع في المقدمة.
تلك الحلقة while مهمة جدًا: إذا وقعت نقطة التقسيم على رسالة tool بالضبط، فسيُضغط استدعاء الأداة المقابل لها في الملخص، وتبقى نتيجة أداة «يتيمة» كثيرة من الواجهات سترفض معها الطلب بخطأ مباشرة. لذا يجب التأخر للخلف حتى لا نبدأ من رسالة tool.
يتم الضغط افتراضيًا فقط عند تجاوز 24000 حرف. ولأغراض العرض التوضيحي، استخدمنا متغير بيئة لخفض العتبة مؤقتًا إلى 1500 حرف:
AGENT_KEEP_CHARS=1500 python agent.py "worklog 里周三做了什么?"ينبغي أن تراه يجيب على السؤال أولًا، ثم يعرض التنبيه:
(الذاكرة طويلة جدًا، وقد ضُغطت المحادثة الأقدم إلى ملخص)افتح .agent/history.json، ستجد أن الرسالة الأولى أصبحت هكذا (نتيجتنا الفعلية هذه المرة):
【ملخص المحادثة السابقة】**حقائق**:
- مجلد worklog يحتوي على 11-16.txt و11-18.txt و11-20.txt.
- بعد التجميع يتضمن التقرير الأسبوعي: مكتمل هذا الأسبوع (5 بنود)، جارٍ العمل (1 بند)، خطة الأسبوع القادم (1 بند)، يحتاج مساعدة (لا شيء).
……ابحثطرق أخرى لتنفيذ الذاكرة
انقر على واحد لترى.
اختبر معرفتكعند ضغط الذاكرة، لماذا لا يجوز أن يبدأ الجزء المحتفظ به برسالة tool؟
تحقّق
- أفهم أن «الذاكرة هي سجل المحادثة الذي يُرفق في كل مرة»
- أغلقت الـ agent وأعدت تشغيله، وما زال يتذكر محتوى المرة السابقة
- استخدمت عتبة صغيرة لتشغيل ضغط الملخص مرة واحدة
القسم التالي: المهارات: SKILL.md.