ایجنت‌های ابری Cursor حالا از ۵۰۰ مخزن کد پشتیبانی می‌کنند و ۵ برابر سریع‌تر اجرا می‌شوند

جدیدترین نسخه ایجنت‌های ابری Cursor سه قابلیت کلیدی را برای تیم‌هایی به ارمغان می‌آورد که ایجنت‌ها را خارج از محیط ویرایشگر اجرا می‌کنند: بوم‌های تعاملی قابل اشتراک‌گذاری، نسخه بتای عمومی Environments API، و محیط‌های چندمخزنی که تا ۵۰۰ مخزن کد را پشتیبانی می‌کنند و سرعت راه‌اندازی آن‌ها تقریباً ۵ برابر بیشتر شده است.

• خروجی قابل اشتراک‌گذاری: ایجنت‌های ابری می‌توانند داشبوردها و گزارش‌ها را در قالب لینک‌های تعاملی منتشر کنند.
• راه‌اندازی با کدنویسی و اسکریپت: توسعه‌دهندگان می‌توانند محیط‌های اجرایی ایجنت‌ها را از طریق یک API ایجاد، بررسی، به‌روزرسانی و حذف کنند.
• محیط‌های بزرگ‌تر: ایجنت‌ها می‌توانند روی صدها مخزن کد کار کنند؛ هرچند مستندات فعلی API همچنان سقف درخواست پایین‌تری را نشان می‌دهد.

بوم‌های تعاملی به ابزاری کاربردی برای تحویل کار تبدیل می‌شوند

قابلیت بوم (Canvas) که اوایل امسال معرفی شد، به ایجنت‌ها امکان می‌دهد رابط‌های کاربری پایدار مبتنی‌بر React را درون پنجره ایجنت‌ها (Agents Window) رندر کنند. این رابط‌ها می‌توانند شامل نمودارها، جدول‌ها، مقایسه تغییرات کد (Diffs)، منطق‌های سفارشی و کنترل‌هایی باشند که هم‌گام با فعالیت ایجنت به‌روزرسانی می‌شوند.

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

بوم‌های به اشتراک گذاشته‌شده می‌توانند به‌صورت تمام‌صفحه در مرورگر باز شوند و دکمه‌هایی متصل به پرامپت‌های مشخص داشته باشند. این ویژگی بوم‌ها را به ابزارهایی داخلی و سبک تبدیل می‌کند؛ چراکه همکاران می‌توانند یافته‌های ایجنت را بررسی کرده و از طریق همان رابط کاربری، اقدامات بعدی از پیش تعریف‌شده را اجرا کنند.

راه‌اندازی محیط‌های اجرایی مجهز به لایه مدیریتی (Control Plane) می‌شود

نسخه بتای عمومی Environments API کنترل برنامه‌نویسی‌شده روی پیکربندی‌های زمان اجرای ایجنت‌ها را به نسخه اول Cloud Agents API اضافه می‌کند. اکنون توسعه‌دهندگان می‌توانند هم ایجنت‌های در حال کار و هم محیط‌هایی را که ایجنت‌ها در آن‌ها شروع به کار می‌کنند، مدیریت کنند.

یک محیط در Cursor، مخازن کد و تنظیمات موجود در فایل environment.json را برای ایجنت مشخص می‌کند. این پیکربندی‌ها در گذشته تنها از طریق داشبورد ابری مدیریت می‌شدند. اندپوینت‌های جدید این محیط‌ها را به منابعی تبدیل می‌کنند که برنامه‌ها می‌توانند از طریق کد آن‌ها را ایجاد، مشاهده، به‌روزرسانی و حذف کنند.

این API فرآیندهای کاربردی متعددی را امکان‌پذیر می‌کند:

• ایجاد یک محیط ایزوله و مجزا برای هر تیکت یا حادثه فنی و حذف آن پس از پایان کار.
• ذخیره تعاریف محیط در یک مخزن کد زیرساختی و همگام‌سازی آن‌ها از طریق پایپلاین‌های CI.
• راه‌اندازی ایجنت‌ها از طریق وب‌هوک‌ها یا چرخه‌های پردازش، همراه با مجموعه‌ای مشخص از مخازن کد و تنظیمات زمان اجرا.
• ثبت تغییرات محیط در سیستم‌های نظارتی، تأییدی و بازگردانی (Rollback) موجود.
• استانداردسازی راه‌اندازی ایجنت‌ها میان تیم‌های مختلف بدون نیاز به تنظیم دستی از داشبورد.

