کیت توسعه ایجنت‌های Cursor معرفی شد؛ ساخت و مدیریت نسخه‌های هوش مصنوعی درست مانند کدنویسی

محیط توسعه هوش مصنوعی Cursor یک ابزار اختصاصی به نام Agent SDK منتشر کرده است که امکان ساخت ایجنت‌ها را با استفاده از فایل‌های Markdown و کدهای TypeScript تحت سیستم کنترل نسخه فراهم می‌کند. برنامه‌نویسان در این شیوه می‌توانند دستورالعمل‌ها، ابزارها، محرک‌های اجرایی و آزمون‌های سنجش را در مخزن کد پروژه تعریف کنند، درحالی‌که ساختار زیربنایی Cursor هدایت چرخه مدل، انتخاب اقدامات مناسب، فراخوانی ابزارها و پردازش نتایج را بر عهده دارد. به گفته Cursor، ربات‌های داخلی این شرکت نظیر Bugbot، سیستم بازبینی امنیتی و ربات تأیید کدها نیز بر پایه همین بستر توسعه یافته‌اند.

تبدیل ایجنت‌ها به پروژه‌های نرم‌افزاری دارای نسخه

در پروژه‌های مبتنی بر Agent SDK، تمام پرامپت‌ها، ابزارها، مهارت‌ها، ساب‌ایجنت‌ها، کانال‌های رویداد و تست‌های مربوط به ربات در یک پوشه مستقل ذخیره می‌شوند؛ بنابراین اعضای تیم می‌توانند درست مانند سایر بخش‌های نرم‌افزار، تغییرات ربات را بازبینی کرده و برای آن نسخه تعریف کنند. پرامپت سیستم درون فایلی به نام instructions.md نگهداری می‌شود، برای هر ابزار مشخص یک فایل مجزای TypeScript ایجاد خواهد شد و کانال‌های ارتباطی نیز می‌توانند بر اساس رویدادهایی نظیر پول‌ریکوئست‌ها، فرآیندهای CI، پیام‌های اسلک یا وب‌هوک‌ها، جلسات کاری ایجنت را فعال کنند.

اجرای دستور agent-sdk init پروژه‌ای با ساختار زیر ایجاد می‌کند:

my-bot/
├── bot/
│   ├── agent.ts            # model and harness configuration
│   ├── instructions.md     # system prompt
│   ├── tools/              # typed tools
│   ├── skills/             # procedures loaded on demand
│   ├── subagents/          # delegated workers
│   ├── channels/           # GitHub, Slack, and webhook triggers
│   └── hooks/              # session event observers
└── evals/                  # regression checks

یک پله بالاتر از پکیج @cursor/sdk

شرکت Cursor پکیج سطح پایین‌تری به نام @cursor/sdk را نیز برای زبان TypeScript ارائه می‌دهد که وظیفه آن برقراری ارتباط و فراخوانی ایجنت‌های مورد استفاده در محیط توسعه، رابط خط فرمان و نسخه وب است. در مقابل، ابزار Agent SDK ساختاری مدون و استاندارد به پروژه می‌بخشد و مدیریت نشست‌ها، چرخه پردازش مدل، محیط ایزوله (سندباکس)، فرآیند استقرار، تریگرها و ذخیره‌سازی داده‌های خروجی را کنترل می‌کند.

تیم‌های فنی می‌توانند ایجنت‌های خود را روی زیرساخت ابری Cursor مستقر کنند یا فرآیند اجرای آن‌ها را روی سرورها و سخت‌افزارهای اختصاصی خود پیش ببرند. این بستر نرم‌افزاری همچنین امکاناتی چون مسیریابی میان مدل‌ها، اتصال به پروتکل زمینه مدل (Model Context Protocol)، مدیریت امن کلیدها و متغیرهای حساس، و ارزیابی کیفیت را در اختیار توسعه‌دهندگان می‌گذارد. سازمان‌هایی که ملزم به رعایت قوانین حفظ داده در سرورهای محلی یا محدودیت خروج اطلاعات هستند، باید پیش از استفاده بررسی کنند که درخواست‌های مدل، خروجی ابزارها و فایل‌های ذخیره‌شده از چه مبادی و مقاصدی عبور می‌کنند.

قرارگیری آزمون‌های سنجش در کنار ربات

آزمون‌های سنجش عملکرد (Evals) و تست‌های واحد با زبان TypeScript نوشته می‌شوند و درون پوشه evals/ پروژه قرار می‌گیرند. تیم‌ها می‌توانند این ارزیابی‌ها را در خط لوله CI به اجرا بگذارند، رفتار ایجنت را پس از هرگونه تغییر در پرامپت یا ابزارها مقایسه کنند و در صورت عدم قبولی در آزمون‌ها، مانع انتشار نسخه جدید شوند. این ساختار سبب می‌شود تمام تغییرات ایجنت همانند کدهای اصلی برنامه از مراحل بررسی دقیق، تست‌های رگرسیون و امکان بازگشت سریع به نسخه‌های پایدار قبلی برخوردار شوند.

اولویت با جریان‌های کاری درون مخزن کد

قالب‌های آماده موجود در این پکیج، تمرکز ویژه‌ای بر وظایف تکراری تیم‌های مهندسی و عملیات نرم‌افزاری دارند:

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

راهنمای محصولات Cursor نقش هر بخش را مشخص کرده است: کارهای تک‌مرحله‌ای مبتنی بر پرامپت و تریگر به بخش اتوماسیون (Automations) سپرده می‌شوند، ایجنت‌های تعاملی درون محیط Cursor از طریق Grok Bot فعال هستند، و پروژه‌های نسخه‌بندی‌شده همراه با کدهای سفارشی، اتصالات خارجی، آزمون‌ها یا الزامات خاص استقرار به Agent SDK اختصاص دارند.

ضرورت مدیریت ریسک در رابط‌های آزمایشی

این بسته نرم‌افزاری پس از تغییر نام از @cursor/bdk اکنون با عنوان @grok/agent-sdk منتشر شده است. کیت زیربنایی TypeScript در Cursor همچنان در وضعیت بتای عمومی قرار دارد و مستندات آن تذکر می‌دهد که رابط‌های برنامه‌نویسی (API) ممکن است پیش از انتشار نسخه نهایی تغییر کنند؛ از این رو تیم‌هایی که از هم‌اکنون این ابزار را به کار می‌گیرند، باید شماره نسخه بسته‌ها را ثابت نگه دارند و پیش از به‌روزرسانی، تغییرات نسخه‌ها را بازبینی کنند.

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

ساختار پروژه و رابط خط فرمان برای محیط Node.js و زبان TypeScript طراحی شده است. تیم‌هایی که ابزارهای خود را به زبان پایتون می‌نویسند می‌توانند از کتابخانه‌های غیررسمی جامعه کاربری برای کیت سطح پایین بهره ببرند، اما Agent SDK هنوز ساختار پروژه بومی مشابهی را برای پایتون ارائه نمی‌دهد.

پیوند عملیات ایجنت‌ها با چرخه حیات نرم‌افزار

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