الدرس 7 من 12

تحسين على كود الوكيل

تعدّل ملف الوكيل ليأخذ رسالتك أثناء التشغيل، ويكرّر المحادثة في حلقة، ويحفظ رد الوكيل في القائمة، ثم تعرف لماذا يهم حجم النموذج.

8 دقائق للقراءة

في درس أنشئ أول وكيل ذكاء اصطناعي كتبنا ملفًا يرسل رسالة واحدة مكتوبة داخل الملف، ويعرض ردًّا واحدًا. ولتغيير الرسالة كان علينا أن نفتح الملف ونعدّله.

في هذا الدرس نجعل الملف ديناميكيًّا: تكتب أنت الرسالة أثناء التشغيل، ويبقى الوكيل يجيبك مرة بعد مرة، ويقرأ ما قيل قبل قليل.

ما الذي نغيّره؟

نبدأ من ملف الدرس السابق، ونغيّر فيه ثلاثة أشياء، واحدًا بعد الآخر:

  1. الرسالة تأتي منك عبر input()، لا من داخل الملف.
  2. المحادثة تتكرر داخل حلقة، حتى تكتب exit.
  3. رد النموذج يُضاف إلى القائمة، فيرى النموذج كل ما قيل.
حلقة المحادثةأنت تكتب رسالتكinput()الملف يضيفها إلى القائمةويسأل النموذجالنموذج يردوالملف يعرض الرديتكررالحلقة تتكرر حتى تكتب exit
حلقة المحادثة: تكتب رسالتك، فيضيفها الملف إلى القائمة ويسأل النموذج، ثم يعرض الرد ويعود ليسألك من جديد حتى تكتب exit.

نعدّل الملف نفسه، في المجلد نفسه.

الخطوة الأولى: اكتب أنت الرسالة

في ملفنا القديم كانت القائمة تحتوي على رسالتين: القواعد، ثم رسالتك المكتوبة. نترك القواعد في القائمة، ونحذف رسالتك المكتوبة:

messages = [    {"role": "system", "content": "You are a note keeper, Answer briefly"},    {"role": "user", "content": "Remember: my meeting is on sunday at 10"},]text = input("You: ")messages.append({"role": "user", "content": text})
السطر ماذا يفعل؟
input("You: ") يوقف الملف ويكتب You: في الطرفية، وينتظر حتى تكتب سطرًا وتضغط Enter. ثم يضع ما كتبتَه في المتغير text.
messages.append(...) append تعني «أضف إلى آخر القائمة». فنضيف رسالتك إلى القائمة بالدور user.

لاحظ أن القائمة لم تتغير، فهي القائمة نفسها، ولكننا الآن نضيف إليها أثناء التشغيل، ولا نكتب كل شيء مسبقًا.

الخطوة الثانية: كرّر المحادثة

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

text = input("You: ")messages.append({"role": "user", "content": text})reply = ask_model(messages)print(reply)while True:    text = input("You: ")    if text == "exit":        break    messages.append({"role": "user", "content": text})    reply = ask_model(messages)    print("Agent:", reply)
السطر ماذا يفعل؟
while True: «ما دام الشرط صحيحًا». وTrue صحيح دائمًا، فتتكرر الأسطر المزاحة تحته إلى ما لا نهاية.
if text == "exit": إن كتبتَ exit فنفّذ السطر التالي. ولاحظ أن المقارنة تُكتب بعلامتي يساوي ==، وعلامة واحدة = تعني وضع قيمة في متغير.
break يخرج من الحلقة، فينتهي تنفيذ الملف.
reply = ask_model(messages) الدالة نفسها التي كتبناها في الدرس السابق. نرسل بها القائمة ونأخذ الرد.

انتبه إلى الإزاحة. في Python تدل المسافات في بداية السطر على أن السطر داخل الحلقة. ولذلك تجد break أبعد إلى اليمين من if، لأنه داخلها.

الخطوة الثالثة: احفظ رد النموذج في القائمة

الآن يجيبك النموذج، ولكن القائمة لا تحتوي إلا على رسائلك أنت. نضيف سطرًا واحدًا في آخر الحلقة، وهو المظلَّل بالأخضر:

    reply = ask_model(messages)    print("Agent:", reply)messages.append({"role": "assistant", "content": reply})

