← 목록으로

Cursor Agent SDK - 팀 맞춤형 AI 에이전트를 코드로 만들고 배포하는 프레임워크

요약
  • Cursor가 팀의 지식과 도구에 최적화된 AI 에이전트를 개발하고 배포할 수 있는 'Agent SDK'를 공개했습니다.
  • 이 프레임워크는 지침과 도구를 코드로 관리하며 Slack 등 외부 서비스와 연동이 가능하고, 자동 평가 및 병렬 처리 기능을 지원합니다.
  • 개발자는 Cursor의 관리형 호스팅이나 자체 인프라를 통해 맞춤형 에이전트를 배포하고 운영할 수 있습니다.
  • Cursor가 팀의 지식과 도구, 업무 방식에 맞는 AI 에이전트를 개발하는 Agent SDK를 정식 공개함. 지침 작성부터 외부 서비스 연결, 테스트와 평가, 배포까지 하나의 소프트웨어 프로젝트로 관리할 수 있음
  • Markdown으로 지침을, TypeScript로 도구와 처리 로직을 정의하고 AI의 판단을 결합함. 에이전트의 행동을 결정하는 파일을 일반 코드처럼 버전 관리하고 팀에서 검토할 수 있음
  • Slack, PR, 이슈 트래커 등 팀이 일하는 곳에 에이전트를 연결할 수 있음. 메시지나 업무 이벤트를 받아 필요한 정보를 찾고, 팀 정책에 따라 도구를 실행하도록 구성함
  • 로컬 플레이그라운드, 자동 평가, 이벤트 재생으로 동작을 확인하고 개선함. 복잡한 작업은 별도 전문 에이전트에 넘기거나 여러 하위 에이전트로 나눠 병렬 처리할 수 있음
  • Cursor 관리형 호스팅과 자체 인프라 운영을 모두 지원함. 로컬에서 개발한 프로젝트를 Cursor에 배포하거나 Node 프로세스와 컨테이너로 직접 운영할 수 있음
팀의 지식과 도구를 갖춘 에이전트
  • Agent SDK는 각 팀의 지침과 도구, 외부 서비스 연결을 조합해 맞춤형 에이전트를 만드는 프레임워크임
  • 개발자는 에이전트가 따라야 할 지침과 실행할 수 있는 도구를 작성하고, Cursor는 모델이 도구를 호출하고 결과를 받아 다음 행동을 결정하는 실행 루프를 제공함
  • 에이전트는 팀이 사용하는 시스템에 연결돼 메시지와 이벤트에 반응하며, 팀이 직접 검토하고 수정할 수 있는 정책을 따름
  • Cursor가 자체 코드 검토 서비스 Bugbot, 보안 검토 에이전트 Security Reviewer, Rollouts 등을 만드는 데 사용하는 프레임워크임
  • 일정과 이벤트에 프롬프트를 연결하는 작업에서 더 나아가, AI의 판단 전후에 코드로 처리 절차를 구현하고 반복 검증해야 할 때 사용할 수 있음
  • 기존 Cursor Automation을 Agent SDK 프로젝트로 전환하는 방법도 제공함
지침과 도구를 하나의 프로젝트로 관리
  • 에이전트는 Markdown과 TypeScript 파일로 구성된 작은 소프트웨어 프로젝트로 정의함
  • 지침, 도구, 외부 서비스 연결, 하위 에이전트와 평가를 함께 관리하므로 변경 사항에 기존 Git 버전 관리와 코드 리뷰 절차를 적용할 수 있음
    구성 역할
    에이전트 설정 사용할 모델과 실행 환경 설정
    지침 에이전트의 목표와 행동 기준을 Markdown으로 작성
    도구 에이전트가 호출할 기능을 TypeScript 함수로 구현
    스킬 필요할 때 불러오는 작업 절차
    외부 연결 MCP 서버와 외부 서비스의 도구 연결
    채널 메시지나 이벤트를 받아 작업을 시작하는 진입점
    하위 에이전트 역할별 지침과 도구를 갖춘 작업자
    평가 답변과 행동이 기대한 조건을 충족하는지 검증
  • 지침과 실행 코드를 함께 수정할 수 있어, 모델에 맡길 판단과 코드로 확정할 처리를 조합할 수 있음
  • 예를 들어 정보를 해석하고 위험도를 판단하는 일은 모델에 맡기고, 외부 API 호출과 결과 게시 같은 동작은 도구 코드로 구현할 수 있음
  • 구체적인 파일 구성은 프로젝트 구조 문서에서 확인할 수 있음
