المنهج الدراسي الدرس 118 من 250 · استدعاء نموذج لغوي كبير حقيقي
استدعاء نموذج لغوي كبير حقيقي

استدعاءات الأدوات المتوازية و is_error

تناولت الدرس السابق استدعاء أداة واحدة. لكن النماذج الحديثة تطلب عدة استدعاءات في وقت واحد: استخدام الأدوات المتوازية مفعل افتراضيا، لذا يمكن أن تحتوي دورة مساعد واحدة على ثلاث أو أربع tool_use كتل ("احصل على الطقس و ابحث عن الطلب و تحقق من المخزون"). إذا كان الكود الخاص بك يشغل الأولى فقط، سينتظر النموذج نتائج لا تأتي وستتوقف الدورة.

كلمة "Parallel" هنا تصف طلب النموذج REQUEST وليس تنفيذك: طلب النموذج عدة أدوات في دور واحد. يمكنك ببساطة تشغيلها واحدة تلو الأخرى وإرسال جميع النتائج معاً، لا حاجة لاستخدام threads أو async.

العقد دقيق: قم بتشغيل every tool_use block، ثم أرسل one user message التي يكون content الخاص بها عبارة عن list من tool_result blocks، واحد لكل استدعاء، وكل واحد يعيد tool_use_id الخاص به.

{"content": [
  {"type": "tool_use", "id": "t1", "name": "get_weather", "input": {"city": "Paris"}},
  {"type": "tool_use", "id": "t2", "name": "add",         "input": {"a": 2, "b": 5}}],
 "stop_reason": "tool_use"}

الفكرة الجديدة الثانية هي عزل الفشل. إذا تسببت إحدى الأدوات في خطأ، فلا تسبب انهيار الدور بأكمله وفقدان النتائج الأخرى. قم بإرجاع tool_result الخاص بذلك الجزء مع "is_error": True ونص الخطأ كمحتوى له، لكي يتمكن النموذج من رؤية ما حدث خطأ والاستعادة. اسم أداة وهمي (غير موجود في سجل بياناتك) هو مجرد خطأ آخر: أبلغ عنه كـ is_error، ولا تقم أبداً بتشغيل شيء لم تقم بتسجيله.

ابنِ run_tool_calls(resp, tools) الذي يعيد رسالة المستخدم الوحيدة التالية. عند النجاح يحتوي tool_result على type و tool_use_id و content بالضبط (النتيجة عبر str(...))؛ عند الفشل فإنه يحمل أيضاً "is_error": True. اضغط Run للإجابة على دور مكون من استدعاءين.

دورك

اكتب run_tool_calls(resp, tools) الذي يشغل كل كتلة tool_use في resp["content"] (تجاهل أنواع الكتل الأخرى) ويعيد رسالة مستخدم واحدة {"role": "user", "content": [ ...tool_result blocks... ]}، ونتيجة واحدة لكل استدعاء بالترتيب. كل نتيجة نجاح هي {"type": "tool_result", "tool_use_id": <id>, "content": str(result)}. إذا أدت أداة إلى OR أو لم يكن اسمها في tools، فإن تلك النتيجة تحمل بدلاً من ذلك "is_error": True مع نص الخطأ كـ content، ولا تزال الأدوات الأخرى تعمل.

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.