المنهج الدراسي الدرس 248 من 250 · العمل مع ردود النموذج
العمل مع ردود النموذج

تحقق من استدعاء الأداة قبل تشغيله

لماذا هذا مهم استدعاء الأداة هو طلب النموذج من الكود الخاص بك للقيام بفعل: حجز، دفع، حذف. يملأ النموذج الوسائط من المحادثة، وقد يخطئ فيها. تشغيل حجز ليوم "Friday" أو لعشرين شخصا في مطعم يتسع لاثني عشر شخصا هو خطأ حقيقي بتكلفة حقيقية.

الأداة التي أُعطيت للنموذج:

{"name": "book_table",
 "input_schema": {"type": "object", "required": ["date", "time", "party_size"],
   "properties": {"date": {"type": "string", "description": "YYYY-MM-DD"},
                  "time": {"type": "string", "description": "HH:MM, 24-hour"},
                  "party_size": {"type": "integer", "description": "1 to 12"}}}}

ستة ردود، كل منها نمط تنتجه النماذج الحقيقية: استدعاء صحيح؛ استدعاء مع "Friday" حيث كان مطلوبا تاريخ؛ party_size كالنص "2"؛ استدعاء أغفل time؛ حفلة من 20 (يقول الوصف من 1 إلى 12، والوصف هو طلب وليس ضمانا)؛ ولا يوجد استدعاء أداة على الإطلاق، لأن النموذج سأل المستخدم سؤالا أولا، وهو غالباً التصرف الصحيح.

وظيفتك هي البوابة: قرر ما إذا كان يجب تشغيل الأداة، أو إرسال المشكلات إلى النموذج ليقوم بإصلاحها، أو تمرير السؤال إلى المستخدم. (مع strict: true في تعريف الأداة، تضمن API الأنواع والحقول المطلوبة، ولكنها لا تضمن أن القيم منطقية؛ نطاق القيم والتاريخ الحقيقي دائماً من مسؤوليتك للتحقق منهما.)

حول هذه الردود: هي simulated. كُتب كل واحد منها لهذا المساق بالشكل الذي تعيده Claude Messages API بالضبط (content blocks، stop_reason، usage)، وكل واحد منها ينسخ شيئا تفعله النماذج الحقيقية. هي ليست تسجيلات لنموذج مباشر، لذا فإن الصياغة الدقيقة هي لنا؛ الأشكال والمشكلات هي الحقيقية التي سيواجهها كودك.

دورك

اكتب gate_booking(reply). إذا كانت الإجابة لا تحتوي على كتلة tool_use، أعد {"action": "ask_user", "text": ...} مع النص المدمج. خلاف ذلك، خذ أول استدعاء book_table وتحقق من مدخلاته: كل مفتاح مطلوب موجود؛ date تاريخ حقيقي مكتوب YYYY-MM-DD؛ time مكتوب HH:MM بساعات من 00 إلى 23 ودقائق من 00 إلى 59؛ party_size رقم int حقيقي (ليس سلسلة نصية، وليس True) من 1 إلى 12. أعد {"action": "run", "input": ...} عندما تنجح جميع الشروط، وإلا أعد {"action": "fix", "errors": [...]} مع رسالة واحدة لكل مشكلة، وكل رسالة تذكر الحقل الذي تتعلق به. أبقِ REPLIES الخاص بالبادي كما هو: التحقق يقرأه.

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

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

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