팀이 일하는 곳에 연결
  • Slack과 PR, 이슈 트래커 등 기존 업무 시스템을 에이전트의 진입점으로 사용할 수 있음
  • GitHub, GitLab, Bitbucket의 PR 이벤트를 받아 작업을 시작하거나, 외부 서비스에서 들어오는 요청을 처리하도록 구성함
  • MCP 연결로 외부 도구를 사용하고, 직접 작성한 TypeScript 도구와 함께 활용할 수 있음
  • 도구와 업무 지침을 조합해 코드 검토, 이슈 분류, 규정 준수 절차, 장애 조사 등 팀에 필요한 흐름을 구현함
  • 정기 실행과 리마인더도 지원해, 외부 이벤트 외에 정해진 시점에 작업을 시작하도록 구성할 수 있음
전문 에이전트에 위임하고 병렬 처리
  • 복잡한 작업은 자체 도구와 세션을 갖춘 다른 전문 에이전트에 넘길 수 있음
  • 하나의 작업을 여러 하위 에이전트로 나눠 병렬 처리할 수도 있음
  • 역할별 지침과 도구를 분리해 필요한 전문 기능을 조합하고, 상위 에이전트가 작업을 분배하는 구조를 만들 수 있음
  • 별도로 배포한 팀 에이전트끼리도 연결할 수 있어, 다른 에이전트가 제공하는 기능을 호출하도록 구성할 수 있음
답변뿐 아니라 행동도 평가
  • 로컬 플레이그라운드에서 에이전트와 대화하고 실행 결과와 도구 호출을 확인하며 개발함
  • 기존 업무 이벤트를 다시 전달하는 이벤트 재생으로, 실제 상황에서 에이전트가 어떻게 반응하는지 반복 확인할 수 있음
  • 자동 평가(Evals) 는 정해진 입력을 실제 에이전트에 보내고 답변과 도구 호출이 기대한 조건을 충족하는지 검사함
    • 필요한 정보를 조회하는 도구를 호출했는가
    • 실행하면 안 되는 도구를 호출하지 않았는가
    • 응답이 정해진 JSON 구조를 따르는가
    • 답변에 필요한 사실과 판단 근거가 포함됐는가
  • 여러 차례 이어지는 대화도 하나의 평가 사례로 구성하고, 의미에 따른 품질 판단에는 평가 모델을 사용할 수 있음
  • 실제 이벤트를 고정된 테스트 입력으로 저장해 지침과 도구를 바꾼 뒤에도 기존 동작이 유지되는지 확인할 수 있음
  • 평가 결과를 CI에서 수집할 수 있으며, 평가 중 실제 도구가 실행되므로 외부 쓰기 동작을 제어하도록 구성해야 함
  • 작성 방법과 실행 예시는 평가 가이드에서 제공함
로컬 개발부터 배포까지
  • 템플릿으로 프로젝트를 만들거나, 코딩 에이전트에 문서를 제공해 구현을 시작할 수 있음
  • SDK에는 코딩 에이전트가 프로젝트 개발 과정을 따라갈 수 있도록 안내하는 스킬도 포함됨
  • 로컬에서 지침과 도구를 수정하고 플레이그라운드와 평가로 확인한 뒤 배포하는 흐름임
  • agent-sdk deploy 는 Git에 커밋하고 원격에 올린 버전을 빌드해 Cursor 인프라에서 실행하고 URL을 부여함
    • 미커밋 변경은 배포에 포함되지 않음
    • 시크릿과 외부 연결을 관리하고, 배포 후에도 로그와 평가, 플레이그라운드를 사용할 수 있음
  • 자체 네트워크나 프로세스 제어가 필요하면 Node 프로세스로 직접 운영하거나 컨테이너로 패키징할 수 있음
    • 자체 호스팅에서도 모델 호출에는 Cursor 인증을 사용함
  • 시작 가이드는 Node.js 22.13 이상과 Cursor 로그인을 요구함
  • 자세한 사용법은 Agent SDK 공식 문서와 배포 가이드에서 확인할 수 있음
실제 활용 사례와 시작 템플릿
  • Cursor 내부 팀은 축적한 지식과 과거의 결정을 모든 PR에 적용하기 위해 kb-reviewer를 약 하루 만에 구축함
    • 현재 주요 코드베이스의 모든 PR에서 실행됨
    • 기록된 교훈과 충돌하는 변경을 찾아 근거 노트를 인용하고, 엔지니어가 불일치를 해소하도록 유도함
  • PGA Tour는 소프트웨어 개발 절차를 이끄는 에이전트와 관련 구성 요소를 Cursor 인프라에 구축함
    • 내장 평가 기능으로 새로운 아이디어를 반복 검증하고 기존 기능을 개선함
  • 리뷰와 이슈 분류 템플릿으로 보안 검토, 버그 및 코드 품질 검토, Linear/Jira 이슈 분류 등을 시작할 수 있음
  • 담당자 정책 기반 승인 템플릿은 파일 경로별 정책에 따라 검토자를 지정하고 허용된 변경을 승인함
    • 특정 영역은 반드시 사람이 승인하도록 지정할 수 있음
    • 정책은 PR의 기준 브랜치에서 읽어, 해당 PR이 자신의 승인 기준을 바꿔 우회하지 못하게 함
그냥 목록으로
원문 보기 ↗