Agent SDK

이제 Agent SDK를 사용할 수 있습니다. Agent SDK로 에이전트를 코드 폴더 형태로 정의하고, 평가로 테스트한 뒤, Cursor나 자체 인프라에 배포할 수 있습니다.

npx @cursor/agent-sdk init ./my-bot을 실행한 다음 agent-sdk dev를 실행하면 플레이그라운드에서 봇을 로컬로 시작할 수 있습니다. --template 옵션을 지정하면 보안 리뷰어, 소유자 정책 승인 봇, PR 자동 수정 봇, Linear 또는 Jira 이슈 분류 및 우선순위 지정 봇 템플릿으로 시작할 수 있습니다.

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

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

코드로 정의하는 에이전트

에이전트는 하나의 프로젝트입니다. instructions.md가 프롬프트 역할을 합니다. tools/의 각 파일은 모델이 호출할 수 있는, 타입이 지정된 작업 하나에 해당합니다. skills/에는 모델이 필요할 때 불러오는 절차가 들어 있고, mcp-connections/는 MCP 서버의 도구를 추가하며, channels/는 봇이 메시지를 수신하고 응답하는 곳을 정의합니다. agent-sdk validate는 프로젝트를 검사하고, agent-sdk info는 발견된 항목을 출력합니다.

채널

에이전트는 GitHub, GitLab, Bitbucket의 pull request, 댓글, CI 이벤트, Slack의 멘션과 DM, 모든 제공업체의 웹훅, 그리고 cron 일정에 따라 실행됩니다. GitHub 이벤트는 사용자의 Cursor 계정을 통해 가져오므로 공개 웹훅 URL이 필요하지 않습니다. Slack은 별도 설정 없이 바로 사용할 수 있습니다.

각 대화는 자체 세션을 유지하며, 모든 메시지와 도구 호출을 빠짐없이 기록합니다. pull request나 Slack 스레드에서 후속 질문을 하면 같은 세션이 재개됩니다.

평가

eval은 봇에 고정된 메시지를 보낸 뒤, 봇이 수행한 작업을 검증합니다. 어떤 도구가 어떤 입력으로 실행되었는지, 응답이 어떤 형태인지를 확인합니다. agent-sdk eval은 로컬이나 CI에서 실행할 수 있습니다.

agent-sdk github replay <pr-url>은 실제 pull request를 서명된 웹훅 페이로드로 변환해 봇에 전송합니다. 따라서 GitHub 기반 봇을 푸시를 기다리지 않고 바로 테스트할 수 있습니다. --dry-run --fixtures-dir fixtures/를 추가하면 페이로드를 eval 픽스처로 저장합니다.

시작하기

Agent SDK가 오늘 정식 출시되었습니다. 문서를 확인하고 지금 바로 시작해 보세요.

클라우드 에이전트 캔버스 및 환경 개선

클라우드 에이전트의 캔버스

이제 클라우드 에이전트가 작업 중에 대화형 캔버스를 만들 수 있습니다. 완성된 캔버스는 링크를 보내 팀과 공유할 수 있습니다.

캔버스 공유에 대해 자세히 알아보세요.

Environments API

이제 Environments API를 베타로 사용할 수 있습니다. 이 API를 사용하면 에이전트가 실행되는 클라우드 환경을 프로그래밍 방식으로 만들고 관리할 수 있습니다.

더 크고 빨라진 환경

클라우드 에이전트 환경에서 이제 최대 300개의 저장소를 지원합니다. 대규모 환경의 로딩 속도도 5배 빨라졌습니다.

Origin 앱 마켓플레이스

이제 Origin은 Cloudflare, Linear, Sentry, Socket Security 등 파트너가 제공하는 20개 이상의 앱과 연동되어 배포, CI, 코드 검토, 보안, 모니터링, 프로젝트 관리를 지원합니다.

또한 오늘부터 마켓플레이스에 누구나 앱을 제출할 수 있어, 개발자 도구를 만드는 팀이라면 어디든 Origin용 앱을 게시할 수 있습니다.

사용자의 스택에 맞는 앱

이제 마켓플레이스에서 다음 분야의 앱을 사용할 수 있습니다.

배포, CI, 코드 리뷰, 보안, 모니터링, 프로젝트 관리 분야의 앱이 등록된 Origin 앱 마켓플레이스

