الدرس 12 من 12

يلاحظ النتيجة ويكرّر

نرى كيف يلاحظ النموذج نتيجة الأداة، حتى لو كانت خطأً، فيعيد المحاولة، وكيف تجعل حلقة الوكيل هذا ممكنًا.

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

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

وبقيت الخطوة الثالثة: ماذا يحدث بعد التنفيذ؟ في هذا الدرس نرى كيف يلاحظ النموذج النتيجة، وكيف تجعل هذه الملاحظة الحلقة تستمر.

ماذا يعني «يلاحظ»؟

الوكيل يعمل في ثلاث خطوات:

  1. يفكر: النموذج يقرر ماذا يفعل.
  2. ينفّذ: برنامجنا يشغّل الأداة.
  3. يلاحظ: النتيجة تعود إلى النموذج، فيقرؤها.

النموذج يقرأ ما حدث ويقرر الخطوة التالية. هل نجح تنفيذ الأداة؟ لم ينجح التنفيذ؟ يقرر النموذج الخطوة التالية بناء على نتيجة الخطوة السابقة. وهكذا تستمر الحلقة.

الحلقة: فكّر ← نفّذ ← لاحظفكّرThinkأي خطوة الآن؟نفّذActيستعمل أداةلاحظObserveماذا حدث؟ويكرر حتىيتحقق الهدفهذه الحلقة هي قلب أي وكيل
الحلقة: يفكر النموذج، ثم ينفّذ برنامجنا، ثم يلاحظ النموذج النتيجة، وتتكرر حتى يتحقق الهدف.

حين تفشل الأداة

وماذا لو كانت النتيجة خطأ؟ لنجعل الأداة تفشل عمدًا. في 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.

النموذج لاحظ الخطأ، وفهمه، وقرر أن يحاول من جديد بملاحظة أقصر. وهذا هو التفكير الصحيح.

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

أداة تفشل ثم تنجحالأداة تفشلError: the note is too longالنموذج يقرأ الخطأويقصّر الملاحظة ويحاول من جديدالأداة تنجحSaved: exam on Monday at 10الحلقة: تستمر ما دام النموذج يطلب أداة
الأداة تفشل بخطأ، فيقرأ النموذج الخطأ ويقصّر الملاحظة ويطلب الأداة من جديد، فتنجح.

من 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».

هذه المرة نجحت الحلقة:

  1. فشلت الأداة، فلاحظ النموذج الخطأ.
  2. قصّر الملاحظة وأعاد المحاولة، فنجحت.
  3. قرأ الملاحظات ليتأكد.
  4. أجاب بكلام، فانتهت الحلقة.

لم نكتب نحن أي سطر يقول: «إن فشلت الأداة فقصّر الملاحظة». النموذج هو الذي لاحظ وقرر. وبرنامجنا اكتفى بأن يتابع التنفيذ ما دام النموذج يطلب أداة.

ماذا تلاحظ؟

  • اكتب ملاحظة قصيرة مثل my exam is Monday. كم سطر Tool: ظهر؟
  • افتح memory.json وابحث عن Error. ما الرسالة التي تأتي بعدها مباشرة؟
  • من الذي قرر أن يقصّر الملاحظة: النموذج أم برنامجنا؟

اختبر نفسك

لماذا ظهر سطر Agent: فارغًا قبل أن نستخدم while؟

اعرض الجواب

لأن النموذج طلب أداة بعد أن قرأ الخطأ، وبرنامجنا لم ينفّذ طلبه. كان الكود يسأل النموذج مرة واحدة بعد الأداة، ثم يطبع جوابه. وكان الجواب طلب أداة، وليس كلامًا، فظهر السطر فارغًا.

هذه هي ReAct

الحلقة (Loop) التي بنيناها اسمها ReAct:

  1. يفكر النموذج، ويختار الأداة.
  2. ينفّذ برنامجنا الأداة.
  3. يلاحظ النموذج النتيجة.

ثم يفكر من جديد، وينفّذ من جديد، ويلاحظ من جديد، وهكذا حتى يتحقق الهدف.

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

  • بعد التنفيذ، النتيجة تعود إلى النموذج فيقرؤها. وهذه هي مراقبة (ملاحظة) النموذج للنتيجة.
  • إن كانت النتيجة خطأ، يستطيع النموذج أن يفهم هذا الخطأ ويحاول من جديد.
  • الحلقة while تستمر ما دام النموذج يطلب أداة، وتتوقف حين يجيب بكلام.
  • وفي الوكلاء الحقيقية نضيف حدًّا أقصى لعدد الجولات، حتى لا تدور الحلقة بلا نهاية.

لقد انهيت كل الدروس المتاحة حالياً.

عد لدروس المسار لتتعرف على الدروس القادمة

ما زلت اضيف دروس جديدة للمسار،اذا كنت مهتماً بالموضوع فضلاً اكتب بريدك الإلكتروني حتى أراسلك عندما تصبح الدروس الجديدة متاحة.

🔔 أبلغيني بكل جديد في هذا الموضوع

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

هذا الدرس جزء من مساروكلاء الذكاء الاصطناعي من الصفر ←