Cursor Agent SDK 출시: 에이전트를 코드로 정의하고 한 줄로 배포

Who Should Read

PR 리뷰나 인시던트 조사 같은 반복 업무를 팀 규칙에 맞는 에이전트로 자동화하려는 백엔드 개발자

Core Mechanics

• 에이전트를 소프트웨어 프로젝트처럼 만든다
  • 프롬프트는 Markdown, 도구는 TypeScript 함수로 작성한다.
  • 도구, 외부 서비스 연결, 테스트용 evals(평가)가 한 프로젝트에 함께 들어간다.
  • 전부 코드라서 기존 버전 관리와 리뷰 절차를 그대로 쓴다.
• agent-sdk deploy 한 번으로 배포된다
  • 프로젝트 디렉터리에서 실행하면 빌드하고 URL을 주고 Cursor 인프라에서 시작한다.
  • 시크릿과 연동은 대시보드에서 관리하고, 로그·evals·playground는 로컬과 같은 것을 쓴다.
  • 자체 인프라에서도 돌릴 수 있고, 에이전트 하나가 Node 프로세스 하나라서 컨테이너로 패키징할 수 있다.
• 이벤트에 반응하는 에이전트를 만든다
  • GitHub, GitLab, Bitbucket의 PR 이벤트에 반응하게 할 수 있다.
  • 변경의 위험도를 평가하고 맞는 팀에 라우팅하며 정책을 충족하면 승인할 수 있다.
• kb-reviewer를 하루 만에 만들었다
  • Cursor 내부 팀이 교훈을 모아 둔 지식베이스를 PR마다 대조하는 에이전트를 약 하루에 만들었다.
  • 지금은 메인 코드베이스의 모든 PR에서 돌며 기록된 교훈과 어긋나는 변경을 표시한다.
  • 지적마다 근거 노트를 인용하고 엔지니어에게 불일치를 해소하라고 안내한다.
• 서브에이전트와 evals, 이벤트 리플레이를 지원한다
  • 복잡한 작업은 도구와 세션이 따로 있는 전문 에이전트에 넘기거나 서브에이전트로 병렬 분할할 수 있다.
  • evals와 event replay가 기본 제공된다.
  • PGA Tour가 이를 이용해 소프트웨어 개발 팩토리를 만든다.
• Cursor 자체 에이전트의 기반이다
  • Bugbot, Security Reviewer, Rollouts 같은 Cursor의 관리형 에이전트를 만든 프레임워크다.
  • 오늘부터 정식 출시(GA)다.
  • 코딩 에이전트를 안내하는 skills도 함께 제공되며 문서를 보여 주고 같이 만들게 할 수 있다.

Community Reactions

• AI 도구가 JS 프레임워크처럼 난립하고 있다는 의견
  • 매일 새 도구가 나오고 지난주 도구가 deprecated된다는 댓글이 여럿이었다.
  • 에이전트 하네스(harness)가 2026년에 계속 재발명되는 바퀴라는 의견도 있었다.
• 벤더 종속과 이름 겹침을 걱정하는 의견
  • OpenAI와 Anthropic이 이미 Agent SDK 브랜드를 쓰고 Vercel은 AI SDK라서 이름이 헷갈린다는 댓글이 있었다.
  • openresponses.org 같은 표준이 나와 앱이 특정 벤더에 묶이지 않기를 바란다는 의견이 있었다.
• 왜 이걸 써야 하는지 묻는 반응
  • 오픈소스 하네스나 Anthropic SDK 대신 쓸 이유가 뭐냐는 질문이 있었다.
  • 에이전트 SDK는 PROMPT.md와 도구 실행 런타임이면 충분하지 않느냐는 질문도 있었다.
  • 이 댓글은 langchain식 추상화가 필요한 이유를 일정한 결정성 확보 때문인지 물었다.
• 대안 경험과 기존 SDK 언급
  • 서버에 상주하는 에이전트에는 Vercel의 Eve를 써 보니 좋았다는 경험이 있었다.
  • 기존 Cursor TypeScript SDK 글이 따로 있다는 댓글도 있었다.
  • 영상에 아직 @grok/agent-sdk가 보인다는 지적이 있었다.

