یک برنامهریز (planner) با فراخوانی متوالی GetTask، وضعیت یک ایجنت در مخزن راهدور (remote agent) را تا پایان وظیفه بررسی میکند (poll میکند). این حلقه زمانی متوقف میشود که وضعیت وظیفه completed، failed یا canceled باشد. در ارتباط با یک ایجنت دیپلوی، این حلقه تا ابد ادامه مییابد و هرگز برنمیگردد. در ارتباط با یک اجراکنندهی آزمون (test runner)، برنامهریز نسخهای را دیپلوی میکند که مجموعهآزمون آن با شکست مواجه شده بود. علت هر دو باگ را توضیح دهید.
اول خودتان جواب بدهید، بعد پاسخ را باز کنید.
پاسخ کوتاه
این حلقه فقط سه وضعیت پایانی (terminal state) را میشناسد، در حالی که چهار وضعیت پایانی وجود دارد. ایجنت دیپلوی وظیفه را رد کرده است و وظیفهای که در وضعیت TASK_STATE_REJECTED قرار بگیرد دیگر هرگز تغییر وضعیت نمیدهد؛ به همین دلیل حلقه تا ابد میچرخد. اجراکنندهی آزمون نیز کاری را که به آن محول شده بود به پایان رسانده است؛ بنابراین وضعیت وظیفهی آن حتی با وجود آزمون ناموفق، TASK_STATE_COMPLETED است، چرا که حکم ارزیابی (verdict) جزو نتایج کار است و نتایج در قالب دستسازهها (artifacts) منتقل میشوند.
پاسخ کامل
نه وضعیت مختلف و دو مجموعهای که کلاینت باید هاردکد کند
| دسته | وضعیتها |
|---|---|
| فعال (active) | TASK_STATE_SUBMITTED، TASK_STATE_WORKING |
| دارای وقفه (interrupted) | TASK_STATE_INPUT_REQUIRED، TASK_STATE_AUTH_REQUIRED |
| پایانی (terminal) | TASK_STATE_COMPLETED، TASK_STATE_FAILED، TASK_STATE_CANCELED، TASK_STATE_REJECTED |
مقدار TASK_STATE_UNSPECIFIED همان مقدار صفرِ پروتو (proto zero value) است. با این مقدار و هر نام ناشناختهی دیگری مانند خطا برخورد کنید. در پروتو چهار وضعیت به عنوان پایانی و دو وضعیت به عنوان وقفه مشخص شدهاند، اما هیچ جدول انتقالی برای وضعیتها ارائه نشده است؛ بنابراین هر انتقالی از یک وضعیت غیرپایانی را معتبر بدانید. یک ایجنت دیپلوی میتواند مستقیماً از وضعیت submitted وظیفه را رد کند.
باگ اول: پایانِ فراموششده
وضعیت Rejected یعنی ایجنت تصمیم گرفته وظیفه را انجام ندهد. در اجرای ثبتشده، پیام وضعیت این بود: «Production deploys are outside this agent's policy. Use the release train.» همین درخواست مجدداً با همین امتناع مدل (refusal) روبهرو میشود؛ بنابراین برنامهریز باید متوقف شود و پیام را دنبال کند، نه اینکه دوباره تلاش کند.
باگ دوم: وضعیت یک وظیفه، حکم ارزیابی آن نیست
وضعیت Completed یعنی وظیفه با موفقیت به پایان رسیده است، و کار محولشده هم اجرای مجموعهآزمون بوده است. در اجرای انسدادی (blocking) ثبتشده، پیام وضعیت عبارت «1 failed, 11 passed» را نشان میداد و دستسازهی summary.json حاوی مقادیر "passed": 11 و "failed": 1 بود. برنامهریز پیش از دیپلوی باید مقدار failed را از این بخش دادهها بخواند. پیام وظیفه نباید حامل خروجی اصلی آن باشد.
پاسخ یک وظیفهی خاتمهیافته به فراخوانیها
| فراخوانی روی وظیفهی پایانی | پاسخ |
|---|---|
GetTask |
آخرین وضعیت وظیفه، تا زمانی که سرور آن را نگه دارد |
SendMessage با شناسه همان وظیفه (taskId) |
UnsupportedOperationError با کد -32004 |
SubscribeToTask |
UnsupportedOperationError با کد -32004 |
CancelTask |
TaskNotCancelableError با کد -32002 |
برای ادامهی کار، وظیفهی جدیدی در همان contextId بسازید و نام وظیفهی خاتمهیافته را در referenceTaskIds بیاورید.
سؤالهای تکمیلی مصاحبهگر
- سطح 2: این حلقه کدام وضعیتهای دیگر را باید مدیریت کند و چگونه؟ پاسخ مورد انتظار: دو وضعیت دارای وقفه؛ به
TASK_STATE_INPUT_REQUIREDبا یک پیام روی همان وظیفه پاسخ دهید، وTASK_STATE_AUTH_REQUIREDرا خارج از ساختار A2A به یک تأییدکننده هدایت کنید، در حالی که در حالت اشتراک (subscribe) یا نظرسنجی (poll) منتظر میمانید. - سطح 3: متد
CancelTaskرا فراخوانی میکنید و خطای-32002میگیرید. قدم بعدی چیست؟ پاسخ مورد انتظار: متدGetTaskرا فراخوانی کنید؛ اگر وضعیت canceled باشد یعنی لغوِ قبلی اثر کرده است، اگر وضعیت پایانی دیگری باشد یعنی وظیفه پیش از درخواست لغو تمام شده است، و اگر وضعیتی در حال اجرا باشد یعنی سرور نمیتواند آن را متوقف کند. - سطح 3: فرایند (process) ایجنت در میانهی انجام وظیفه کرش میکند و فراخوانی انسدادی ارسال شما خطا برمیگرداند. آیا وظیفه ناموفق (failed) شده است؟ پاسخ مورد انتظار: نتیجه را نامشخص در نظر بگیرید؛ SDK مرجع وظیفه را به صورت failed ذخیره میکند، اما کلاینت فقط یک خطا دریافت کرده است، بنابراین باید وضعیت وظیفه را دوباره بخوانید.
- سطح 4: چگونه یک بازنگریِ تکمیلشده را با تفاوتهای بازنگریِ (diff) تغییریافته ادامه میدهید؟ پاسخ مورد انتظار: یک وظیفهی جدید با همان
contextIdو بدونtaskIdایجاد کنید و وظیفهی قبلی را درreferenceTaskIdsقرار دهید؛ یک وظیفهی پایانی هیچ پیام جدیدی نمیپذیرد.
جوابهای اشتباهی که مصاحبهگرها زیاد میشنوند
- «وضعیت را با رشتهی حروف کوچک
completedمقایسه کنید.» نسخهی فعلی نامهای enum مانندTASK_STATE_COMPLETEDرا ارسال میکند، و هر نام ناشناختهای باید خطا تلقی شود، نه دلیلی برای انتظار. - «تکمیل یک وظیفه (completed) یعنی آزمونها پاس شدهاند.» وضعیت Completed یعنی ایجنت کاری را که خواسته بودید به پایان رسانده است. حکم ارزیابی داخل دستسازه قرار دارد.
- «یک پیام دیگر به وظیفهی ردشده بفرستید و دوباره درخواست کنید.» وظیفهای که در وضعیت پایانی باشد پیامها را رد میکند. باید یک وظیفهی جدید در همان زمینه بسازید.
کجای دوره آموزش داده میشود
بخش وضعیتهای پایانی هر چهار پایان مختلف را بر اساس اجراهای ثبتشده نشان میدهد، و بخش وضعیت و چرخهی حیات وظیفه تمام این نه مقدار را دستهبندی میکند.