المنهج الدراسي الدرس 226 من 250 · المشروع: Production AI Gateway
المشروع: Production AI Gateway

التوجيه إلى Handler + Fallback

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

النمط هو سلسلة fallback chain: كل intent يرتبط بقائمة مرتبة من handlers لمحاولة تنفيذها. الأول هو handler المفضل؛ إذا فشل، تنتقل إلى التالي، والرابط الأخير هو دائماً fallback عام لا يمكن أن يفشل. الـ intents غير المعروفة تتخطى مباشرة إلى ذلك الـ fallback. مدير التوظيف يقرأ هذا كـ "يفهم التدهور اللطيف"، وهذا هو معظم ما يمثله عمل الموثوقية فعلياً.

ستقوم ببناء دالتين فوق جدول توجيه مثل هذا:

ROUTES = {
    "weather": ["weather_api", "weather_cache", "fallback"],
    "account": ["account_service", "fallback"],
    "billing": ["billing_service", "fallback"],
}
  • route(intent) -> اسم primary الخاص بـ intent (الرابط الأول في سلسلتها). الـ intent الذي ليس في الجدول يوجه إلى "fallback".
  • handle(request, handlers) -> الطلب هو dict مثل {"intent": ..., "text": ...} و handlers يربط اسما بـ callable. قم بالمرور على سلسلة intent بالترتيب، و try كل handler، وأرجع نتيجة أول لا يرفع . أبلغ عن الـ handler الفائز، مثل {"handler": name, "result": ...}.

جوهر الأمر هو loop مع try/except بحيث يتم التقاط crashing handler وتستمر في العمل:

for name in chain_for(intent):
    fn = handlers.get(name)
    if fn is None:
        continue
    try:
        result = fn(request)
        return {"handler": name, "result": result}
    except Exception:
        continue   # this handler is down, slide to the next link

بما أن السلسلة تنتهي دائماً بـ fallback، فإن الطلب لا يمكن خدمته فقط إذا كان حتى البديل مفقوداً أو معطلاً. اضغط على Run لتوجيه بعض الطلبات، ثم راقب طلباً معطلاً عمداً في primary handler وهو ينتقل إلى الرابط التالي.

دورك

اكتب route(intent) لإرجاع اسم المعالج الأساسي لنية معينة (الإدخال الأول في سلسلة fallback الخاصة بها؛ النية غير المعروفة -> "fallback"). اكتب handle(request, handlers) حيث request هو {"intent", "text"} و handlers يربط اسما بـ callable: قم بمسح سلسلة النية، و try كل معالج بالترتيب، وأرجع {"handler": name, "result": ...} لأول معالج لا يرفع استثناء. يجب على النوايا غير المعروفة والمعالجات الأساسية الفاشلة العودة للأسفل في السلسلة (التي تنتهي دائما بـ fallback). إذا رفع كل معالج في السلسلة استثناء (أو كان مفقودا)، لا ترفع استثناء: أرجع {"handler": None, "result": None}، لكي يتمكن المستدعي من إظهار خطأ ودود. يسمح بمفاتيح إضافية مثل trace للمعالجات التي تم محاولتها.

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

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

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