سؤال مصاحبه

بازیابی استریم قطع‌شده‌ی A2A بدون بازپخش

Recover a dropped A2A stream without replay

  • سطح ۳: ارشد
  • طراحی
  • ۱۰ دقیقه

کلاینت شما در حال تماشای اجرای یک تست طولانی روی SendStreamingMessage است. پس از چهار فریم، اتصال قطع می‌شود، اما ایجنت به کارش ادامه می‌دهد و خطوط بیشتری به دست‌سازه‌ی لاگ می‌افزاید. فرایند بازیابی را طراحی کنید: کلاینت چطور متوجه موارد ازدست‌رفته می‌شود، چگونه لاگ را بازسازی می‌کند و از کجا می‌فهمد چه زمانی باید تلاش برای اتصال مجدد را متوقف کند؟

اول خودتان جواب بدهید، بعد پاسخ را باز کنید.

پاسخ کوتاه

هیچ چیزی بازپخش (Replay) نمی‌شود؛ چون استریم یک نمای زنده است و در مشخصات پروتکل هیچ مکان‌نمایی (Cursor) تعریف نشده است. کلاینت SubscribeToTask را با شناسه‌ی وظیفه فراخوانی می‌کند و نخستین فریم باید اسنپ‌شاتی از Task باشد که تمام چانک‌های نوشته‌شده در زمان قطعی کلاینت را در خود دارد. کلاینت دست‌سازه‌ی ناقص خود را با نسخه‌ی اسنپ‌شات جایگزین می‌کند و فریم‌های بعدی را به انتهای آن می‌افزاید. وقتی در اشتراک‌های بعدی خطای UnsupportedOperationError برگردانده شود، یعنی وظیفه به وضعیت نهایی رسیده است؛ بنابراین کلاینت تلاش مجدد را متوقف کرده و وظیفه‌ی نهایی را با GetTask می‌خواند.

پاسخ کامل

استریم چیست؟

هر رویداد حامل یک StreamResponse است که دقیقاً یکی از فیلدهای task، message، statusUpdate یا artifactUpdate را در خود دارد. تمام پیاده‌سازی‌ها باید رویدادها را دقیقاً به ترتیب ایجاد و به تک‌تک استریم‌های بازِ آن وظیفه تحویل دهند. چرخه‌ی حیات وظیفه وابسته به چرخه‌ی حیات هیچ استریم به‌خصوصی نیست.

در اجرای ثبت‌شده، اتصال کلاینت پس از چهار فریم بسته شد. ایجنت سپس دو چانک دیگر اضافه کرد که به هیچ اتصالی ارسال نشدند. این رویدادها از دست رفته‌اند، اما وظیفه‌ی ذخیره‌شده هر دو چانک را در خود دارد.

اسنپ‌شات منبع حقیقت است

SubscribeToTask {id}
  frame 1: task snapshot, state WORKING, artifact test-log with parts 01 to 04
  frames 2 to 5: artifactUpdate, chunks 05 to 08, append true
  frame 6: statusUpdate, TASK_STATE_COMPLETED, "96 passed"

بازسازی را بر اساس artifactId انجام دهید. چانکی که فاقد append باشد، جایگزین دست‌سازه می‌شود یا آن را از نو می‌سازد؛ و چانکی با append: true بخش‌های خود را به دست‌سازه‌ی ذخیره‌شده با همان شناسه اضافه می‌کند. اسنپ‌شات فقط وضعیت (status) فعلی را نگه می‌دارد، بنابراین کلاینتی که دوباره متصل می‌شود ممکن است به‌روزرسانی‌های وضعیت را از دست بدهد. به همین دلیل، نتایج کار باید در قالب دست‌سازه‌ها قرار گیرند.

چه زمانی استریم پایان می‌یابد؟

در نسخه‌ی 1.0 فلگ final حذف شد، بنابراین هیچ فریمی پایان کار را اعلام نمی‌کند. وقتی وظیفه به وضعیت نهایی می‌رسد، استریم باید بسته شود. با این حال، در وضعیت‌های وقفه (Interrupted) رفتارها یکسان نیست: ابزار تستِ ثبت‌شده اتصال را در TASK_STATE_INPUT_REQUIRED می‌بندد اما در TASK_STATE_AUTH_REQUIRED باز نگه می‌دارد؛ رفتار شش SDK موجود نیز دقیقاً به همین شکل دوگانه است. بنابراین، بسته‌شدن اتصال به‌خودی‌خود صرفاً یعنی خواندن داده‌ها تمام شده است. متد GetTask را فراخوانی کنید؛ اگر وظیفه به وضعیت نهایی نرسیده بود، متناسب با وضعیت آن اقدام کرده و دوباره مشترک شوید.

