Cursor, 코드로 정의하는 에이전트 SDK 'Agent SDK' 정식 출시
Agent SDK
Cursor(Anysphere)가 Agent SDK를 정식 출시했다. 에이전트를 코드 폴더로 정의하고, evals로 테스트한 뒤 Cursor 또는 자체 인프라에 배포할 수 있다. 'npx @cursor/agent-sdk init ./my-bot'으로 시작하고 'agent-sdk dev'로 로컬 playground에서 실행한다. 에이전트는 하나의 프로젝트 폴더로 구성된다. instructions.md가 프롬프트이고, tools/의 각 파일이 모델이 호출할 수 있는 타입이 지정된 액션 하나다. skills/에는 모델이 필요할 때 불러오는 절차가, mcp-connections/에는 MCP 서버에서 가져오는 도구가, channels/에는 메시지를 받고 응답하는 채널이 정의된다. 'agent-sdk validate'로 프로젝트를 검증하고 'agent-sdk info'로 발견된 구성 요소를 출력한다. 채널은 GitHub, GitLab, Bitbucket의 풀 리퀘스트·댓글·CI 이벤트, Slack의 멘션과 DM, 임의 제공자의 웹훅, cron 스케줄을 트리거로 쓸 수 있다. GitHub 이벤트는 Cursor 계정을 통해 전달되어 공개 웹훅 URL이 필요 없다. 'agent-sdk eval'은 고정된 메시지를 봇에 보내고 실행된 도구와 입력, 응답 형태를 검증한다. 'agent-sdk github replay <pr-url>'은 실제 풀 리퀘스트를 서명된 웹훅 페이로드로 바꿔 봇에 전달하며, '--dry-run --fixtures-dir fixtures/' 옵션으로 페이로드를 eval 픽스처로 저장할 수 있다. 'agent-sdk deploy'는 프로젝트를 빌드해 URL을 부여하고 Cursor 인프라에서 실행한다. 시크릿과 통합은 대시보드에서 관리한다.
'agent-sdk github replay'로 실제 풀 리퀘스트를 재생해 푸시를 기다리지 않고 GitHub 기반 봇을 테스트할 수 있고, '--dry-run --fixtures-dir' 옵션으로 페이로드를 eval 픽스처로 저장할 수 있다.
원문 출처
Cursor (Anysphere) Changelog