في درس النموذج يقرأ نتيجة الأداة أصبح لوكيلنا أداة واحدة، هي save_note. وكان القرار بسيطًا: يستخدمها أو لا يستخدمها.
في هذا الدرس نضيف أداة ثانية. عندها يتحتم على النموذج التفكير واختيار الأداة المناسبة.
في هذا الدرس
ما الذي تغيّر بوجود أداتين؟
مع أداة واحدة كان الاختيار بين أمرين: أن يحفظ أو لا يحفظ.
ومع أداتين يصبح الاختيار بين ثلاثة أمور:
- يحفظ ملاحظة.
- يقرأ الملاحظات.
- لا يستخدم أي أداة، ويجيب بكلام.
وهذا هو التفكير الذي يقوم به النموذج: يقرأ رسالتك، ثم يقرر ماذا يفعل.
أداة ثانية: قراءة الملاحظات
أنشئ ملفًا جديدًا في مجلد الوكيل، واسمه read_notes.py:
def read_notes(): with open("notes.txt") as f: return f.read() TOOL = { "type": "function", "function": { "name": "read_notes", "description": "Read all the saved notes", "parameters": { "type": "object", "properties": {} } } }
وهو يشبه save_note.py: دالة، ثم وصف لها يقرؤه النموذج.
| الجزء | ماذا يفعل؟ |
|---|---|
read_notes() |
تفتح notes.txt وتُرجع كل ما فيه. |
"name" |
اسم الأداة الذي سيكتبه النموذج حين يطلبها. |
"description" |
جملة يقرؤها النموذج ليعرف متى يستخدم الأداة. |
"properties": {} |
لا شيء هنا، لأن القراءة لا تحتاج إلى معلومات منه. |
ولاحظ أن save_note تحتاج إلى text لأنها تحفظ شيئًا، أما read_notes فلا تحتاج إلى شيء.
نخبر الوكيل بالأداتين
نغيّر agent.py في ثلاثة أماكن.
الأول: نستورد الأداة الجديدة في أعلى الملف:
from save_note import save_note, TOOLfrom read_notes import read_notes, TOOL as READ_TOOL
الثاني: نرسل الأداتين معًا إلى النموذج، داخل ask_model:
def ask_model(messages): body = json.dumps({"model": MODEL, "messages": messages, "tools": [TOOL, READ_TOOL]}).encode()
الثالث: حين يطلب النموذج أداة، نشغّل الدالة التي سمّاها. احذف سطر result = save_note(**args) واكتب مكانه سطرين:
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)
والقاموس functions يربط اسم الأداة بالدالة. فإن كتب النموذج read_notes، شغّلنا read_notes(). وإن كتب save_note، شغّلنا save_note().
نخبر النموذج متى يستخدم كل أداة
الرسالة الأولى في القائمة، أي رسالة system، تذكر أداة واحدة الآن. أضف إليها جملة عن الأداة الثانية:
{"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."},
ثم احذف الملف memory.json القديم، لأن رسالة system القديمة محفوظة فيه:
rm -f memory.json
شغّله
python3 agent.py
اكتب الرسائل بالترتيب، ثم اكتب exit:
ما ظهر لي حين جرّبتُ
$ python3 agent.py You: Remember, my exam is Monday Tool: Saved: my exam is Monday Agent: Your note has been saved. You'll have all the information you need leading up to your examMonday. You: What notes do I have? Tool: my exam is Monday Agent: Here are the notes you have: - my exam is Monday You have one note. You: Thank you Agent: You're welcome! If you need anything else, feel free to ask. You: exit
ترجمة ما جرى:
- أنا: «Remember, my exam is Monday»، أي «تذكّر، امتحاني يوم الاثنين».
- الأداة: «Saved: my exam is Monday»، أي «تم الحفظ: امتحاني يوم الاثنين».
- النموذج: «Your note has been saved…»، أي «حُفظت ملاحظتك».
- أنا: «What notes do I have?»، أي «ما الملاحظات التي لديّ؟».
- الأداة: السطر المحفوظ في
notes.txt: «my exam is Monday». - النموذج: «ها هي الملاحظات التي لديك: امتحاني يوم الاثنين. لديك ملاحظة واحدة».
- أنا: «Thank you»، أي «شكرًا». وأجاب النموذج بكلام فقط، من غير أداة.
في الرسالة الأولى اختار النموذج save_note. وفي الثانية اختار read_notes. وفي الثالثة لم يختر أي أداة، وأجاب بكلام. ولم نغيّر في الكود شيئًا بين الرسائل الثلاث. الذي تغيّر هو رسالتك.
من اختار الأداة؟
اختارها النموذج. لم نكتب في agent.py سطرًا يقول: «إن سأل عن الملاحظات فاقرأ». كتبنا فقط وصف كل أداة، ثم تركنا النموذج يقرر.
وهنا يظهر عمل كل طرف:
- النموذج: يقرأ الرسالة ووصف الأدوات، ثم يقرر أي أداة يطلب.
- برنامجنا: يقرأ اسم الأداة التي طلبها، ثم يشغّل الدالة.
ولهذا تُهمّ جملة description. هي الشيء الوحيد الذي يعرف به النموذج ما تفعله الأداة. فإن كان وصفها غامضًا، ربما اختار الأداة الخطأ.
ماذا تلاحظ؟
- اكتب
helloفقط. هل طلب النموذج أداة؟ - اكتب ملاحظة جديدة، ثم اسأل:
What notes do I have?. هل ظهرت الملاحظة الجديدة؟ - افتح
memory.jsonوابحث عن"name". أي أداة طلب النموذج في كل مرة؟
اختبر نفسك
من الذي يقرر متى يتم استخدام read_notes وليس save_note: النموذج أم برنامجنا؟
اعرض الجواب
النموذج. هو يقرأ رسالتك ووصف كل أداة، ثم يكتب اسم الأداة التي يريدها. أما برنامجنا فيقرأ هذا الاسم فقط، ويشغّل الدالة المناسبة.
ما الذي تعلّمناه؟
- النموذج هو العقل المفكر، هو يقرر الخطوة التالية ويختار الأداة التي يحتاجها.
- النموذج يطلب أداة إذا احتاجها، والبرنامج (
agent.py) هو من ينفذ. - وصف كل أداة هو ما يساعد النموذج على معرفة متى يستخدمها.