이제 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가 오늘 정식 출시되었습니다. 문서를 확인하고 지금 바로 시작해 보세요.