هذا السطر يخزّن ما قاله النموذج بالدور assistant. وبهذا تصبح القائمة محادثة حقيقية بالترتيب: قواعد، أنت، النموذج، أنت، النموذج.

قائمة الرسائل تكبرsystemالقواعدuserRemember: my exam is on Mondayassistantرد النموذج الأولuserwhen is my exam?assistantرد النموذج الثانيتكبرالنموذج يقرأ القائمة كلها في كل مرة
قائمة الرسائل تكبر مع كل دور: رسالتك ثم رد النموذج ثم رسالتك ثم رده، والنموذج يقرؤها كلها في كل مرة.

وهذا ما يُسمّى هنا الذاكرة. والنموذج نفسه لا يحتفظ بشيء بين طلب وطلب، فالقائمة التي نرسلها كل مرة هي كل ما يعرفه عن المحادثة.

انتبه إلى الأخطاء الصغيرة

وقعتُ في أخطاء صغيرة أثناء التجربة، وكل منها يمنع الملف من العمل أو يعطّله، فانتبه لها:

  • === ليست في Python. نكتب ==.
  • لا نضع ; في آخر السطر.
  • الدور يجب أن يكون "assistant" بالحروف كلها. وإن كتبتَه بحرف ناقص، فلن يعرفه النموذج.

الملف كاملًا

import json
import urllib.request

URL = "http://localhost:11434/v1/chat/completions"
MODEL = "qwen2.5:0.5b"

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})

النموذج هنا هو qwen2.5:0.5b الذي قمنا بتحميله في الدرس السابق.

شغّله واقرأ النتيجة

python3 agent.py

اكتب الرسالة الأولى، وانتظر رد النموذج، ثم اكتب الثانية، وانتظر، ثم اكتب exit:

  1. Remember: my exam is on Monday
  2. when is my exam?
  3. exit

وأول رد قد يتأخر، لأن Ollama يحمّل النموذج في الذاكرة. والردود التالية أسرع.

ما قاله qwen2.5:0.5b حين جرّبتُ

$ python3 agents.py
You: Remember : my exam is on Monday
Agent:  I'm sorry, but I can't help with that. If you have any more questions, please feel free to ask!
You: when is my exam?
Agent:  I'm sorry, but as a text-based AI, I don't have the ability to predict my own exam dates. If you're referring to upcoming or past exams, please let me know, and I can provide more information!
You: exit

ترجمة ما جرى:

  • أنا: «Remember : my exam is on Monday»، أي «تذكّر: امتحاني يوم الاثنين».
  • النموذج: «أعتذر، لكنني لا أستطيع المساعدة في هذا. وإن كانت لديك أسئلة أخرى فلا تتردد في طرحها.»
  • أنا: «when is my exam?»، أي «متى امتحاني؟».
  • النموذج: «أعتذر، لكنني بوصفي ذكاءً اصطناعيًّا نصّيًّا لا أملك القدرة على التنبؤ بمواعيد امتحاناتي. وإن كنتَ تقصد امتحانات قادمة أو سابقة فأخبرني، وسأقدّم لك مزيدًا من المعلومات.»

النتيجة ليست جيدة. طلبتُ منه أن يتذكر موعد الامتحان، فقال إنه لا يستطيع مساعدتي. ثم سألتُه عن الموعد فلم يعرفه.

فغيّرتُ النموذج إلى نموذج آخر.

غيّرتُ النموذج

النموذج الأكبر قليلًا في العائلة نفسها هو qwen2.5:1.5b. حجمه نحو 1 GB. حمّله أولًا، كما فعلنا في درس تثبيت Ollama:

ollama pull qwen2.5:1.5b

ثم غيّر سطرًا واحدًا في الملف، وهو اسم النموذج:

MODEL = "qwen2.5:0.5b"MODEL = "qwen2.5:1.5b"

ولم نغيّر أي شيء آخر في الشيفرة. شغّل الملف مرة أخرى بالرسالتين نفسيهما:

ما قاله qwen2.5:1.5b حين جرّبتُ

$ python3 agents.py
You: Remember: my exam is on Monday
Agent:  Good luck on your exam! Stay focused and well-prepared. If you need any tips or further assistance, feel free to ask.
You: when is my exam?
Agent:  Your exam is on Monday.
You: exit

ترجمة ما جرى:

  • أنا: «Remember: my exam is on Monday»، أي «تذكّر: امتحاني يوم الاثنين».
  • النموذج: «حظًّا موفقًا في امتحانك! ابقَ مركّزًا ومستعدًّا جيدًا. وإن احتجتَ إلى نصائح أو مساعدة إضافية فلا تتردد في السؤال.»
  • أنا: «when is my exam?»، أي «متى امتحاني؟».
  • النموذج: «امتحانك يوم الاثنين.»

هذه المرة أجاب النموذج عن السؤال الثاني: «Your exam is on Monday»، لأنه قرأ في القائمة أنني قلتُ له إن الامتحان يوم الاثنين.

ولاحظ أنه في الرد الأول لم يلتزم بقاعدة «Answer briefly»، أي أجب باختصار، وكتب عدة جمل. وهذا يحدث مع النماذج الصغيرة: تفهم التعليمات في الغالب، ولا تلتزم بها دائمًا.

ما الذي نتعلمه من هذا؟

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

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

وفي المقابل، النموذج الأكبر أثقل على جهازك وأبطأ. ونحن نختار الأصغر الذي ينجح في مهمتنا.

ما الذي ما زال ناقصًا؟

شغّل الملف مرة أخرى بعد أن أغلقتَه بـ exit، واسأل: when is my exam?

ما ظهر لي حين جرّبتُ

$ python3 agents.py
You: when is my exam?
Agent:  I'm sorry, I can't provide specific dates for exams as they can vary depending on academic calendars, course instructions, and individual schedules. It's best to check your course syllabus for exam dates and contact your academic advisor for confirmation.
You:

ترجمة ما جرى:

  • أنا: «when is my exam?»، أي «متى امتحاني؟».
  • النموذج: «أعتذر، لا أستطيع تقديم مواعيد محددة للامتحانات، لأنها تختلف بحسب التقويم الأكاديمي وتعليمات المقرر والجداول الفردية. الأفضل أن تراجع خطة المقرر لمعرفة مواعيد الامتحانات، وأن تتواصل مع مرشدك الأكاديمي للتأكيد.»

الوكيل نسي كل شيء. السبب أن القائمة messages موجودة في ذاكرة الملف وهو يعمل فقط، وتختفي حين ينتهي. وفي الدرس القادم، ذاكرة الوكيل، نحفظ القائمة في ملف ليتذكر الوكيل حتى بعد إغلاقه.

ماذا تلاحظ؟

  • هل أجاب النموذج عن السؤال الثاني؟
  • جرّب رسالة أخرى مكان my exam is on Monday، ثم اسأل عنها.
  • جرّب أن تحذف سطر messages.append({"role": "assistant", ...}) وانظر هل تتغير الإجابة.

اختبر نفسك

ماذا يحدث لو حذفنا سطر break؟

اعرض الجواب

لن يتوقف الملف عند كتابة exit. سيضيف exit إلى القائمة كأنه رسالة عادية، ويرسلها إلى النموذج، ويستمر في الحلقة. والخروج في هذه الحالة يكون بالضغط على Ctrl+C.

ما الذي تعلّمناه؟

  • input() يجعل الرسالة تأتي منك أثناء التشغيل، لا من داخل الملف.
  • while True: تكرّر الأسطر المزاحة تحتها، وbreak تُنهي الحلقة.
  • نضيف رسالتك ورد النموذج إلى القائمة، بالدورين user وassistant، فيقرأ النموذج المحادثة كلها كل مرة.
  • حجم النموذج مهم: qwen2.5:0.5b أخطأ، وqwen2.5:1.5b أجاب صحيحًا، والشيفرة لم تتغير.
  • ما زال الوكيل ينسى حين ينتهي الملف. نحل هذا في درس ذاكرة الوكيل.