ابزاری برای حذف یادداشتها به نام notes_delete، سه یادداشت پیدا میکند که با عنوان ارائهشده از سوی کاربر همخوانی دارند. جریان کاری تأیید را بر اساس آخرین بازنگری MCP طراحی کنید: سرور چگونه از کاربر میخواهد یکی را انتخاب و تأیید کند، پاسخ چگونه بازمیگردد، و چه سازوکاری جلوی کلاینت را میگیرد تا به پرسش متفاوتی پاسخ ندهد یا یک تأییدیه را با آرگومانهای تغییریافته بازپخش نکند؟
اول خودتان جواب بدهید، بعد پاسخ را باز کنید.
پاسخ کوتاه
سرور پاسخی با نوع نتیجهی (Result Type) input_required میفرستد که در آن یک درخواست فرم elicitation/create جاسازی شده است؛ این فرم شناسهی سه یادداشت کاندید و یک فیلد بولی confirm را به همراه یک requestState محافظتشده از نظر یکپارچگی در بر دارد. کلاینت فرم را نمایش میدهد و همان فراخوانی اولیهی tools/call را با یک شناسهی درخواست جدید، همراه با بازتاب دادن requestState و inputResponses تکرار میکند. سرور وضعیت را بر اساس هویت احرازشده (Authenticated principal)، متد، خلاصهی درهمسازیشدهی (Digest) آرگومانها، مجموعهی گزینههای کاندید، فاز عملیات و زمان انقضا امضا میکند؛ سپس هنگام دریافت مجدد، صحت بازتاب را میسنجد، مطمئن میشود شناسهی انتخابی درون مجموعهی امضاشده وجود دارد، مجوز فضای کاری را دوباره اعتبارسنجی میکند، مهار مسیر (Containment) را مجدداً چک میکند و در نهایت پیش از اعمال حذف، یک نانس (Nonce) یکبارمصرف را در مخزن مشترک بازپخش مصرف میکند.
پاسخ کامل
پاسخ نخست
{
"resultType": "input_required",
"inputRequests": {
"delete_choice": {
"method": "elicitation/create",
"params": {
"mode": "form",
"message": "Choose one matching note and confirm deletion.",
"requestedSchema": {
"type": "object",
"properties": {
"note_id": {"type": "string", "enum": ["note-3", "note-7", "note-14"]},
"confirm": {"type": "boolean"}
},
"required": ["note_id", "confirm"]
}
}
}
},
"requestState": "integrity-protected-delete-state"
}
سرورهای کنونی هیچ درخواست معکوس JSON-RPCای ارسال نمیکنند. درخواست جاسازیشده به صورت کامل و همراه با method و params ارسال میشود و کلید آن در تلاش مجدد کلاینت باید با مدخل موجود در inputResponses مطابقت داشته باشد.
قابلیتها روی همین درخواست بررسی میشوند
سرور فقط زمانی مجاز به جاسازی فرم است که clientCapabilities در درخواست جاری از آن پشتیبانی کند. هر دو مقدار {"elicitation": {}} و {"elicitation": {"form": {}}} از حالت فرم پشتیبانی میکنند. تعریفِ صرفاً مبتنی بر URL چنین پشتیبانیای ندارد و در صورت وقوع، سرور کد خطای -32021 را همراه با مقدار {"elicitation":{"form":{}}} در فیلد data.requiredCapabilities برمیگرداند. قابلیتهای اعلامشده در درخواستهای قبلی بههیچوجه بهحساب نمیآیند.
محدودیتهای حالت فرم
ریشهی فرم یک شیء شامل فیلدهای ساده و جزء سازنده (Flat primitive) یا مقادیر شمارشی پشتیبانیشده است. از این حالت برای انتخاب میان گزینهها، تأیید عملیاتهای حساس و تخریبکننده، یا دریافت اولویتهای غیرحساس استفاده کنید. هرگز رمزهای عبور، کلیدهای API یا اطلاعات پرداخت را از این طریق جمعآوری نکنید؛ زیرا این دادهها از کلاینت عبور میکنند و ممکن است به لاگها یا زمینهی مدل برسند. برای این جریان کاری خارجی، حالت URL در نظر گرفته شده است.
سه نتیجه، سه رفتار
| اقدام | معنا | رفتار سرور |
|---|---|---|
accept |
کاربر فرم را ارسال کرده است | اعتبارسنجی محتوا و ادامهی مسیر |
decline |
کاربر مخالفت کرده است | بازگرداندن یک پاسخ امتناع مدل (Refusal) کامل و بدون خطا؛ مصرف نانس بدون انجام حذف |
cancel |
کاربر فرم را بست یا نتوانست آن را کامل کند | توقف ایمن؛ وضعیت تا زمان انقضا قابلیت تلاش مجدد را حفظ میکند |
هرگز نبود داده در محتوا را به معنای رضایت کاربر تلقی نکنید، و رد کردن را هم هرگز به پرامپت تکراری تبدیل نکنید.
دادههای متصل به وضعیت امضاشده
این وضعیت حاوی هویت احرازشده، متد مبدأ، خلاصهی درهمسازیشدهی workspaceUri و title، شناسههای مجاز یادداشتها که در فرم نشان داده شدهاند، فاز عملیات و یک زمان انقضای کوتاه است. سرور در تلاش مجدد، امضا را اعتبارسنجی میکند، پاسخ را در برابر اسکیما میسنجد، بررسی میکند که آیا note_id انتخابی در مجموعهی کاندیدهای امضاشده وجود دارد یا خیر، مجوز فضای کاری را دوباره ارزیابی میکند، مهار مسیر را بازبینی میکند و تنها پس از طی این مراحل، تغییرات را اعمال میکند. اگر عنوان تغییر کرده باشد، امکان استفادهی مجدد از وضعیت اصلی وجود ندارد.
چرا استفاده از HMAC بهتنهایی کافی نیست؟
یک وضعیت معتبر میتواند تا قبل از رسیدن به زمان انقضا بازپخش شود. نانس را دقیقاً یکبار در مخزن بازپخشی که بین همهی نمونههای کنترلکننده (Handler) مشترک است ذخیره و مصرف کنید، و این ادعای مالکیت اتمیک را تا پایان فرایند حذف نگه دارید. پایگاه داده میتواند ثبت این ادعا و تغییر دادهها را در قالب یک تراکنش واحد گره بزند. همیشه پیش از ادعای مالکیت نانس، دادهها را اعتبارسنجی کنید: یک پاسخ نامعتبر یا عملیات لغو (Cancel) نباید چیزی را مصرف کند.
سؤالهای تکمیلی مصاحبهگر
- سطح 3: کلاینت فقط قابلیت
{"elicitation": {"url": {}}}را اعلام میکند. سرور چه کار میکند؟ پاسخ مورد انتظار: خطای-32021را همراه با قابلیت فرمِ الزامی در فیلدdataبرمیگرداند؛ سرور نباید حالتی را جاسازی کند که در درخواست فعلی اعلام نشده است. - سطح 3: کاربر کادر محاورهای را میبندد. این عمل چه اقدامی محسوب میشود و چه بر سر وضعیت میآید؟ پاسخ مورد انتظار: اقدام
cancel؛ هیچ تغییری اعمال نمیشود و وضعیت برخلاف حالتdeclineکه پایانی قطعی است، تا زمان انقضا قابلیت تلاش مجدد دارد. - سطح 4: دو نمونه از سرور از یک مخزن یادداشت مشترک استفاده میکنند. چگونه جلوی اجرای یک تأییدیه توسط هر دو نمونه را میگیرید؟ پاسخ مورد انتظار: یک مخزن مشترک بازپخش با ادعای اتمیک نانس که با تغییر دادهها پیوند خورده است؛ آزمون این درس، دو شیء سرور را روی یک وضعیت اجرا میکند.
- سطح 4: یادداشتی پس از نمایش فرم، به خارج از فضای کاری منتقل میشود. چه چیزی جلوی آن را میگیرد؟ پاسخ مورد انتظار: بررسی رکورد زنده و ارزیابی مجدد مهار مسیر پیش از اعمال تغییرات، نه صرفاً وضعیت امضاشده.
جوابهای اشتباهی که مصاحبهگرها زیاد میشنوند
- «فهرست کاندیدها را بر اساس اتصال، در حافظهی سرور نگه میداریم.» هیچ نشستی وجود ندارد و تلاش مجدد میتواند به هر نمونهای برسد. کاندیدها درون وضعیت امضاشده جابهجا میشوند.
- «چون میزبان فرم را اعتبارسنجی کرده، سرور میتواند به محتوا اعتماد کند.» کلاینت کنترل همهی دادههای ارسالی را در دست دارد. سرور باید اسکیما و مجموعهی کاندیدها را دوباره اعتبارسنجی کند.
- «برای تأیید، رمز عبور کاربر را درون فرم از او بخواهید.» حالت فرم نباید اسرار را حمل کند. جریان کاری اعتبارنامهی خارجی از حالت URL استفاده میکند و کاربرِ مرورگر را به همان هویت احرازشده پیوند میزند.
کجای دوره آموزش داده میشود
این جریان کاری به همراه مخزن بازپخش در درس ریشهها و استخراج ورودی ساخته میشود، و در درس امنیت پروتکل نیز با requestState درست مانند یک ورودی خصمانه برخورد میکنیم.