انتشار نسخه جدید Agents SDK با پشتیبانی از ارتباط RPC داخلی و بهبودهای امنیتی
در تازهترین بهروزرسانی Agents SDK، قابلیتهای جدیدی برای تعریف و اتصال Agent و McpAgent در یک Worker به صورت داخلی و بدون نیاز به HTTP معرفی شده است. این اتصال از طریق RPC و با استفاده از Durable Object binding انجام میشود که باعث حذف سربار شبکه و افزایش کارایی میشود. این ویژگی به توسعهدهندگان امکان میدهد تا ارتباطات بین Agent و McpAgent را به صورت مستقیم و درون محیط اجرایی Cloudflare برقرار کنند، بدون نیاز به ارسال درخواستهای HTTP و پردازشهای اضافی.
یکی از مهمترین تغییرات این نسخه، امکان ارسال namespace مربوط به Durable Object به متد addMcpServer است که اکنون علاوه بر آدرس HTTP، میتواند یک DurableObjectNamespace را به عنوان پارامتر دوم دریافت کند. این قابلیت با پشتیبانی کامل از TypeScript ارائه شده است تا مسیرهای HTTP و RPC به صورت ایمن و بدون تداخل قابل استفاده باشند.
از جمله ویژگیهای کلیدی این اتصال RPC میتوان به پشتیبانی از حالت Hibernation اشاره کرد که باعث میشود ارتباطات RPC حتی در زمان خوابیدن Durable Object حفظ شده و پس از بیدار شدن به صورت خودکار بازیابی شوند. همچنین، مکانیزم Deduplication در این متد تضمین میکند که در صورت فراخوانی مجدد با همان نام سرور، اتصال قبلی بازگردانده شده و از ایجاد اتصالات تکراری جلوگیری میشود. علاوه بر این، کدهای داخلی مربوط به RPC transport به طور قابل توجهی بهینه شده و از ۶۰۹ خط به ۲۴۵ خط کاهش یافته است که نشاندهنده بهبود ساختار و کاهش پیچیدگی است.
در زمینه امنیت، متد addMcpServer اکنون به صورت پیشفرض OAuth را برای همه اتصالات فعال نمیکند و این امکان را فراهم میآورد که برای سرورهایی که نیاز به احراز هویت ندارند، بدون پیکربندی OAuth به سادگی اتصال برقرار شود. در صورتی که سرور پاسخ ۴۰۱ ارسال کند، SDK خطای واضحی مبنی بر نیاز به احراز هویت OAuth نمایش میدهد و راهنمایی لازم برای فعالسازی این فرآیند ارائه میشود.
از سوی دیگر، مبدل JSON Schema به TypeScript نیز در این نسخه بهبود یافته است. این مبدل اکنون قادر است موارد پیچیده و لبهای مانند ارجاعات دایرهای، عمق زیاد، پشتیبانی از Tuple و ویژگیهای OpenAPI ۳.۰ را به درستی مدیریت کند. همچنین، خطاهای مربوط به ورودیهای ناقص یا نادرست به صورت ایزوله شده پردازش میشوند تا از توقف کل فرآیند جلوگیری شود.
در بخش @cloudflare/ai-chat نیز اصلاحات متعددی انجام شده است. از جمله این اصلاحات میتوان به بهبود جریان رد ابزارها، پشتیبانی از لغو درخواستها در پاسخهای استریم، جلوگیری از ثبت پیامهای تکراری، و بهبود مدیریت پیامها اشاره کرد. همچنین، APIهای مربوط به ابزارهای کلاینت دوباره فعال شدهاند تا توسعهدهندگان بتوانند ابزارهای خود را به صورت داینامیک در زمان اجرا تعریف کنند.
برای ارتقاء به این نسخه جدید کافی است از دستور npm i agents@latest @cloudflare/ai-chat@latest استفاده شود. این بهروزرسانی به توسعهدهندگان امکان میدهد تا از امکانات جدید ارتباط داخلی RPC بهرهمند شده و امنیت و پایداری پروژههای خود را افزایش دهند.
به طور کلی، این نسخه جدید Agents SDK با تمرکز بر بهبود کارایی، امنیت و قابلیت اطمینان، گام مهمی در جهت تسهیل توسعه برنامههای مبتنی بر Cloudflare برداشته است و نویدبخش تجربهای بهتر برای توسعهدهندگان در مدیریت Agentها و ارتباطات MCP است.