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