شما تمام دستورهای شل (shell) را که ایجنت اجرا میکند در یک ساختار مشخص کپسوله میکنید تا نوبت گفتوگوی بعدی بتواند اتفاقات رخداده را بخواند. چه مواردی داخل این رکورد قرار میگیرد، کدام فیلد مشخص میکند که دستور موفق بوده یا نه، و وقتی آن فیلد خالی است چه باید کرد؟
اول خودتان جواب بدهید، بعد پاسخ را باز کنید.
پاسخ کوتاه
این رکورد شامل دستور دقیق در قالب argv، بخش انتهایی stdout و بخش انتهایی stderr بهصورت فیلدهای جداگانه، کد خروج (exit code)، مدتزمان اجرا، زمان شروع، و یک یادداشت تکخطی از انتظار ایجنت است. کد خروج سیگنال موفقیت است؛ چون متن خروجی میتواند هر چیزی بگوید، اما کد خروج امکان فریب ندارد. اگر اجراکننده پیش از ثبت خروج با شکست روبهرو شود، رکورد یک کد خروج null و علت خطا را برمیگرداند و حلقه به هیچ وجه نباید با آن به جلو حرکت کند.
پاسخ کامل
فیلدها
| فیلد | دلیل وجود آن |
|---|---|
command |
آرگومانهای دقیق (argv)، بدون غافلگیریهای باز شدن متغیرهای شل (shell expansion) |
stdout_tail |
آخرین خطوط خروجی، که هر بار با روشی کاملاً یکسان کوتاهسازی میشود |
stderr_tail |
آخرین خطوط خطا، جدا نگهداشتهشده از stdout |
exit_code |
تنها سیگنال صریح و بدون ابهام برای موفقیت |
duration_ms |
پروبهای کُند و فرایندهای مهارنشده را نشان میدهد |
started_at |
برچسب زمانی برای بازپخش |
agent_note |
آنچه ایجنت پیش از خواندن نتیجه انتظار داشته است |
کوتاهسازی بدون از دست رفتن خطا
یک لاگ طولانی و حجیم، حلقه را به کلی مختل میکند. اجراکننده تعداد مشخصی از خطوط ابتدایی (head) و خطوط انتهایی (tail) را نگه میدارد و نشانهای درج میکند که بگوید چه تعداد خط حذف شده است. خروجی یکسان همیشه رکوردی یکسان تولید میکند. هیچ چیزی نمونهبرداری تصادفی نمیشود؛ چون خطا و خلاصهی نهایی همیشه در انتهای خروجی قرار دارند.
پاکسازی دادههای حساس هنگام نوشتن
رکورد stdout ممکن است حاوی اطلاعات محرمانه باشد. اجراکننده پیش از اضافه کردن هر خط، توکنهای دسترسی (bearer tokens)، انتسابهای رمز عبور، کلیدهای API و ساختارهای کلیدی شناختهشده را پاکسازی میکند. پاکسازی دادههای حساس در زمان خواندن اشتباه است؛ چون فایلی که روی دیسک ذخیره میشود دقیقاً همان چیزی است که به دست نفوذگر میافتد.
بازخورد با تلهمتری فرق دارد
تلهمتری (Telemetry) برای اپراتورهایی است که اجرای سیستم را در طول زمان بررسی میکنند. بازخورد برای نوبت گفتوگوی بعدیِ همین اجراست. این دو فیلدهای مشترکی دارند، اما در فایلهای متفاوتی نگهداری میشوند و سیاست ماندگاری دادههایشان متفاوت است.
سؤالهای تکمیلی مصاحبهگر
- سطح 1: چرا stderr باید از stdout جدا بماند؟ پاسخ مورد انتظار: خلاصهی خرابی معمولاً در یک جریان و گزارش پیشرفت کار در جریان دیگر ثبت میشود؛ ترکیب بخش انتهایی این دو جریان میتواند خلاصهی خطا را پنهان کند.
- سطح 2: اگر زمان اجرای یک دستور به پایان برسد (timeout)، رکورد چه وضعیتی دارد؟ پاسخ مورد انتظار: کد خروج null، یک فیلد خطا با مهلت زمانی پایانیافته، و هر خروجی ناقصی که تا آن لحظه ثبت شده؛ حلقه نیز از ادامهی کار بازمیماند.
- سطح 2: کاربرد یادداشت ایجنت (agent note) چیست؟ پاسخ مورد انتظار: پیشبینی ایجنت را قبل از دیدن نتیجه ثبت میکند، تا بازبین بتواند مواردی را که ایجنت انتظار موفقیت داشته اما شکست خورده، ببیند.
- سطح 3: یک تلاش مجدد (retry) به نتیجه میرسد. فرایند بازرسی و ممیزی (audit) چطور متوجه شکست اول میشود؟ پاسخ مورد انتظار: هر رکورد یک شناسهی دستور دارد و تلاش مجدد شناسهی دستور والد را همراه میآورد؛ در نتیجه زنجیرهی فراخوانیها مشخص است و تلاش مجدد یک موفقیت مستقل و بیارتباط به نظر نمیرسد.
جوابهای اشتباهی که مصاحبهگرها زیاد میشنوند
- «متن خروجی را برای پیدا کردن واژهی error پردازش کنیم تا خرابی مشخص شود.» متن خروجی در هر ابزار و زبانی فرق میکند، در حالی که کد خروج سیگنالی است که همهی دستورها ارائه میدهند.
- «کل خروجی را نگه داریم، چون کوتاهسازی ممکن است بخشی از اطلاعات را پنهان کند.» یک رکورد عظیم، حلقه را فراتر از سهمیهی توکن آن میبرد، و کوتاهسازی قطعی خطوط انتهایی دقیقاً خطوط مهم را حفظ میکند.
- «وقتی انسان لاگ را باز کرد، دادههای حساس را پاکسازی کنیم.» فایلی که روی دیسک نوشته میشود، خودِ نشتیِ داده است؛ بنابراین پاکسازی دادههای حساس باید حتماً پیش از اضافه شدن متن انجام شود.
کجای دوره آموزش داده میشود
در درس بازخورد محیط اجرا، اجراکنندهای ساخته میشود که این رکورد را ثبت میکند.