سؤال مصاحبه

حلقه‌ی صفحه‌بندی که دو صفحه زودتر به پایان می‌رسد

The pagination loop that ends two pages short

  • سطح ۲: میانی
  • کدخوانی
  • ۷ دقیقه

کلاینتی فهرست ابزارهای یک سرور MCP را با این حلقه جمع‌آوری می‌کند:

tools = []
cursor = None
while True:
    result = call("tools/list", cursor=cursor)
    tools.extend(result["tools"])
    if not result.get("nextCursor"):
        break
    cursor = result["nextCursor"]

در ارتباط با یک سرور خاص، کلاینت فقط صفحه‌ی اول را دریافت می‌کند و ردگیری محاسبات (trace) هم تنها یک درخواست را نشان می‌دهد. کد را بخوانید و باگ آن را پیدا کنید. سپس دو کار دیگر را نام ببرید که کلاینت هرگز نباید با مکان‌نما (cursor) انجام دهد.

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

پاسخ کوتاه

این حلقه وضعیت صدق (truthiness) مکان‌نما را می‌سنجد، در حالی که رشته‌ی خالی هم مکان‌نمایی معتبر است. سرور پس از صفحه‌ی اول خود "" را برگردانده، شرط حلقه آن را نادرست (false) ارزیابی کرده و حلقه پیش از ارسال درخواست دوم متوقف شده است. صفحه‌بندی را فقط زمانی متوقف کنید که nextCursor وجود نداشته باشد یا مقدار آن null باشد، و مقدار دریافتی را دقیقاً همان‌طور که دریافت کرده‌اید پس بفرستید. کلاینت همچنین هرگز نباید مکان‌نما را رمزگشایی (decode) کند یا دو مکان‌نما را برای بررسی ترتیب با یکدیگر مقایسه نماید.

پاسخ کامل

تنها تصمیمی که کلاینت مجاز به گرفتن آن است

if result.get("nextCursor") is None:
    break
cursor = result["nextCursor"]

تعیین اندازه‌ی صفحه و قالب مکان‌نما بر عهده‌ی سرور است. سرور نمونه در این درس عمداً بعد از صفحه‌ی اول خود "" را برمی‌گرداند؛ بنابراین ردگیری محاسبات درست شامل یک درخواست بدون مکان‌نما و به دنبال آن درخواستی دیگر با مکان‌نمای "" است.

مکان‌نماها مات و غیرشفاف هستند

هرگز مکان‌نما را رمزگشایی نکنید، مقداری به آن اضافه نکنید، آن را با مکان‌نمای پیشین (prior) مقایسه نکنید یا شماره‌ی صفحه را از روی آن حدس نزنید. سرور ممکن است مکان‌نما را امضا کند، آن را به نسخه‌ای از کاتالوگ مقید سازد، یا به وضعیتی خصوصی در سمت خود نگاشت کند. این‌ها جزئیات داخلی سرور هستند و ممکن است بدون اطلاع قبلی تغییر کنند. ارسال مکان‌نمای نامعتبر خطای پارامترهای نامعتبر در JSON-RPC، یعنی کد -32602 را برمی‌گرداند.

چرا این باگ اهمیت دارد

فهرست ابزارها نخستین گام از پایپ‌لاین قرارداد (contract pipeline) است: شناسایی (discovery)، پذیرش، فراخوانی، اجرا و مصرف. کلاینتی که صفحات پایانی را جا بیندازد، کاتالوگی ناقص را در اختیار مدل می‌گذارد و ممکن است توصیف‌گری (descriptor) را که باید پذیرفته یا رد می‌شده از دست بدهد. مرحله‌ی شناسایی باید پیش از آغاز پذیرش، به‌طور کامل و قطعی (deterministic) انجام شود.

سؤال‌های تکمیلی مصاحبه‌گر
  • سطح 2: صفحه‌ای دریافت می‌شود که nextCursor دارد اما آرایه‌ی tools آن خالی است. آیا ادامه می‌دهید؟ پاسخ مورد انتظار: بله؛ تا زمانی که nextCursor وجود دارد و مقدارش null نیست باید ادامه داد.
  • سطح 2: مکان‌نما شبیه به رشته‌ای در قالب Base64 است. آیا کلاینت مجاز است برای پرش به جلو آن را رمزگشایی کند؟ پاسخ مورد انتظار: خیر؛ این مقدار مات است و سرور ممکن است آن را امضا کرده یا به نسخه‌ای خاص از کاتالوگ مقید کرده باشد.
  • سطح 3: سرور چه چیزی را باید درون مکان‌نما قرار دهد تا کلاینت نتواند از آن سوءاستفاده کند؟ پاسخ مورد انتظار: یک توکن (token) امضاشده یا نگاشت‌شده در سمت سرور، که در صورت نیاز به نسخه‌ی کاتالوگ مقید شده باشد و مقادیر نامعتبر یا منقضی با خطای -32602 رد شوند.
  • سطح 4: چه شواهدی (evidence) شناساییِ صفحه‌بندی‌شده‌ی کامل را برای یک گیت‌وی اثبات می‌کند؟ پاسخ مورد انتظار: ردگیری محاسبات صفحات، مجموعه‌ی توصیف‌گرهای پذیرفته‌شده و ردشده، و بررسی این‌که فراخوانی‌های مکرر همان ترتیب منطقی را بازمی‌گردانند.
جواب‌های اشتباهی که مصاحبه‌گرها زیاد می‌شنوند
  • «رشته‌ی خالی یعنی صفحه‌ی دیگری وجود ندارد.» رشته‌ی خالی مکان‌نمایی معتبر است. فقط نبودِ فیلد یا مقدار null به حلقه پایان می‌دهد.
  • «مکان‌نما را تجزیه (parse) کنید تا شماره‌ی صفحه محاسبه شود.» قالب مکان‌نما متعلق به سرور است و ممکن است امضاشده یا وضعیتی خصوصی در سرور باشد.
  • «مکان‌نمای جدید را با مکان‌نمای قبلی مقایسه کنید تا چرخه‌ی تکرار (loop) شناسایی شود.» کلاینت‌ها نباید مکان‌نماها را برای بررسی ترتیب با هم مقایسه کنند.

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

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