في درس أول أداة للوكيل طلب النموذج الأداة، ونفّذها برنامجنا، فحُفظت الملاحظة في ملف حقيقي. ولكن الوكيل لم يرد علينا بكلام: طبع سطر Tool: وانتظر.
في هذا الدرس نكمل الدورة: نرسل نتيجة الأداة إلى النموذج، فيقرؤها ويجيبك بجملة عادية.
في هذا الدرس
أين توقفنا؟
في آخر الحلقة، بعد أن شغّل برنامجنا الأداة، خزن النتيجة في قائمة الرسائل بدور tool.
والمشكلة أن النموذج لم يقرأ هذه النتيجة. هي موجودة في القائمة، لكن لم نسأله أي شيء بعد وضع الرسالة في القامة.
تذكّر المدير ومساعدته من الدرس السابق. المدير، وهو النموذج، طلب من المساعدة: «سجّلي هذه الملاحظة». والمساعدة، وهي برنامجنا، وضعت الورقة في الخزانة. ولكنها لم تعد إلى المدير لتقول له «تم». فبقي ينتظر، ولا يعرف أن الملاحظة حُفظت.
ثلاثة أسطر جديدة
الحل أن نعود إلى النموذج بعد تشغيل الأداة، ونسأله مرة ثانية. وهذه المرة تكون آخر رسالة في القائمة هي نتيجة الأداة، فيقرؤها ويجيب.
نضيف ثلاثة أسطر في آخر الحلقة. كل سطر باللون الأخضر وعليه + هو جديد:
if message.get("tool_calls"): for call in message["tool_calls"]: args = json.loads(call["function"]["arguments"]) result = save_note(**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"])
| السطر | ماذا يفعل؟ |
|---|---|
message = ask_model(messages) |
نسأل النموذج مرة ثانية. وآخر رسالة في القائمة الآن هي نتيجة الأداة Saved: ...، فيقرؤها. |
messages.append(message) |
نضيف جوابه إلى القائمة، كما نفعل دائمًا، ليتذكره في المرات القادمة. |
print("Agent: ", message["content"]) |
نعرض جوابه. وهذه المرة فيه كلام، وليس طلب أداة. |
ولاحظ مكان الأسطر الثلاثة: هي بعد حلقة for وليست داخلها. فإن طلب النموذج أكثر من أداة، شغّلنا كلها أولًا، ثم نسأله مرة واحدة بعد أن أصبحت نتائجها كلها في القائمة. وهي تحت if مباشرة، ولذلك تُنفَّذ فقط حين يطلب النموذج أداة.
وإن كان في مجلدك ملف memory.json قديم، فاحذفه قبل أن تبدأ:
rm -f memory.json
شغّله
python3 agent.py
اكتب Remember, my exam is on Monday، وانتظر، ثم اكتب exit:
ما ظهر لي حين جرّبتُ
$ python3 agent.py You: Remember, my exam is on Monday Tool: Saved: My exam is on Monday Agent: I have remembered that your exam is on Monday. You: exit
ترجمة ما جرى:
- أنا: «Remember, my exam is on Monday»، أي «تذكّر، امتحاني يوم الاثنين».
- الأداة: «Saved: My exam is on Monday»، أي «تم الحفظ: امتحاني يوم الاثنين».
- النموذج: «I have remembered that your exam is on Monday.»، أي «تذكّرتُ أن امتحانك يوم الاثنين».
هذا هو الفرق: بعد سطر Tool: ظهر سطر Agent: فيه جملة من النموذج. لقد قرأ نتيجة الأداة، وعرف أن الملاحظة حُفظت، وأخبرك بذلك بكلامه.
وبما أن الوكيل يحفظ المحادثة في memory.json، يمكنك أن تشغّله من جديد وتسأله عما قلتَه:
ما ظهر لي حين جرّبتُ
$ python3 agent.py You: When is my exam? Agent: Your exam is on Monday, as noted earlier. You: exit
ترجمة ما جرى:
- أنا: «When is my exam?»، أي «متى امتحاني؟».
- النموذج: «Your exam is on Monday, as noted earlier.»، أي «امتحانك يوم الاثنين، كما ذُكر سابقًا».
لم نطلب منه هنا حفظ شيء، ولذلك لم يطلب الأداة وأجاب مباشرة. فهو يطلب الأداة حين يحتاج هذه الأداة، ويجيب بكلام.
ماذا حدث في القائمة؟
افتح memory.json لترى المحادثة كلها كما يقرؤها النموذج:
[ {"role": "system", "content": "You are a note keeper. When the user tells you something to remember, use the save_note tool."}, {"role": "user", "content": "Remember, my exam is on Monday"}, {"role": "assistant", "content": "", "tool_calls": [...]}, {"role": "tool", "tool_call_id": "call_mo41u7vv", "content": "Saved: My exam is on Monday"}, {"role": "assistant", "content": "I have remembered that your exam is on Monday."}, {"role": "user", "content": "When is my exam?"}, {"role": "assistant", "content": "Your exam is on Monday, as noted earlier."}]
والسطر الأخضر هو الجديد: جواب النموذج بعد أن قرأ نتيجة الأداة. وقد كان ناقصًا في الدرس السابق، فكانت آخر رسالة في القائمة هي رسالة الأداة.
| الرسالة | من كتبها؟ | ما فيها؟ |
|---|---|---|
system |
نحن | القواعد: أنت حافظ ملاحظات. |
user |
أنت | «Remember, my exam is on Monday». |
assistant (طلب) |
النموذج | طلب الأداة save_note، وليس فيها كلام. |
tool |
برنامجنا | نتيجة الأداة: «Saved: …». |
assistant (جواب) |
النموذج | جملة عادية بعد أن قرأ النتيجة. |
ولاحظ أن النموذج يقرأ القائمة كلها في كل مرة نسأله، وفيها طلبه السابق ونتيجة الأداة. ولهذا يعرف ما جرى.
وفي درس يلاحظ النتيجة ويكرّر نرى الدورة كلها في صورة واحدة.
ماذا تلاحظ؟
- اكتب
helloفقط. هل ظهر سطرTool:؟ ماذا أجابك النموذج؟ - قل له ملاحظتين مختلفتين، ثم اسأله عن الأولى. هل أجابك جوابًا صحيحًا؟ وافتح
notes.txt: هل فيه سطران؟ - افتح
memory.jsonوابحث عن"role": "tool". ما الرسالة التي تأتي بعدها مباشرة؟
اختبر نفسك
لماذا نسأل النموذج مرتين حين يطلب أداة؟
اعرض الجواب
لأن لكل مرة عملًا مختلفًا. في المرة الأولى يقرر النموذج أن يستخدم الأداة، فيكتب طلبها. وبعد أن ينفّذ برنامجنا الأداة، نسأله مرة ثانية ليقرأ النتيجة ويجيبك بكلام. ولو لم نسأله الثانية، لبقي الوكيل صامتًا بعد تشغيل الأداة.
ما الذي تعلّمناه؟
- النموذج هو العقل المفكر، هو يقرر الخطوة التالية ويختار الأداة التي يحتاجها.
- النموذج يطلب أداة إذا احتاجها، والبرنامج (
agent.py) هو من ينفذ. - نتيجة الأداة تعود إلى النموذج، فيقرؤها ويجيب، ثم نضيف جوابه إلى القائمة فيتذكره.