Cursor Cloud Agents

Cursor Cloud Agents API의 패스스루 엔드포인트를 소개할게요. 내 저장소(repository)에서 작업하는 클라우드 에이전트를 네이티브 형식 그대로(변환 없이) 실행하고 관리할 수 있는 기능이에요.

출처: 문서

본문

연결 대상 호스트는 https://api.cursor.com이고, 프록시를 통한 주소는 이렇게 구성돼요.

LITELLM_PROXY_BASE_URL/cursor

참고로 Cursor CLI(api2.cursor.sh)의 경우 agent --endpoint를 api.cursor.com 베이스로 쓸 수도 있어요. 자세한 내용은 Cursor 통합 튜토리얼을 확인해 주세요.

지원되는 라우트는 다음과 같아요.

/v0/agents

/v0/agents

/v0/agents/{id}

/v0/agents/{id}

/v0/agents/{id}/conversation

/v0/agents/{id}/followup

/v0/agents/{id}/stop

/v0/me

/v0/models

/v0/repositories

빠른 시작 (Quick Start)

1. 프록시에 Cursor API 키 추가하기

Cursor API 키를 환경 변수 CURSOR_API_KEY로 설정해요.

2. Cursor 에이전트 실행하기

curl -X POST http://0.0.0.0:4000/cursor/v0/agents \
  -H "Authorization: Bearer <your-...key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": {
      "text": "Add a README.md with installation instructions"
    },
    "source": {
      "repository": "https://github.com/your-org/your-repo",
      "ref": "main"
    },
    "target": {
      "autoCreatePr": true
    }
  }'

응답은 다음과 같아요.

{
  "id": "bc_abc123",
  "name": "Add README Documentation",
  "status": "CREATING",
  "source": {
    "repository": "https://github.com/your-org/your-repo",
    "ref": "main"
  },
  "target": {
    "branchName": "cursor/add-readme-1234",
    "url": "https://cursor.com/agents?id=bc_abc123",
    "autoCreatePr": true
  },
  "createdAt": "2024-01-15T10:30:00Z"
}

3. 로그 확인하기

에이전트 실행 이벤트는 cursor/cursor:agent:create 태그로 로그에 기록돼요.

예시 (Examples)

핵심 아이디어는 간단해요. Cursor SDK의 베이스 URL을 http://0.0.0.0:4000/cursor로 바꾸면 돼요. 원래 https://api.cursor.com을 호출하던 것을 http://0.0.0.0:4000/cursor로 바꾸고, -u YOUR_API_KEY: 대신 -H "Authorization: Bearer <your-...key>"로 인증하면 됩니다.

사용 가능한 모델 목록 조회

curl http://0.0.0.0:4000/cursor/v0/models \
  -H "Authorization: Bearer <your-...key>"

에이전트 상태 확인

curl http://0.0.0.0:4000/cursor/v0/agents/bc_abc123 \
  -H "Authorization: Bearer <your-...key>"

모든 에이전트 조회

curl http://0.0.0.0:4000/cursor/v0/agents \
  -H "Authorization: Bearer <your-...key>"

에이전트에 후속 지시(follow-up) 추가

curl -X POST http://0.0.0.0:4000/cursor/v0/agents/bc_abc123/followup \
  -H "Authorization: Bearer <your-...key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": {
      "text": "Also add a section about troubleshooting"
    }
  }'

에이전트 중지

curl -X POST http://0.0.0.0:4000/cursor/v0/agents/bc_abc123/stop \
  -H "Authorization: Bearer <your-...key>"

에이전트 삭제

curl -X DELETE http://0.0.0.0:4000/cursor/v0/agents/bc_abc123 \
  -H "Authorization: Bearer <your-...key>"

API 키 정보 조회

curl http://0.0.0.0:4000/cursor/v0/me \
  -H "Authorization: Bearer <your-...key>"

Cursor Cloud Agents