چه زمانی باید متوقف شد؟

فراخوانی SubscribeToTask روی وظیفه‌ای تکمیل‌شده با خطای UnsupportedOperationError و کد -32004، به‌صورت یک پاسخ JSON معمولی و بدون باز شدن استریم، شکست می‌خورد. این همان نشانه‌ی توقف است. وظیفه‌ی نهایی را با GetTask بخوانید و دست‌سازه‌های موجود در آن را نتیجه‌ی نهایی کار بدانید.

دو قاعده‌ی دیگر بر اساس داده‌های ثبت‌شده

  • اولین چانک هر دست‌سازه را بدون append بفرستید؛ سرورها درباره‌ی ارسال append: true برای شناسه‌ای ناشناخته رفتارهای متفاوتی دارند: یکی وظیفه را با شکست مواجه می‌کند، یکی چانک را نادیده می‌گیرد و دو سرور دیگر دست‌سازه‌ای جدید می‌سازند.
  • در بستر HTTP+JSON، درخواست را به‌صورت POST به مسیر /tasks/{id}:subscribe ارسال کنید؛ زیرا سرورِ دو SDK متد GET را مسیریابی نمی‌کنند، هرچند سرور باید هر دو را بپذیرد.
سؤال‌های تکمیلی مصاحبه‌گر
  • سطح 3: چرا باید دست‌سازه را با اسنپ‌شات جایگزین کرد و آن را merge نکرد؟ پاسخ مورد انتظار: چانک‌های ازدست‌رفته هرگز بازپخش نمی‌شوند و اسنپ‌شات همان نسخه‌ی ذخیره‌شده است؛ بنابراین، merge کردن باعث تکرار بخش‌ها می‌شود.
  • سطح 3: استریم دقیقاً بعد از فریمِ وضعیت TASK_STATE_INPUT_REQUIRED بسته می‌شود. آیا وظیفه تمام شده است؟ پاسخ مورد انتظار: خیر؛ بسته‌شدن فقط به فرایند خواندن پایان داده است؛ بنابراین GetTask را فراخوانی کنید و به ورودی خواسته‌شده روی همان وظیفه پاسخ دهید.
  • سطح 4: در آخرین پیام وضعیت عبارت «done» آمده بود اما پیش از بسته شدن، هیچ وضعیت نهایی دریافت نشد. به کدام باید اعتماد کرد؟ پاسخ مورد انتظار: به وضعیت دریافت‌شده از GetTask؛ وظیفه تنها زمانی پایان‌یافته تلقی می‌شود که وضعیتی نهایی برای آن ثبت شده باشد، نه با بسته‌شدن اتصال یا بر اساس متن پیام‌ها.
  • سطح 4: فیلد lastChunk چه ارتباطی با پایان وظیفه دارد؟ پاسخ مورد انتظار: این فیلد فقط همان یک دست‌سازه را می‌بندد؛ استریم ثبت‌شده پس از lastChunk دو فریم دیگر هم فرستاد، و وظیفه‌ای لغوشده ممکن است دست‌سازه‌ای ذخیره کرده باشد که اصلاً چنین فیلدی دریافت نکرده است.
جواب‌های اشتباهی که مصاحبه‌گرها زیاد می‌شنوند
  • «با شناسه‌ی آخرین رویداد دوباره متصل شوید تا سرور آن را بازپخش کند.» پروتکل هیچ مکان‌نما و بازپخشی تعریف نکرده است. در عوض، SubscribeToTask با یک اسنپ‌شات شروع می‌شود.
  • «بسته‌شدن اتصال یعنی وظیفه تمام شده است.» سرورها در وضعیت‌های مختلفی استریم را می‌بندند. قبل از توقف، وضعیت را با GetTask بررسی کنید.
  • «چانک‌های قبلی را نگه دارید و چانک‌های اسنپ‌شات را به انتهای آن اضافه کنید.» این کار بخش‌ها را تکراری می‌کند. اسنپ‌شات جایگزین نسخه‌ی شما می‌شود و فریم‌های بعدی به آن اضافه خواهند شد.

کجای دوره آموزش داده می‌شود

بخش استریمینگ قطع شدن استریم و اسنپ‌شات را ثبت کرده است و بخش دست‌سازه‌ها قواعد بازسازی را ارائه می‌دهد.