پیاده‌سازی فرآیند با دو فراخوانی ساده در تایپ‌اسکریپت

import { Cursor } from "@cursor/sdk";

const apiKey = process.env.CURSOR_API_KEY;

if (!apiKey) {
  throw new Error("Missing CURSOR_API_KEY");
}

const cursor = new Cursor({ apiKey });

const environment = await cursor.environments.create({
  name: "payments-hotfix",
  repositories: [
    { url: "https://github.com/acme/api" },
    { url: "https://github.com/acme/web" },
    { url: "https://github.com/acme/infra" },
  ],
});

await cursor.agents.create({
  env: { id: environment.id },
  prompt:
    "Reproduce the 500 response on /checkout and open a pull request with a fix and regression test.",
});

این مثال بر اساس ساختار SDK تایپ‌اسکریپت نوشته شده است: ابتدا یک محیط اجرایی با قابلیت استفاده مجدد ایجاد می‌کند و سپس ایجنت را درون آن به کار می‌اندازد. در پیاده‌سازی‌های سطح عملیاتی (Production)، کلیدهای API باید روی سرور نگهداری شوند، شناسه‌های بازگردانده‌شده برای منابع ذخیره گردند و خطاهای احتمالی هنگام ساخت محیط یا شروع به کار ایجنت به درستی مدیریت شوند.

برچسب بتا نیز در مبحث خودکارسازی اهمیت بالایی دارد. تیم‌ها باید نسخه SDK را ثابت (Pin) نگه دارند، پاسخ‌های دریافتی از API را اعتبارسنجی کنند و فراخوانی‌های اختصاصی مربوط به Cursor را پشت یک لایه یکپارچه‌سازی سبک قرار دهند تا تغییرات احتمالی در ساختار داده‌ها (Schema) به چرخه‌های CI یا ابزارهای داخلی آسیب نزند.

پشتیبانی از ۵۰۰ مخزن کد و یک تناقض در مستندات

سرویس Cursor اکنون در هر محیط اجرایی از حداکثر ۵۰۰ مخزن کد پشتیبانی می‌کند. ایجنت‌های چندمخزنی قادرند در طول یک اجرا، وابستگی‌ها را بررسی کرده و تغییرات را در میان میکروسرویس‌ها، کتابخانه‌ها، کدهای زیرساخت و برنامه‌های کلاینت هماهنگ کنند.

علاوه‌بر این، طبق اعلام Cursor، محیط‌های بزرگ چندمخزنی حالا حدود ۵ برابر سریع‌تر راه‌اندازی می‌شوند. البته در این اطلاعیه جزئیات بنچمارک منتشر نشده است؛ بنابراین تیم‌هایی که از معماری‌های چندمخزنی (Polyrepo) گسترده استفاده می‌کنند، باید زمان راه‌اندازی را با توجه به حجم مخازن خود، نحوه نصب وابستگی‌ها و اسکریپت‌های اولیه بسنجند.

نکته جالب اینجاست که در مستندات مرجع فعلی API، آرایه مخازن کد در درخواست‌های ساخت ایجنت و ساخت محیط، همچنان روی ۳۰۰ مخزن محدود شده است. به همین دلیل ممکن است سقف اعلام‌شده ۵۰۰ مخزنی تا زمان به‌روزرسانی ساختار اعتبارسنجی درخواست‌ها، در برخی مسیرهای API در دسترس نباشد. بنابراین در پیاده‌سازی‌های سیستمی بهتر است سقف ۳۰۰ مخزن به‌عنوان حداکثر مقدار مستندشده در نظر گرفته شود و پیش از اتکای کامل به عدد ۵۰۰، آزمایش‌های لازم صورت گیرد.

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

کدام فرآیندهای کاری بیشترین بهره را می‌برند؟

