Cursor ra mắt Agent SDK: Xây dựng và triển khai AI agent như một dự án phần mềm

Cursor vừa chính thức phát hành Agent SDK, bộ framework mà chính đội ngũ của họ sử dụng để xây dựng các agent quản lý như Bugbot, Security Reviewer và Rollouts. Điểm đáng chú ý là công cụ này cho phép lập trình viên định nghĩa agent bằng code và quản lý chúng giống như bất kỳ dự án phần mềm nào khác.

Xây dựng agent theo đúng quy trình của đội ngũ

Theo Cursor, các agent hữu ích nhất là những agent được thiết kế riêng cho cách vận hành của từng nhóm. Trước đây, muốn có một agent như vậy, đội ngũ thường phải chấp nhận một sản phẩm được xây dựng quanh quy trình của người khác, hoặc phải làm lại từ đầu.

Với Agent SDK, mọi thứ thay đổi. Các agent có thể phản hồi những sự kiện mà đội ngũ vốn đã xử lý hằng ngày và tuân theo các chính sách mà họ có thể kiểm tra, chỉnh sửa. Ví dụ điển hình là quy trình review code: mỗi nhóm có tiêu chuẩn riêng về việc thay đổi nào cần chú ý và ai nên review. Agent xây dựng bằng SDK có thể phản hồi sự kiện pull request từ GitHub, GitLab hay Bitbucket, đánh giá rủi ro của thay đổi, chuyển đến đúng nhóm phụ trách và tự động phê duyệt những thay đổi đáp ứng chính sách.

Một đội ngũ nội bộ của Cursor đã tận dụng điều này để tạo ra kb-reviewer chỉ trong khoảng một ngày. Công cụ này kiểm tra mọi PR dựa trên kho kiến thức khổng lồ về các bài học kinh nghiệm của nhóm, cảnh báo những thay đổi đi ngược lại quyết định đã ghi nhận, kèm theo trích dẫn nguồn cụ thể.

"Agent SDK đã giúp PGA xây dựng mọi thành phần của nhà máy phần mềm trên hạ tầng của Cursor. Nó mang lại sự linh hoạt cần thiết để tạo ra các agent vận hành quy trình phát triển của chúng tôi." — Michael Gyarmathy, Kỹ sư chính tại PGA America

Định nghĩa mọi thứ bằng code

Một agent trong Agent SDK được tổ chức như một dự án phần mềm thu nhỏ. Các chỉ dẫn hướng dẫn agent nằm cạnh code của công cụ, kết nối tới dịch vụ bên ngoài và các bài eval dùng để kiểm thử.

• Prompt được viết bằng Markdown
• Tool được định nghĩa dưới dạng hàm TypeScript
• Mọi thay đổi đều có thể đi qua quy trình quản lý phiên bản và review như phần mềm thông thường

Với tác vụ phức tạp, agent có thể chuyển giao nhiệm vụ cho một agent chuyên biệt khác, hoặc chia việc cho các subagent chạy song song. SDK cũng hỗ trợ sẵn eval và phát lại sự kiện (event replay), giúp các nhóm phát triển nhanh mà vẫn đảm bảo các quy trình quan trọng chạy đúng như mong đợi.

Triển khai linh hoạt

Khi agent đã sẵn sàng, chỉ cần chạy lệnh agent-sdk deploy trong thư mục dự án. Lệnh này sẽ build agent, cấp cho nó một URL và khởi chạy trên hạ tầng của Cursor. Người dùng có thể quản lý secret và tích hợp từ dashboard, trong khi vẫn dùng được log, eval và playground như khi chạy cục bộ.

Ngoài ra, agent cũng có thể chạy trên hạ tầng riêng. Mỗi agent hoạt động như một tiến trình Node đơn lẻ và có thể đóng gói trong container — một lựa chọn hấp dẫn cho các doanh nghiệp Việt Nam có yêu cầu khắt khe về bảo mật dữ liệu và chủ quyền hạ tầng.

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"),
  },
})

Bối cảnh cho lập trình viên Việt Nam

Việc các nền tảng như Cursor mở SDK cho cộng đồng là tín hiệu đáng chú ý với các đội phát triển phần mềm trong nước. Thay vì phụ thuộc vào các sản phẩm đóng được thiết kế cho quy trình nước ngoài, các công ty Việt Nam có thể xây dựng agent riêng phù hợp với quy trình làm việc, tiêu chuẩn review code và chính sách bảo mật nội bộ.

Tuy nhiên, cần lưu ý rằng mô hình composer-2.5 trong ví dụ trên là mô hình của Cursor, nghĩa là vẫn có sự phụ thuộc nhất định vào nhà cung cấp. Các đội ngũ nên cân nhắc kỹ giữa tính tiện lợi và mức độ kiểm soát hạ tầng của mình.

Agent SDK hiện đã chính thức khả dụng (generally available). Lập trình viên có thể bắt đầu bằng cách tạo thư mục dự án, khởi chạy playground cục bộ, lặp lại quá trình phát triển và chạy eval trước khi triển khai chính thức.