معرفی Agent SDK توسط Cursor؛ ساخت و مدیریت ایجنت‌های نرم‌افزاری با کد

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

تیم Cursor ابزار Agent SDK را معرفی کرده است؛ همان فریم‌ورکی که خود آن‌ها برای ساخت ایجنت‌های مدیریت‌شده‌ای مانند Bugbot و Security Reviewer استفاده می‌کنند. این SDK به مهندسان اجازه می‌دهد تا ایجنت‌ها را به صورت کد تعریف کرده و دقیقاً مانند هر پروژه نرم‌افزاری دیگری مدیریت کنند.

معماری و جزئیات فنی

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

• پرامپت‌ها: به زبان Markdown نوشته می‌شوند.
• ابزارها: به شکل توابع TypeScript تعریف می‌شوند.
• کنترل نسخه: از آنجا که همeth چیز به صورت کد است، تغییرات می‌توانند از طریق کنترل نسخه و فرآیندهای مرسوم Code Review عبور کنند.

برای شروع کار، کافی است یک دایرکتوری پروژه ایجاد کرده و پلی‌گراند محلی را راه‌اندازی کنید. نمونه کد زیر نحوه تعریف پایه یک ایجنت را نشان می‌دهد:

import { homedir } from "node:os";
import { join } from "node:path";
import { defineAgent } from "@cursor/agent-sdk";

export default defineAgent({
  name: "Robo",
  model: {
    id: "composer-2.5",
    params: [
      { id: "effort", value: "high" },
      { id: "fast", value: "true" },
    ],
  },
  local: {
    cwd: join(homedir(), ".cache", "factory", "robo"),
  },
})

قابلیت‌های کلیدی

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

استقرار (Deployment)

پس از آماده‌سازی ایجنت، می‌توانید با اجرای دستور agent-sdk deploy در دایرکتوری پروژه، آن را روی زیرساخت Cursor مستقر کنید. این دستور ایجنت را بیلد کرده، یک URL به آن اختصاص می‌دهد و روی پلتفرم اجرا می‌کند. همچنین امکان مدیریت توکن‌ها و رازها (Secrets) از طریق داشبورد فراهم است.

علاوه بر این، شما محدودیتی ندارید و می‌توانید ایجنت را روی زیرساخت خودتان نیز اجرا کنید؛ چرا که هر ایجنت به عنوان یک پردازش ساده Node اجرا شده و در قالب کانتینر قابل بسته‌بندی است.

نگاه جامعه هکرنیوز

انتشار این ابزار در Hacker News با نظرات متفاوتی روبرو شد. برخی کاربران از شتاب بالای اکوسیستم ابزارهای هوش مصنوعی و شباهت آن به چرخه‌های پرالتهاب اکوسیستم جاوا اسکریپت ابراز نگرانی کردند که در آن ابزارهای جدید به سرعت معرفی می‌شوند. عده‌ای دیگر به نام‌گذاری‌های مشابه شرکت‌های مختلف (مانند OpenAI، Anthropic و Vercel) اشاره کرده و ابراز امیدواری کردند که استانداردهای بازتری مانند OpenResponses شکل بگیرد تا توسعه‌دهندگان مجبور به وابستگی به یک ارائه‌دهنده خاص نشوند.