في درس النموذج يقرر أي أداة يستخدم رأينا أن النموذج يفكر ويختار الأداة، وأن برنامجنا ينفّذ.
وبقيت الخطوة الثالثة: ماذا يحدث بعد التنفيذ؟ في هذا الدرس نرى كيف يلاحظ النموذج النتيجة، وكيف تجعل هذه الملاحظة الحلقة تستمر.
في هذا الدرس
ماذا يعني «يلاحظ»؟
الوكيل يعمل في ثلاث خطوات:
- يفكر: النموذج يقرر ماذا يفعل.
- ينفّذ: برنامجنا يشغّل الأداة.
- يلاحظ: النتيجة تعود إلى النموذج، فيقرؤها.
النموذج يقرأ ما حدث ويقرر الخطوة التالية. هل نجح تنفيذ الأداة؟ لم ينجح التنفيذ؟ يقرر النموذج الخطوة التالية بناء على نتيجة الخطوة السابقة. وهكذا تستمر الحلقة.
حين تفشل الأداة
وماذا لو كانت النتيجة خطأ؟ لنجعل الأداة تفشل عمدًا. في save_note.py، غيّر الدالة لترفض الملاحظة الطويلة:
def save_note(text): if len(text) > 20: return "Error: the note is too long, the maximum is 20 chars" with open("notes.txt", "a") as f: f.write(text + "\n") return "Saved: " + text
فإن زاد طول الملاحظة على 20 حرفًا، لا تُحفظ، وتعود إلى النموذج رسالة خطأ.
ولاحظ أن الخطأ نتيجة عادية نرسلها إلى النموذج، وليس انهيارًا في البرنامج. وهكذا يستطيع النموذج أن يقرأه.
ثم نضيف جملة إلى رسالة system في agent.py، تخبر النموذج بما يفعل عند الخطأ:
{"role": "system", "content": "You are a note keeper. When the user tells you something to remember, use the save_note tool. When the user asks about their notes, use the read_notes tool. If a tool returns an error, fix the problem and call the tool again."},
واحذف الملف memory.json القديم، لأن الرسالة القديمة محفوظة فيه:
rm -f memory.json notes.txt
النموذج يقرأ الخطأ ويحاول من جديد
شغّل الوكيل بالكود الذي لدينا الآن، واكتب ملاحظة طويلة:
python3 agent.py
ما ظهر لي حين جرّبتُ
$ python3 agent.py You: Remember: my exam is on Monday at ten in the morning Tool: Error: the note is tool long, the maximum is 20 chars Agent:
ترجمة ما جرى:
- أنا: «Remember: my exam is on Monday at ten in the morning»، أي «تذكّر: امتحاني يوم الاثنين الساعة العاشرة صباحًا».
- الأداة: «Error: the note is too long…»، أي «خطأ: الملاحظة طويلة، والحد الأقصى 20 حرفًا».
- الوكيل: سطر فارغ.
لماذا سطر فارغ؟ افتح memory.json وانظر إلى آخر رسالة فيه:
| الرسالة | ماذا فيها؟ |
|---|---|
assistant (طلب) |
save_note بالملاحظة الطويلة. |
tool |
خطأ: الملاحظة طويلة. |
assistant (طلب جديد) |
save_note بملاحظة أقصر: exam on Monday at 10 AM. |
النموذج لاحظ الخطأ، وفهمه، وقرر أن يحاول من جديد بملاحظة أقصر. وهذا هو التفكير الصحيح.
لكن برنامجنا لم ينفّذ طلبه الجديد. فهو يسأل النموذج مرة واحدة فقط بعد تشغيل الأداة، ثم يطبع جوابه. وجوابه هنا طلب أداة، وليس كلامًا، ولذلك ظهر سطر فارغ.
من if إلى while
نحتاج إلى أن يعيد البرنامج الفعل نفسه ما دام النموذج يطلب أداة: ينفّذ، ثم يسأله، فإن طلب أداة أخرى نفّذ ثم سأله، وهكذا. وهذا ما تفعله الحلقة while.
في agent.py، حوّل if إلى while، وانقل سطر الطباعة إلى خارجها، واحذف else:
message = ask_model(messages) messages.append(message) if message.get("tool_calls"): while message.get("tool_calls"): for call in message["tool_calls"]: args = json.loads(call["function"]["arguments"]) functions = {"save_note": save_note, "read_notes": read_notes} result = functions[call["function"]["name"]](**args) print("Tool: ", result) messages.append({"role": "tool", "tool_call_id": call["id"], "content": result}) message = ask_model(messages) messages.append(message) print("Agent: ", message["content"]) else: print("Agent: ", message["content"]) print("Agent: ", message["content"])
والمعنى: ما دام آخر رد من النموذج يحتوي على طلب أداة، ننفّذ ونسأله من جديد. وحين يرد بكلام، تنتهي الحلقة، ونطبع جوابه.
والكود الآن أقصر من قبل.
شغّله
احذف الذاكرة والملاحظات، ثم شغّل الوكيل بالرسالة نفسها:
rm -f memory.json notes.txt python3 agent.py
ما ظهر لي حين جرّبتُ
$ python3 agent.py You: Remember: my exam is on Monday at ten in the morning Tool: Error: the note is tool long, the maximum is 20 chars Tool: Saved: exam on Monday at 10 Tool: exam on Monday at 10 Tool: exam on Monday at 10 Agent: Here are all your notes: 1. **exam on Monday at 10** If you need any more assistance, feel free to ask!
ترجمة ما جرى:
- أنا: «تذكّر: امتحاني يوم الاثنين الساعة العاشرة صباحًا».
- الأداة: «Error»، أي «خطأ: الملاحظة طويلة».
- الأداة: «Saved: exam on Monday at 10»، أي «تم الحفظ: امتحان يوم الاثنين الساعة 10». فقد قصّر النموذج الملاحظة بنفسه.
- الأداة مرتين: النموذج قرأ الملاحظات ليتأكد.
- النموذج: «ها هي كل ملاحظاتك: امتحان يوم الاثنين الساعة 10».
هذه المرة نجحت الحلقة:
- فشلت الأداة، فلاحظ النموذج الخطأ.
- قصّر الملاحظة وأعاد المحاولة، فنجحت.
- قرأ الملاحظات ليتأكد.
- أجاب بكلام، فانتهت الحلقة.
لم نكتب نحن أي سطر يقول: «إن فشلت الأداة فقصّر الملاحظة». النموذج هو الذي لاحظ وقرر. وبرنامجنا اكتفى بأن يتابع التنفيذ ما دام النموذج يطلب أداة.
ماذا تلاحظ؟
- اكتب ملاحظة قصيرة مثل
my exam is Monday. كم سطرTool:ظهر؟ - افتح
memory.jsonوابحث عنError. ما الرسالة التي تأتي بعدها مباشرة؟ - من الذي قرر أن يقصّر الملاحظة: النموذج أم برنامجنا؟
اختبر نفسك
لماذا ظهر سطر Agent: فارغًا قبل أن نستخدم while؟
اعرض الجواب
لأن النموذج طلب أداة بعد أن قرأ الخطأ، وبرنامجنا لم ينفّذ طلبه. كان الكود يسأل النموذج مرة واحدة بعد الأداة، ثم يطبع جوابه. وكان الجواب طلب أداة، وليس كلامًا، فظهر السطر فارغًا.
هذه هي ReAct
الحلقة (Loop) التي بنيناها اسمها ReAct:
- يفكر النموذج، ويختار الأداة.
- ينفّذ برنامجنا الأداة.
- يلاحظ النموذج النتيجة.
ثم يفكر من جديد، وينفّذ من جديد، ويلاحظ من جديد، وهكذا حتى يتحقق الهدف.
ما الذي تعلّمناه؟
- بعد التنفيذ، النتيجة تعود إلى النموذج فيقرؤها. وهذه هي مراقبة (ملاحظة) النموذج للنتيجة.
- إن كانت النتيجة خطأ، يستطيع النموذج أن يفهم هذا الخطأ ويحاول من جديد.
- الحلقة
whileتستمر ما دام النموذج يطلب أداة، وتتوقف حين يجيب بكلام. - وفي الوكلاء الحقيقية نضيف حدًّا أقصى لعدد الجولات، حتى لا تدور الحلقة بلا نهاية.