마켓플레이스에 게시하기

앱을 제출하려면 다음 단계를 따르세요.

  1. 사용자의 네임스페이스에 앱을 만드세요. 개발하는 동안에는 해당 네임스페이스 내에서만 비공개로 유지됩니다.
  2. Origin API를 기반으로 앱을 개발하세요. 앱은 앱 JWT와 설치 접근 토큰으로 인증하고, 웹훅 이벤트를 수신하며, check run, pull request 주석, 검토를 다시 기록할 수 있습니다.
  3. 앱을 공개로 전환한 다음, 앱 페이지에서 슬러그, 추천 태그, 데모 영상을 첨부해 제출하세요. 영상에는 설치와 제거 과정, 그리고 핵심 제품 흐름이 담겨 있어야 합니다.
  4. 제출된 앱을 검토한 후 승인되면 마켓플레이스에 등록합니다.
Origin 앱 마켓플레이스에 앱 제출하기

시작하기

지금 바로 Origin 앱 마켓플레이스에서 앱을 사용해 보세요.

Origin 앱을 만들고 싶으신가요? 게시 가이드와 Origin API 참조부터 확인해 보세요.

Origin Apps 플러그인을 사용하면 최신 Origin API 문서를 바탕으로 질문에 대한 답변을 얻을 수 있고, 이미 운영 중인 앱을 Origin으로 이전하는 계획도 세울 수 있습니다.

로컬 에이전트 원격 제어

이제 Cursor iOS 앱으로 내 컴퓨터에서 실행 중인 로컬 에이전트를 확인하고 응답할 수 있습니다.

시작하기

원격 제어는 기업 조직을 제외한 모든 사용자에게 기본적으로 활성화되어 있습니다.

Cursor iOS 앱을 다운로드하고 로그인하세요. 계정에 연결된 컴퓨터가 앱에 자동으로 표시됩니다. 앱에서 사용할 컴퓨터를 탭한 다음, Cursor 데스크톱 앱에서 페어링 요청을 승인하세요. 그러면 로컬 에이전트 목록이 표시됩니다. 에이전트를 탭하면 현재 진행 중인 작업을 확인하거나 메시지를 보낼 수 있습니다.

Cursor iOS 앱에서 로컬 에이전트를 원격 제어하는 화면

에이전트는 사용자의 컴퓨터에서 계속 실행됩니다

원격 제어를 사용해도 에이전트가 다른 곳으로 옮겨지지는 않습니다. 에이전트는 그대로 사용자의 컴퓨터에서 실행되고, 앱은 이 컴퓨터에 연결될 뿐입니다. 원격 제어를 사용하려면 컴퓨터가 켜져 있고 인터넷에 연결된 상태여야 합니다.

컴퓨터 절전 모드 방지하기

자리를 비운 동안 컴퓨터가 절전 모드로 전환되지 않게 하려면 Cursor 데스크톱 설정의 원격 제어에서 "Keep this computer awake"를 켜세요. 이 기능을 사용하려면 컴퓨터가 전원에 연결되어 있고 노트북 덮개가 열려 있어야 합니다.

기업 팀용

원격 제어는 기업 조직을 제외하면 기본적으로 켜져 있습니다. 기업 관리자는 Org settings > Security and identity > 원격 제어에서 이 기능을 켤 수 있습니다.

원격 제어는 클라우드 Agent 없이도 작동합니다.

원격 제어는 현재 Cursor iOS 앱에서 바로 사용할 수 있습니다.

Rollouts와 Security Review

오늘 코드 배포의 마지막 단계를 책임지는 두 가지 Cursor 봇을 출시합니다. Rollouts는 배포되는 모든 변경 사항을 모니터링하고 환경별 health 상태를 보고합니다. Security Review는 모든 pull request에서 악용 가능한 버그를 찾아 보고합니다.

두 봇 모두 오늘부터 Teams 및 기업 플랜에서 이용할 수 있습니다.

Rollouts

Rollouts는 모든 pull request에 모니터를 연결하고 변경 사항이 배포되는 과정을 지켜보며, 환경별 변경 health를 검증된 정상(verified healthy), 회귀 탐지됨(regression detected), 판단 불가(inconclusive) 중 하나로 보고합니다. Firetiger Change Monitors를 Bot Development Kit로 새롭게 만든 Cursor 버전입니다.

