소프트웨어 팀은 코드로 정의한 에이전트를 활용해 개발 수명 주기 전반의 반복 작업을 처리합니다. 이러한 에이전트는 팀이 일하는 곳에 연결되어 있다가 관련 이벤트가 발생하면 pull request 검토, 규정 준수 워크플로우 실행, 장애 조사 등 필요한 작업을 수행합니다.

가장 유용한 에이전트는 각 팀의 업무 방식에 꼭 맞는 에이전트입니다. 하지만 지금까지 이런 에이전트를 만들려면 대개 다른 팀의 워크플로우를 기준으로 설계된 제품을 도입하거나 처음부터 직접 만들어야 했습니다.

오늘 Cursor는 Bugbot, 보안 리뷰어, Rollouts 같은 자체 관리형 에이전트를 만들 때 사용하는 프레임워크인 Agent SDK를 출시합니다. Agent SDK를 사용하면 에이전트를 코드로 정의하고 일반 소프트웨어 프로젝트처럼 관리할 수 있습니다. 템플릿으로 시작하거나 코딩 에이전트에게 문서를 참고하도록 하세요. 에이전트가 준비되면 agent-sdk deploy 명령어 하나로 Cursor 인프라에 배포할 수 있습니다.

#워크플로우에 맞춰 구축하기

Agent SDK를 사용하면 팀의 업무 방식대로 동작하는 에이전트를 빠르게 만들고 배포할 수 있습니다. 이 에이전트는 팀이 이미 처리하고 있는 이벤트에 응답하고, 팀이 직접 검사하고 변경할 수 있는 정책을 따릅니다.

코드 검토가 대표적인 예시입니다. 팀마다 무엇을 주의 깊게 봐야 하는지, 누가 검토해야 하는지에 대한 고유한 기준이 있습니다. Agent SDK를 사용하면 GitHub, GitLab, Bitbucket의 pull request 이벤트에 응답하는 에이전트를 만들 수 있습니다. 이 에이전트는 변경 사항의 위험도를 평가하고, 적절한 팀에 할당하며, 정책을 충족하는 변경 사항을 승인할 수 있습니다.

예를 들어, Cursor 내부의 한 팀은 그동안 학습한 교훈을 담은 지식 베이스를 구축해 왔는데, 규모가 크고 빠르게 늘어나고 있었습니다. 이 팀은 모든 pull request를 이 지식 베이스와 대조해 확인하고 싶었습니다. 그래야 코드베이스가 바뀌더라도 팀의 과거 결정이 지켜질 수 있기 때문입니다. 이 팀은 Agent SDK로 약 하루 만에 kb-reviewer를 만들었습니다. kb-reviewer는 현재 주요 코드베이스의 모든 PR에서 실행되며, 기록된 교훈과 상충하는 변경 사항을 표시하고, 각 발견 사항의 근거가 되는 노트를 인용하며, 보고된 불일치를 엔지니어가 해소하도록 유도합니다.

더 복잡한 작업이라면 에이전트가 자체 도구와 세션을 갖춘 다른 특화된 에이전트에게 작업을 넘길 수 있습니다. 또한 하나의 작업을 여러 하위 에이전트에게 나누어 병렬로 처리할 수도 있습니다.

Agent SDK는 평가와 이벤트 재생도 기본으로 지원하므로, 중요한 워크플로가 예상대로 실행된다는 확신을 가지고 빠르게 개발할 수 있습니다. PGA Tour는 Agent SDK로 소프트웨어 개발 팩토리를 운영하고 있으며, 평가 덕분에 빠른 개발 속도를 유지하고 있습니다.

#모든 것을 코드로 정의하기

Agent SDK 에이전트는 작은 소프트웨어 프로젝트처럼 구성됩니다. 에이전트를 안내하는 지침이 도구 코드, 외부 서비스 연결, 에이전트 테스트에 사용하는 평가와 한곳에 함께 놓입니다.

각 파일은 에이전트가 알고 있는 것이나 할 수 있는 일을 나타냅니다. 프롬프트는 마크다운으로 작성하고, 도구는 TypeScript 함수로 정의합니다. 모든 것이 코드이므로 변경 사항도 다른 소프트웨어와 똑같이 버전 관리와 검토 과정을 거칠 수 있습니다.

#필요한 곳 어디에나 에이전트 배포하기

에이전트를 실제로 사용할 준비가 되면 프로젝트 디렉터리에서 agent-sdk deploy를 실행해 Cursor에 배포할 수 있습니다. 이 명령어는 에이전트를 빌드하고 URL을 부여한 뒤 Cursor 인프라에서 실행합니다. 시크릿과 연동은 대시보드에서 관리할 수 있으며, 로컬에서 쓰던 로그, 평가, 플레이그라운드도 그대로 사용할 수 있습니다.

자체 인프라에서 에이전트를 실행할 수도 있습니다. 각 에이전트는 단일 Node 프로세스로 실행되며, 컨테이너로 패키징할 수 있습니다.

#시작하기

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

이후 로컬에서 반복적으로 개선하고 평가를 실행한 다음 agent-sdk deploy로 배포하면 됩니다.

Agent SDK에는 코딩 에이전트가 개발 과정을 따라갈 수 있도록 안내하는 스킬도 함께 제공됩니다. 에이전트에게 문서를 참고하도록 지시해 봇을 함께 만들어 보세요.

Agent SDK는 오늘부터 정식 출시되었습니다. 문서를 읽고 바로 시작해 보세요.