في درس تحسين على كود الوكيل أصبحت لدينا محادثة تفاعلية، وأصبح النموذج يقرأ ما قيل قبل قليل. ولكن حين أغلقنا الملف بـ exit نسي الوكيل كل شيء.
في هذا الدرس نحل هذه المشكلة: نحفظ المحادثة في ملف، ونقرأ الملف حين يبدأ الوكيل، فيتذكر حتى بعد إغلاقه.
في هذا الدرس
لماذا ينسى الوكيل؟
القائمة messages توجد في ذاكرة الجهاز ما دام ملفنا يعمل فقط. وحين نكتب exit ينتهي الملف، وتُمسح القائمة معه.
والحل بسيط: نحتاج إلى مكان يبقى بعد انتهاء الملف. والمكان المعتاد هو ملف على القرص.
فنفعل شيئين:
- بعد كل رد نكتب القائمة كلها في ملف اسمه
memory.json. - عند بدء التشغيل نبحث عن هذا الملف، فإن وجدناه قرأنا القائمة منه، وإن لم نجده بدأنا بقائمة جديدة.
وكلمة json في اسم الملف تعني أننا نكتب فيه القائمة بصيغة JSON، وهي الصيغة نفسها التي استخدمناها في الدرسين السابقين.
الخطوة الأولى: احفظ القائمة في ملف
نبدأ بالحفظ فقط. نعدّل مكانين في الملف.
أولًا: نضيف اسم الملف في الأعلى، تحت اسم النموذج:
MODEL = "qwen2.5:1.5b"FILE = "memory.json"
وضعنا الاسم في أول الملف لنغيّره في مكان واحد، كما فعلنا مع اسم النموذج.
ثانيًا: نضيف سطرين في آخر الحلقة، بعد أن نضيف رد النموذج إلى القائمة:
messages.append({"role": "assistant", "content": reply}) with open(FILE, "w") as f: json.dump(messages, f)
| السطر | ماذا يفعل؟ |
|---|---|
open(FILE, "w") |
يفتح الملف للكتابة. الحرف "w" اختصار write، أي «اكتب». وإن لم يكن الملف موجودًا أنشأه، وإن كان موجودًا مسح ما فيه وكتب من جديد. |
with ... as f: |
يعطي الملف المفتوح الاسم f داخل الأسطر المزاحة تحته، ويغلقه بنفسه حين ينتهي. |
json.dump(messages, f) |
يكتب القائمة messages كلها في الملف f بصيغة JSON. |
ولأننا نكتب بعد كل رد، فلو توقف الملف فجأة بقي في الملف كل ما قيل حتى آخر رد.
الخطوة الثانية: اقرأ الملف عند البدء
الحفظ وحده لا يكفي، فلا بد أن يقرأ الوكيل الملف حين يبدأ. نعدّل مكانين.
أولًا: نضيف import os مع الاستيرادات. وos أداة جاهزة في Python تتعامل مع الملفات والمجلدات:
import jsonimport osimport urllib.request
ثانيًا: نستبدل القائمة المكتوبة في الملف بهذه الأسطر:
messages = [ {"role": "system", "content": "You are a note keeper, Answer briefly"},]if os.path.exists(FILE): with open(FILE) as f: messages = json.load(f)else: messages = [ {"role": "system", "content": "You are a note keeper, Answer briefly"}, ]
| السطر | ماذا يفعل؟ |
|---|---|
os.path.exists(FILE) |
يسأل: هل الملف memory.json موجود؟ والجواب نعم أو لا. |
open(FILE) |
يفتح الملف للقراءة. وحين لا نكتب حرفًا بعد الاسم يفتحه Python للقراءة. |
json.load(f) |
يقرأ ما في الملف ويحوّله إلى قائمة، فتصبح messages هي المحادثة القديمة. |
else: |
وإن لم يكن الملف موجودًا، فنبدأ بقائمة جديدة فيها رسالة القواعد وحدها، كما كنا. |
ولا تنسَ أن سطر FILE = "memory.json" يجب أن يكون فوق هذه الأسطر، لأننا نستخدم FILE فيها.
الملف كاملًا
import json import os import urllib.request URL = "http://localhost:11434/v1/chat/completions" MODEL = "qwen2.5:1.5b" FILE = "memory.json" if os.path.exists(FILE): with open(FILE) as f: messages = json.load(f) else: messages = [ {"role": "system", "content": "You are a note keeper, Answer briefly"}, ] def ask_model(messages): body = json.dumps({"model": MODEL, "messages": messages}).encode() request = urllib.request.Request(URL, body, {"Content-Type": "application/json"}) with urllib.request.urlopen(request) as response: data = json.load(response) return data["choices"][0]["message"]["content"] while True: text = input("You: ") if text == "exit": break messages.append({"role": "user", "content": text}) reply = ask_model(messages) print("Agent:", reply) messages.append({"role": "assistant", "content": reply}) with open(FILE, "w") as f: json.dump(messages, f)
شغّله ثلاث مرات
الاختبار هذه المرة بثلاث خطوات:
- شغّل الملف واكتب
Remember, my exam is on Monday، وانتظر الرد، ثم اكتبexit. - شغّله مرة ثانية واكتب
when is my exam?، وانتظر الرد، ثم اكتبexit. - اعرض الملف بالأمر
cat memory.json.
الأمر cat يطبع محتوى ملف نصي في الطرفية.
ما ظهر لي حين جرّبتُ
$ python3 agents.py You: Remember, my exam is on Monday Agent: Your exam is on Monday. Ensure you prepare thoroughly and manage your time effectively. You: exit $ python3 agents.py You: when is my exam? Agent: Your exam is scheduled for Monday. You: exit
ترجمة ما جرى:
- التشغيل الأول، أنا: «Remember, my exam is on Monday»، أي «تذكّر، امتحاني يوم الاثنين».
- النموذج: «امتحانك يوم الاثنين. احرص على أن تستعد جيدًا وأن تنظّم وقتك بفاعلية.»
- التشغيل الثاني، أنا: «when is my exam?»، أي «متى امتحاني؟».
- النموذج: «موعد امتحانك محدد يوم الاثنين.»
انتبه إلى ما حدث: أغلقتُ الملف بين التشغيلين، وفي التشغيل الثاني لم أقل للنموذج شيئًا عن الامتحان. ومع ذلك عرف الموعد، لأن الملف قرأ المحادثة القديمة من memory.json قبل أن أكتب سؤالي.
ماذا يوجد داخل الملف؟
هذا ما أظهره الأمر cat memory.json:
ما ظهر لي حين جرّبتُ
$ cat memory.json
[{"role": "system", "content": "You are a note keeper, Answer briefly"}, {"role": "user", "content": "Remember, my exam is on Monday"}, {"role": "assistant", "content": "Your exam is on Monday. Ensure you prepare thoroughly and manage your time effectively."}, {"role": "user", "content": "when is my exam?"}, {"role": "assistant", "content": "Your exam is scheduled for Monday."}]
كل شيء في سطر واحد طويل، وهذا شكل JSON حين يكتبه Python. وللقراءة الأسهل رتّبتُ المحتوى نفسه هنا في أسطر. وهذا الترتيب مني أنا، وليس مما طبعه الأمر:
[
{
"role": "system",
"content": "You are a note keeper, Answer briefly"
},
{
"role": "user",
"content": "Remember, my exam is on Monday"
},
{
"role": "assistant",
"content": "Your exam is on Monday. Ensure you prepare thoroughly and manage your time effectively."
},
{
"role": "user",
"content": "when is my exam?"
},
{
"role": "assistant",
"content": "Your exam is scheduled for Monday."
}
]
وهذه هي القائمة messages نفسها التي رأيناها في الدرس السابق: رسالة القواعد، ثم أنا، ثم النموذج، ثم أنا، ثم النموذج. وكل ما فعلناه أننا كتبناها في ملف، وقرأناها منه.
وتسمى المحادثة المحفوظة بهذا الشكل جلسة (session): قائمة الرسائل كلها، محفوظة في مكان ما، لتُحمَّل مرة أخرى.
ويمكنك فتح الملف بأي محرر نصوص، وقراءته، بل وتعديله بيدك. وهذا يعني أن الذاكرة ليست سرًّا: هي نص عادي تستطيع أن تقرأه.
كيف يقرأ النموذج هذه القائمة؟
ما معنى أن «الذاكرة هي القائمة»؟ وكيف يعرف النموذج أن الامتحان يوم الاثنين؟
الجواب أن النموذج لا يبحث عن شيء مخزّن. الذاكرة هي النص نفسه، والنموذج يقرؤه كله في كل مرة.
والذي يحدث في كل مرة هو هذا:
- برنامجنا يرسل القائمة كلها: القواعد، ثم رسائلي، ثم ردود النموذج السابقة، ثم سؤالي الجديد.
- Ollama يحوّل القائمة إلى صفحة واحدة متصلة، كأنها نص مكتوب فيه سطر لكل رسالة.
- يقرأ النموذج الصفحة كلها من أولها، ثم يكتب ما يأتي بعد آخر سطر، كلمة بعد كلمة.
وفي حالتنا تبدو الصفحة تقريبًا هكذا. وهذا شكل مبسط للتوضيح، وليس ما طبعه Ollama:
system: You are a note keeper, Answer briefly user: Remember, my exam is on Monday assistant: Your exam is on Monday. Ensure you prepare ... user: when is my exam? assistant:
وجملة «my exam is on Monday» موجودة في الصفحة، قبل السؤال بأسطر قليلة. والنموذج دُرّب على نصوص كثيرة جدًّا، فتعلّم أن الجواب إذا ظهر في النص قبل السؤال، فالكلام التالي يستعمله عادة. ولذلك كتب: «Your exam is scheduled for Monday».
ثلاثة أشياء تظهر من هذا
- القواعد جزء من الصفحة. رسالة
systemسطر في أول الصفحة، والنموذج يقرؤه كما يقرأ غيره. - كلام النموذج نفسه جزء من الصفحة. حين نحفظ ردّه بالدور
assistant، يقرؤه في المرة التالية كما يقرأ أي نص. وهو لا «يتذكر» أنه كتبه، فهو يرى سطرًا مكتوبًا فقط. - ما ليس في الصفحة لا يعرفه. لو حذفنا رسالتي الأولى من القائمة، ما استطاع النموذج الإجابة، لأن الموعد لن يكون مكتوبًا أمامه.
هل يملك النموذج الكبير ذاكرة أكبر؟
لا. الذاكرة هي الصفحة، وهي القائمة نفسها التي نرسلها، وتصل إلى النموذج الصغير والكبير بلا فرق. والذي يختلف أمران:
- جودة القراءة: النموذج الأكبر أفضل في استخدام ما في الصفحة. ولهذا أجاب
qwen2.5:1.5bعن السؤال، ولم يفهمهqwen2.5:0.5bمع الصفحة نفسها. - حجم الصفحة: لكل نموذج حدّ لما يستطيع قراءته مرة واحدة، ويسمى نافذة السياق. فإن طالت المحادثة أكثر من الحدّ، لا يتّسع أولها. وهذا الحدّ يتغير بحسب النموذج وإعداداته، ولم أتحقق من حدّ جهازك.
فالذاكرة صفحة، والنموذج قارئ. القارئ الأفضل يفهم الصفحة نفسها أفضل، ولكنه لا يقرأ صفحة غير موجودة.
حدود هذه الذاكرة
هذه ذاكرة بسيطة، ولها حدود يجب أن تعرفها:
- الملف يكبر مع كل رد. والنموذج يقرأ القائمة كلها في كل مرة، فكلما طالت المحادثة أصبح الرد أبطأ.
- كل ما قيل محفوظ. ليست الذاكرة «ملاحظات» منتقاة، بل المحادثة كلها بحروفها.
- الملف يخص هذا المجلد. فإن شغّلتَ
agents.pyمن مجلد آخر بدأ بذاكرة جديدة، لأنmemory.jsonسيُنشأ هناك. - النموذج هو الذي يفهم القائمة. فإن كان النموذج صغيرًا أخطأ في فهمها، كما رأينا في الدرس السابق مع
qwen2.5:0.5b.
هل هذه «جلسة»؟
نعم، هذه هي الفكرة نفسها في أبسط صورها:
- النموذج لا يحتفظ بشيء. في كل مرة يرسل البرنامج إليه قائمة المحادثة كلها.
- الجلسة (session) في أدوات مثل Claude Code وتطبيقات المحادثة هي هذه القائمة محفوظة في مكان ما، لتُحمَّل مرة أخرى.
- في تطبيقات المحادثة مثل Claude.ai وChatGPT تُحفظ القائمة عند الشركة، وتظهر كل محادثة في قائمة جانبية.
- تضيف الأدوات الكبيرة: عدة جلسات لكل منها اسم، واختيار الجلسة التي تفتحها، وغالبًا تلخيص المحادثة الطويلة حتى لا تكبر بلا حد.
- وبعض التطبيقات لديها «ذاكرة» من نوع آخر: معلومات قصيرة تُحفظ عبر محادثات مختلفة. وهذا غير الجلسة، وملفنا لا يفعله.
وهذا وصف عام للفكرة، وتفاصيل كل أداة قد تختلف.
وإن أردتَ أن يبدأ الوكيل من جديد ويمسح كل ما يتذكره، فاحذف الملف:
rm memory.json
وفي التشغيل التالي لا يجد الوكيل الملف، فيبدأ بقائمة جديدة.
وفي الدروس القادمة نعطي الوكيل أدوات ليفعل أشياء حقيقية، بدلًا من أن يكتفي بالكلام.
ماذا تلاحظ؟
- افتح
memory.jsonبمحرر نصوص بعد كل رد. هل يكبر؟ - شغّل الملف، وأخبره بشيء جديد، ثم اسأله عنه بعد أن تغلقه وتفتحه.
- احذف الملف بالأمر
rm memory.jsonوشغّل الوكيل. هل ما زال يعرف موعد الامتحان؟
اختبر نفسك
ماذا يحدث لو حذفنا سطري with open(FILE, "w") as f: وjson.dump(messages, f) من آخر الحلقة، وأبقينا الجزء الذي يقرأ الملف؟
اعرض الجواب
لن يتذكر الوكيل شيئًا. لأن أحدًا لا يكتب في memory.json، فلا يوجد الملف أصلًا، وفي كل تشغيل يبدأ الوكيل بقائمة جديدة. فالقراءة بلا كتابة لا تنفع.
ما الذي تعلّمناه؟
- القائمة
messagesتُمسح حين ينتهي الملف، فينسى الوكيل. والحل أن نكتبها في ملف. json.dumpيكتب القائمة في الملف بعد كل رد، وjson.loadيقرؤها عند البدء.os.path.existsيسأل هل الملف موجود، فإن لم يوجد بدأنا بقائمة جديدة.- الملف
memory.jsonنص عادي يمكنك قراءته، وهو يكبر مع كل رد. - المحادثة المحفوظة في ملف تسمى جلسة (session).
- لمسح الذاكرة نحذف الملف.