Cursor가 사내 에이전트를 만든 Agent SDK를 전면 공개

Cursor가 자체 관리형 에이전트를 만드는 데 실제로 사용해 온 프레임워크인 Agent SDK를 일반에 공개했다. 핵심은 에이전트를 별도 제품 설정 화면이 아니라 하나의 소프트웨어 프로젝트처럼 다루게 한다는 점이다. 정의부터 배포, 테스트까지 익숙한 코드 저장소 흐름 안에서 끝난다.

에이전트의 구성물은 파일 단위로 쪼개진다. 행동 지침은 Markdown 프롬프트로, 도구는 TypeScript 함수로 작성하고, 외부 서비스 연결 설정과 테스트용 평가 세트가 같은 디렉터리에 나란히 놓인다. 결과적으로 프롬프트 수정도 코드 변경과 동일하게 버전 관리와 리뷰를 거치게 된다.

배포는 프로젝트 디렉터리에서 `agent-sdk deploy`를 실행하는 것으로 끝난다. 빌드와 함께 접근 가능한 URL이 부여되고 Cursor 인프라 위에서 구동되며, 시크릿과 외부 연동은 대시보드에서 관리한다. 로컬에서 쓰던 로그, 평가, 플레이그라운드는 배포 후에도 그대로 이어진다. 자체 인프라를 고집하는 팀은 컨테이너로 패키징해 단일 Node 프로세스로 돌릴 수도 있다.

동작 방식은 이벤트 중심이다. 팀이 이미 쓰는 도구에서 발생하는 사건에 반응하도록 붙일 수 있고, 대표적인 예가 GitHub, GitLab, Bitbucket의 풀 리퀘스트 이벤트다. 에이전트는 변경의 위험도를 따져 적절한 팀으로 넘기거나, 사내 정책을 만족하는 변경을 승인하는 식으로 관여한다.

가장 눈에 띄는 사례는 Cursor 내부 팀이 만든 kb-reviewer다. 이 팀은 그동안 쌓아 온 교훈 노트가 빠르게 늘어나자 모든 풀 리퀘스트를 그 노트와 대조하고 싶어 했고, Agent SDK로 약 하루 만에 이를 구현했다. 지금은 메인 코드베이스의 모든 PR에서 돌면서 기록된 교훈과 어긋나는 변경을 표시하고, 판단 근거가 된 노트를 함께 인용한다.

작업이 복잡해지면 구조를 나눌 수 있다. 자체 도구와 세션을 가진 전문 에이전트에게 특정 작업을 넘기거나, 여러 서브 에이전트에 일을 분할해 병렬로 처리하게 할 수 있다. 하나의 거대한 프롬프트로 밀어붙이는 대신 역할을 쪼개는 설계가 SDK 차원에서 지원되는 셈이다.

평가와 이벤트 재생이 기본 제공된다는 점도 실무적으로 크다. 동일한 입력을 다시 흘려 결과를 재현해 볼 수 있어, 워크플로가 의도대로 도는지 확인하면서 빠르게 반복 개발할 수 있다. PGA Tour는 이 SDK로 자사의 소프트웨어 개발 공정을 구성하고 있으며, 내장된 평가 기능을 새 아이디어 검증과 기존 기능 최적화에 활용하고 있다고 전했다.

개발자 입장에서 달라지는 것은 선택지다. 지금까지는 남이 설계한 워크플로에 맞춰 제품을 도입하거나, 아니면 밑바닥부터 직접 만들어야 했다. Agent SDK는 그 사이에 서서 사내 규칙과 이벤트, 리뷰 문화를 코드로 옮겨 담는 길을 제공한다. 정책을 감사하고 고칠 수 있는 형태로 유지한다는 점이 차별점이다.

전제도 분명하다. 에이전트는 단일 Node 프로세스로 실행되는 구조이고, 도구는 TypeScript로 작성해야 한다. 또 좋은 에이전트는 팀 운영 방식에 맞춰 조정될 때 유용해진다는 관점이 깔려 있어, 범용 봇 하나로 모든 팀을 커버하는 접근과는 거리가 있다. 시작은 템플릿이나 문서를 참조하는 방식이며, 코딩 에이전트가 개발 과정을 안내하도록 돕는 스킬도 함께 제공된다.