استدعاءات الأدوات المتوازية و 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، ولا تزال الأدوات الأخرى تعمل.
سيفتح هذا التمرين قريبا
أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.
يقوم هذا المتصفح بحظر ملفات تعريف الارتباط لـ learn.floati.life، لذا لا يمكن فتح الدروس التي أنهيتها هنا بالترتيب. اسمح بملفات تعريف الارتباط لهذا الموقع وأعد التحميل.