대시보드에서 Rollouts를 활성화한 다음 소스 제어, 배포 시스템, 텔레메트리 제공업체를 연결하세요. 다음 pull request부터 Rollouts가 모니터링을 시작합니다.

모니터링 플랜

pull request가 열리면 Rollouts는 diff와 변경의 영향을 받는 시스템을 읽은 뒤, 모니터링 플랜을 작성해 PR 코멘트로 남깁니다. 플랜에는 파악된 위험 요소, 변경으로 기대하는 효과, 확인할 신호, 그리고 변경 사항 검증을 어렵게 만드는 계측 공백이 담겨 있습니다. PR에서 플랜을 수정하면 Rollouts는 수정된 버전을 사용합니다.

배포 추적

Rollouts는 변경 사항의 커밋에 대한 배포 이벤트가 발생하면 활성화되어 로그, 메트릭, 트레이스를 바탕으로 플랜을 실행합니다. 환경마다 따로 추적하므로, 스테이징에서 검증된 변경 사항이라도 프로덕션에서는 플래그가 지정될 수 있습니다. Rollouts는 오류 및 지연 시간 신호와 함께 변경 사항이 의도한 효과를 내는지 확인하고, 판정이 내려지면 PR에 결과를 보고합니다.

회귀

Rollouts는 회귀를 탐지하면 원인으로 의심되는 변경 사항을 지목하고 작성자에게 알립니다. 설정에 따라 검토용 revert PR을 열거나, 발견 사항을 클라우드 Agent에 넘겨 수정하도록 할 수도 있습니다. 현재 Rollouts가 직접 병합하거나 롤백하지는 않습니다.

통합

Rollouts는 소스 제어를 위해 Origin 또는 GitHub와, 배포 이벤트 수신을 위해 지속적 배포 시스템과, 신호 수집을 위해 Datadog 등 텔레메트리 제공업체와 연결됩니다. 기능 플래그 통합도 곧 지원될 예정입니다.

Security Review

이제 Security Review를 사용할 수 있습니다. Security Review는 모든 pull request를 코드베이스 컨텍스트에서 읽고, 악용 가능한 버그를 정리한 검토 댓글을 하나 게시합니다. 스타일과 코드 품질은 기존처럼 Bugbot이 담당합니다.

pull request에서 발견한 악용 가능한 버그를 심각도 및 수정 제안과 함께 보고하는 Security Review 댓글

대시보드에서 검토를 원하는 리포지토리에 활성화하세요. 초안 PR은 검토하지 않습니다.

보고 항목

Security Review는 SQL, 명령어, 템플릿 영역 전반의 인젝션 취약점과 함께 인증 및 승인 우회를 탐지하며, 리팩터링 이후 더 이상 실행되지 않는 검사도 찾아냅니다. 또한 소스에 커밋된 시크릿과 자격 증명, SSRF 및 검증되지 않은 리디렉션, 안전하지 않은 역직렬화, 알려진 취약점을 유발하는 의존성 변경에도 플래그를 지정합니다. 사용자 입력이 어디로 들어와 어떤 경로를 거치는지도 추적합니다.

발견 사항

각 발견 사항에는 심각도, 공격 경로, 수정 제안이 함께 제공됩니다. 사유를 남기고 발견 사항을 해제하면 Security Review는 해당 PR에서 같은 항목을 다시 표시하지 않습니다.

팀 규칙

외부 호출이 반드시 거쳐야 하는 클라이언트나 요청 핸들러에서 절대 조회하면 안 되는 테이블처럼 코드베이스에 필요한 규칙을 추가하면, Security Review가 모든 PR에 해당 규칙을 적용합니다.

시작하기

Rollouts와 보안 리뷰어는 오늘부터 Teams 및 기업 플랜에서 이용할 수 있습니다. 자동화 탭에서 원하는 봇을 활성화하세요.

앞으로 10일 동안 팀에서 실제 변경 사항에 Rollouts를 사용해 볼 수 있도록 사용량 크레딧을 제공합니다. Teams 고객은 약 50건, 기업 고객은 약 500건의 변경 사항에 해당하는 크레딧을 받게 됩니다.