اكتب حلقة الوكيل
في القسم السابق، سلّم النموذج ورقة مكتوب عليها «يرجى حساب 3829 زائد 9471». في هذا القسم سننفّذ الورقة، ونعيد النتيجة إليه، ونجعل هذا الأمر يتكرر تلقائيًا حتى تكتمل المهمة. هذا هو الوكيل.
الحلقة لا تتكون إلا من أربع خطوات
- 1?
- 2?
- 3?
- 4?
اضغط عليها واحدة تلو الأخرى حسب الترتيب.
الكود
حمّل ملف step2_loop.py. الجوهر هو الدالة run:
def run(question, max_steps=8):
messages = [{"role": "user", "content": question}]
for step in range(1, max_steps + 1):
resp = client.chat.completions.create(model=MODEL, messages=messages, tools=tools)
msg = resp.choices[0].message
messages.append(msg.model_dump(exclude_none=True)) # 模型这一轮说的话也要放回对话
if not msg.tool_calls: # 不再调工具:这就是最终回答
return msg.content
for call in msg.tool_calls:
try:
args = json.loads(call.function.arguments)
result = FUNCTIONS[call.function.name](**args)
except Exception as e: # 出错也要告诉模型,让它自己改
result = f"出错了:{e}"
print(f"[第 {step} 步] {call.function.name}({args}) = {result}")
messages.append({"role": "tool", "tool_call_id": call.id, "content": str(result)})
return "超过最大步数,停下。"الأداتان هما دالتان عاديتان في Python هما add و multiply، ويتم العثور عليهما بالاسم عبر قاموس FUNCTIONS.
اسأله سؤالًا من خطوتين:
python step2_loop.pyستجد ما يلي (على qwen3:8b محليًا، خلال 4 ثوانٍ):
[الخطوة 1] multiply({'a': 24, 'b': 17}) = 408
[الخطوة 1] add({'a': 408, 'b': 9}) = 417
المجموع 417 تفاحة. خطوات الحساب كالتالي:
...
الإجابة النهائية: 417أربعة تفاصيل يسهل إغفالها
**1. دور النموذج نفسه يجب أن يعاد إلى messages أيضًا. ** السطر 6 حيث messages.append(msg...) لا يمكن حذفه. في الدورة التالية، يحتاج النموذج إلى رؤية «ما الذي طلبته في المرة السابقة» ليطابق رسائل الأدوات اللاحقة معه.
**2. tool_call_id يجب أن يتطابق. ** كل رسالة أداة يجب أن تحمل id الخاص بالاستدعاء المقابل، ليعرف النموذج أي نتيجة تنتمي إلى أي طلب.
**3. لا بد من حد أقصى للخطوات. ** قد يقع النموذج في حلقة مفرغة من استدعاء الأدوات مرارًا. max_steps هو المصهر، عند بلوغه نتوقف.
**4. عند حدوث خطأ لا تدع البرنامج ينهار، بل مرّر الخطأ إلى النموذج. ** معاملات خاطئة، ملف غير موجود... كلها تتحول إلى عبارة «حدث خطأ: ...» تُعاد إليه، وغالبًا ما يستطيع النموذج تصحيح نفسه. في التشغيل الحقيقي الظاهر في الصفحة الرئيسية للدورة، أخطأ النموذج في كتابة المسار، وبعد استلام رسالة الخطأ سرد المجلد أولًا ثم أعاد القراءة بالمسار الصحيح، وذلك بفضل هذا السطر.
ظاهرة مثيرة للاهتمام: استدعاء أداتين في خطوة واحدة
لاحظ أن السطرين أعلاه كلاهما «الخطوة 1»: نموذج qwen3:8b طلب multiply و add معًا في نفس الدورة، كما أن المعامل 408 الخاص بـ add حسبه بنفسه مسبقًا دون انتظار عودة نتيجة الضرب.
هذا ما يسمى استدعاء الأدوات بالتوازي: إرجاع عدة tool_calls في دورة واحدة. حلقتنا تنفذها واحدًا تلو الآخر باستخدام for call in msg.tool_calls، لذا فهي تدعمها بشكل طبيعي.
على نفس السؤال، أعطى نموذج GLM السحابي مباشرة في إجابته 24 × 17 = 408 و 408 + 9 = 417. تختلف درجة حماس النماذج المختلفة في استخدام الأدوات. لجعله يستخدم الأدوات بالتأكيد، يمكنك طلب ذلك صراحة في التوجيه، أو ضبط tool_choice في الواجهة (ملاحظة: واجهة Ollama المتوافقة مع OpenAI لا تدعم هذا المعامل، والنماذج المحلية تعتمد على التوجيه فقط).
اختبر معرفتكماذا قد يحدث لو أزلنا max_steps؟
تحقق من نفسك
- شغّلت
step2_loop.pyبنجاح، ورأيت استدعاءات الأدوات والإجابة النهائية - أستطيع ذكر خطوات الحلقة الأربع
- أعرف لماذا نعيد رسائل النموذج نفسه، ونطابق tool_call_id، ونضع حدًا أقصى للخطوات، ونمرر الأخطاء إليه
القسم التالي: إعطاؤه أدوات حقيقية.