سرفصل‌ها درس 226 از 250 · پروژه: دروازه هوش مصنوعی تولید
پروژه: دروازه هوش مصنوعی تولید

مسیر به یک هندلر + پشتیبان

طبقه‌بندی‌کننده به شما گفت چه درخواست می‌خواهد. اکنون گیت‌وی باید انجام دادن چیزی با آن: آن را به قطعه کد مناسب بسپارید. یعنی مسیر‌یابیو در محیط تولید هرگز به سادگی نگاشت یک intent به یک function نیست. سرویس‌ها از کار می‌افتند. ارائه‌دهندهٔ آب‌وهوا دچار زمان‌مرگ می‌شود. وظیفهٔ شما این است که دروازه را مقاوم بسازید تا یک وابستگی ناپایدار کل درخواست را با خود به همراه نبرد.

الگو یک است زنجیره پشتیبانهر نیت به یک فهرست مرتب از دستگیرنده‌ها برای اجرا نگاشت می‌شود. اولین مورد دستگیرندهٔ ترجیحی است؛ اگر شکست بخورد، به مورد بعدی می‌روید و آخرین لینک همیشه یک دستگیرندهٔ عمومی است. fallback که نمی‌تواند شکست بخورد. نیت‌های نامعلوم مستقیماً به آن راه‌حل پشتیبان می‌روند. یک مدیر استخدام این را این‌گونه می‌فهمد: «درک تخریب شایسته»، که در واقع بیشتر کارهای مربوط به قابلیت اطمینان همین است.

شما دو تابع را بر روی یک جدول مسیریابی به این شکل خواهید ساخت:

ROUTES = {
    "weather": ["weather_api", "weather_cache", "fallback"],
    "account": ["account_service", "fallback"],
    "billing": ["billing_service", "fallback"],
}
  • route(intent) -> نام اصلی پردازشگر یک intent (اولین لینک در زنجیرهٔ آن). intenti که در جدول وجود ندارد به "fallback".
  • handle(request, handlers) -> درخواست شبیه یک دیکت است {"intent": ..., "text": ...} و handlers یک نام را به یک قابل‌فراخوانی نگاشت می‌کند. زنجیرهٔ intent را به ترتیب پیمایش می‌کند، try هر هندلر، و نتیجهٔ آن را بازگردانید اولین کسی که دست بالا نمی‌برد. گزارش دهید کدام هندلر برنده شد، مثلاً {"handler": name, "result": ...}.

هستهٔ اصلی آن یک حلقه با یک try/except پس یک دستگیرکنندهٔ استثنا گرفته می‌شود و شما به کارتان ادامه می‌دهید:

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یک درخواست تنها زمانی غیرقابل پاسخ‌گویی است که حتی پشتیبان هم وجود نداشته یا خراب باشد. فشار دهید دویدن چند درخواست را مسیریابی کنید، سپس تماشا کنید که یکی از آن‌ها با یک هندلر اصلی عمداً معیوب، به لینک بعدی منتقل می‌شود.

نوبت شما

route(intent) را بنویسید که نام دست‌پرداز اصلی برای یک نیت را بازمی‌گرداند (اولین ورودی از زنجیرهٔ پشتیبان آن؛ نیت ناشناخته → "fallback"). handle(request, handlers) را بنویسید که در آن request برابر است با {"intent", "text"} و handlers یک نام را به یک تابع قابل فراخوانی نگاشت می‌کند: زنجیرهٔ نیت را پیمایش کنید، هر دست‌پرداز راtry به ترتیب فراخوانی کنید و برای اولین دست‌پردازی که خطا ایجاد نمی‌کند، {"handler": name, "result": ...} را بازگردانید. نیّت‌های ناشناخته و primaryهای شکست‌خورده باید به پایین زنجیره بازگردند (که همیشه در fallback پایان می‌یابد). اگر هر دستگیرکننده در زنجیره خطا ایجاد کند (یا وجود نداشته باشد)، خطا ایجاد نکنید: {"handler": None, "result": None} را برگردانید تا فراخواننده بتواند یک خطای دوستانه نمایش دهد. کلیدهای اضافی مانند یک trace از دستگیرکننده‌های تلاش‌شده مجاز هستند.

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

این تمرین به‌زودی باز می‌شود

درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و می‌توانید همین الان این درس را بخوانید.