How to Apply

• 오늘 반복 업무 하나를 에이전트 후보로 정리하기
  • 30분 안에 PR 리뷰, 컴플라이언스 확인, 인시던트 조사 중 하나를 골라 트리거 이벤트, 입력, 기대 결과를 한 장으로 적는다.
  • 아래 코드의 프롬프트를 코딩 에이전트에 붙여넣어 프로젝트 구조 초안을 받는다.
• 팀 지식베이스를 PR 검사에 연결하기
  • 과거 결정이나 교훈 노트가 있으면 kb-reviewer처럼 PR과 대조해 모순을 지적하게 설계한다.
  • 지적마다 근거 노트를 인용하도록 프롬프트에 명시한다.
• 배포 전에 evals를 먼저 만들기
  • 핵심 워크플로마다 기대 결과를 evals로 작성해 로컬에서 먼저 돌린다.
  • 통과한 뒤 agent-sdk deploy로 배포한다.
• 배포 위치를 먼저 정하기
  • Cursor 인프라에 올릴지 자체 인프라에서 돌릴지 정한다.
  • 자체 운영이면 에이전트를 Node 프로세스 하나로 컨테이너에 패키징한다.

Try It

// Claude Code 또는 Cursor 같은 코딩 에이전트에 붙여넣기 (Agent SDK 문서를 읽게 하는 프롬프트)

아래 코드는 Cursor Agent SDK의 기본 에이전트 정의다.

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

# 지시
https://cursor.com/blog/agent-sdk 와 공식 문서를 먼저 읽어라.
그다음 {{트리거 이벤트, 예: GitHub PR 생성}} 때 {{하려는 일, 예: 지식베이스와 모순되는 변경 표시}}를 하는 에이전트 프로젝트 구조를 제안해라.
프롬프트는 Markdown, 도구는 TypeScript 함수, 테스트는 evals로 나눠라.
문서에 없는 API는 지어내지 말고 모르면 모른다고 써라.

# 이어서 해 볼 것
로컬 playground에서 돌려 보고 evals를 통과하면 agent-sdk deploy를 실행한다.

Terminology

관련 논문

• 에이전트가 코드를 짜는 시대, 엔지니어가 여전히 알아야 할 것: 기초·폭넓은 지식·필요할 때 깊이 파기

  에이전트가 짠 코드의 오너십은 기초, 폭넓은 지식, 즉시 깊이 파는 능력에 달렸다

• AI가 일을 줄여준다더니, 이렇게 많이 일한 적이 없다

  에이전트를 병렬로 돌렸더니 GitHub 활동이 엔지니어 시절 수준으로 돌아왔다

• Corgi: 사람과 에이전트를 위한 터미널 멀티플렉서

  여러 AI 에이전트의 상태를 한눈에 보는 tmux류 터미널 도구

• 모델이 그렇게 좋다면 OpenAI는 왜 회사 100개를 직접 안 차릴까

  HN 댓글 답: 코드는 쉬워도 뭘 만들지 아는 건 별개라 토큰을 판다

• OpenShell: 자율 AI 에이전트를 가두는 NVIDIA의 안전한 샌드박스 런타임

  정책 파일로 에이전트의 파일·네트워크·자격증명 접근을 커널 수준에서 통제한다

• Omnara: Claude Managed Agents의 오픈소스 대안 (셀프호스팅 가능)

  어떤 모델·머신에서도 에이전트를 돌리는 오픈소스 managed agent 플랫폼

• Rust off Rails: 코드 없이 Markdown 60개로 만든 AI 에이전트용 웹 스택

  Markdown 규칙 60개로 에이전트가 Rust 웹앱을 짜게 한다는 프레임워크

• LayerFS: AI 코딩 에이전트를 위한 파일시스템

  에이전트마다 임시 Workspace를 마운트하고 결과만 커밋하는 파일시스템

Related Resources

• https://cursor.com/blog/agent-sdk
• https://cursor.com/blog/typescript-sdk
• https://www.openresponses.org/