· Changelog

Changelog

Cursor SDK로 프로그래밍 방식의 에이전트 만들기

Cursor를 구동하는 동일한 런타임, 하네스, 모델로 에이전트를 만들 수 있도록 Cursor SDK를 소개합니다.

Cursor 데스크톱 앱, CLI, 웹 앱에서 실행되는 에이전트를 이제 몇 줄의 TypeScript만으로 사용할 수 있습니다. 로컬 머신에서 실행하거나, 전용 VM이 있는 Cursor 클라우드에서 어떤 프런티어 모델로든 실행할 수 있습니다.

시작하려면 npm install @cursor/sdk를 실행한 뒤 Cursor가 개발을 도와줄 수 있도록 Cursor SDK plugin을 사용하세요.

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

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "composer-2" },
  local: { cwd: process.cwd() },
});

const run = await agent.send("Summarize what this repository does");

for await (const event of run.stream()) {
  console.log(event);
}

몇 가지 샘플 프로젝트를 만들었으며, 공개 repo에서 확인할 수 있습니다. 포크한 뒤 각자의 사용 사례에 맞게 확장해 보세요.

Cursor SDK는 이제 모든 사용자가 공개 베타로 이용할 수 있으며, 표준 토큰 기반 사용량 요금제에 따라 과금됩니다. 자세한 내용은 공지사항과 문서에서 확인하세요.

  • 후속 작업, 상태, 스트리밍, 취소가 이제 모두 실행 단위로 관리되도록, 지속형 에이전트와 프롬프트별 실행을 중심으로 API를 개편했습니다.
  • SSE 이벤트 기반의 실행 스트리밍을 정식 지원하고, Last-Event-ID를 통한 재연결 지원과 더 명확한 종료 상태를 추가했습니다.
  • 보관, 보관 해제, 영구 삭제를 포함한 명시적인 에이전트 수명 주기 제어를 추가했습니다.
  • 구조화된 오류 코드, items 목록 응답, 분리된 agent / run 객체를 포함해 v1 응답 및 오류 형식을 표준화했습니다.