메인 콘텐츠로 건너뛰기

Background Agents API

Background Agents API를 쓰면 리포지토리에서 자율적으로 일하는 AI 코딩 에이전트를 코드로 만들어서 관리할 수 있어. 이 API로 사용자 피드백에 자동 응답하고, 버그를 고치고, 문서를 업데이트하고, 그 밖의 작업들도 잔뜩 자동화할 수 있어!
Background Agents API는 현재 베타야. 너의 피드백을 정말 듣고 싶어!

핵심 기능

  • 자율 코드 생성 - 프롬프트를 이해하고 코드베이스를 수정할 수 있는 에이전트를 만들어
  • 리포지토리 통합 - GitHub 리포지토리와 바로 작업해
  • 후속 프롬프트 - 실행 중인 에이전트에 추가 지시를 더해
  • 사용량 기반 과금 - 사용한 토큰만큼만 결제해
  • 확장성 - API 키당 최대 256개의 활성 에이전트를 지원해

빠른 시작

1. API 키 받기

API 키를 만들려면 Cursor Dashboard → Integrations로 이동해.

2. API 사용 시작하기

모든 API 엔드포인트는 다음 기준 경로를 따르지:
https://api.cursor.com
자세한 엔드포인트 목록은 API 레퍼런스를 참고해.

인증

모든 API 요청은 Bearer 토큰으로 인증해야 해:
Authorization: Bearer YOUR_API_KEY
API 키는 Cursor Dashboard에서 만들 수 있어. 키는 계정에 범위가 묶여 있고, 에이전트를 생성하고 관리할 수 있는 권한을 부여해(플랜 한도와 리포지토리 접근 권한을 따름).

요금

API는 현재 베타 단계고, Background Agents와 같은 요금이 적용돼. 서비스 규모가 커지면 요금이 바뀔 수 있어. Background Agent 요금을 확인해.

다음 단계

I