مجموعه این تغییرات، بستری قابل اشتراک‌گذاری برای خروجی‌ها، لایه مدیریتیِ مبتنی‌بر اسکریپت برای زمان اجرا و ظرفیت کافی برای مدیریت پروژه‌های بزرگ چندمخزنی را در اختیار ایجنت‌های ابری می‌گذارد. طبق گفته سازندگان Cursor، ایجنت‌های خودکار ابری اکنون بیش از ۳۵ درصد از پول‌ریکوئست‌های ادغام‌شده توسط تیم مهندسی این شرکت را ایجاد می‌کنند؛ رقمی که نسبت به آمار ۳۰ درصدی زمان معرفی این قابلیت در ماه فوریه، رشد قابل‌توجهی نشان می‌دهد. البته این آمار نشان‌دهنده چرخه کاری و نوع وظایف درون‌سازمانی خود Cursor است.

این به‌روزرسانی به‌طور ویژه برای جریان‌های کاری کاربرد دارد که میان افراد، سیستم‌ها یا مخازن مختلف کد در جریان هستند:

• ایجنت‌های تریاژ شبانه که داشبوردی تعاملی برای بررسی وضعیت توسط تیم مهندسی منتشر می‌کنند.
• ایجنت‌های پاسخ به حوادث فنی که چند سرویس وابسته به یکدیگر را عیب‌یابی و پچ می‌کنند.
• ایجنت‌های مهاجرت که تغییرات در API، کلاینت، زیرساخت و مستندات را به‌طور هماهنگ پیش می‌برند.
• پایپلاین‌های مبتنی‌بر SDK که وظایف بازآفرینی کد (Refactor) را به‌صورت موازی و در محیط‌هایی کاملاً ایزوله اجرا می‌کنند.
• وظایف انطباق و نظارت قانونی که یافته‌ها را درون یک بوم قابل بررسی جمع‌آوری کرده و متادیتای اجرا را نگهداری می‌کنند.

کارهای تک‌مخزنی که توسط یک توسعه‌دهنده به‌تنهایی اجرا می‌شوند، بهره عملیاتی کمتری از این تغییرات خواهند برد. مزیت اصلی به تیم‌هایی می‌رسد که به ایجنت‌ها به‌عنوان یک زیرساخت مشترک نگاه می‌کنند؛ زیرساختی که باید تخصیص داده شود، تحت نظارت و حسابرسی قرار گیرد، با CI یکپارچه شود و خروجی‌های آن در قالبی ماندگار تحویل داده شوند.

راهکارهای امنیتی و حفاظتی برای محیط‌های عملیاتی

خودکارسازی فرایند ساخت محیط، دسترسی ایجنت به سیستم‌های مختلف را افزایش می‌دهد و سرعت انتشار پیکربندی‌ها را بیشتر می‌کند. پیاده‌سازی این سیستم در محیط عملیاتی باید با سازوکارهای کنترلی برای مدیریت دسترسی‌ها و اعتبارسنجی‌ها، دسترسی به مخازن، تغییرات ایجادشده در کد و عملکردهای تعاملی روی بوم‌ها همراه باشد.

• اختصاص حداقل سطح دسترسی به مخازن و سرویس‌ها برای هر محیط، متناسب با وظیفه محول‌شده.
• تفکیک اطلاعات هویتی و اعتباری محیط‌های عملیاتی از محیط‌های توسعه و پاسخ به حوادث.
• نسخه‌بندی فایل‌های environment.json و الزام به بازبینی برای هرگونه تغییر در اسکریپت‌های راه‌اندازی یا اطلاعات حساس (Secrets).
• ثبت شناسه‌های محیط، شناسه‌های اجرای ایجنت، کامیت‌ها، پول‌ریکوئست‌ها و هویت کاربران آغازکننده فرایند در گزارش‌های نظارتی (Audit Logs).
• بررسی دقیق بوم‌های به اشتراک گذاشته‌شده از نظر وجود اطلاعات حساس و محدود کردن دکمه‌های متصل به پرامپت به اقدامات تأییدشده.
• اعمال محدودیت تعداد مخازن کد در سمت کلاینت تا زمانی که اختلاف و تناقض بین اعداد ۳۰۰ و ۵۰۰ در مستندات رسمی Cursor برطرف شود.