С фоновыми агентами запускай асинхронных агентов, которые редактируют и выполняют код в удалённой среде. Отслеживай их статус, отправляй фоллоу-апы или в любой момент бери управление на себя.

​
Как использовать

К фоновым агентам можно получить доступ двумя способами:
  1. Боковая панель фоновых агентов: Используй вкладку фоновых агентов в нативной боковой панели Cursor, чтобы просмотреть всех агентов, связанных с твоим аккаунтом, найти существующих и запустить новых.
  2. Режим фонового агента: Нажми , чтобы включить режим фонового агента в интерфейсе.
После отправки запроса выбери агента из списка, чтобы посмотреть статус и перейти к машине.

Для работы фоновых агентов требуется хранение данных в течение нескольких дней.

​
Обратная связь

Отправляй фидбэк в наш канал Discord #background-agent или на background-agent-feedback@cursor.com. Пожалуйста, присылай баги, запросы фич или идеи.

​
Настройка

Фоновые агенты по умолчанию запускаются в изолированной машине на базе Ubuntu. У агентов есть доступ в интернет, и они могут устанавливать пакеты.

​
Подключение GitHub

Фоновые агенты клонируют твой репозиторий из GitHub и работают в отдельной ветке, пушат изменения в твой репозиторий для удобной передачи. Предоставь права чтения и записи для своего репозитория (и любых зависимых репозиториев или сабмодулей). В будущем мы добавим поддержку других провайдеров (GitLab, Bitbucket и т. д.).
Настройка списка разрешённых IP
Если в твоей организации включён IP allow list в GitHub, нужно настроить доступ для фоновых агентов. См. документацию по интеграции с GitHub для полного гайда по настройке, включая контактные данные и IP-адреса.

​
Базовая настройка окружения

Для продвинутых случаев настрой окружение сам. Подключи экземпляр IDE к удалённой машине. Подготовь машину, установи инструменты и пакеты, затем сними снапшот. Настрой параметры выполнения:
  • Команда install запускается до старта агента и ставит зависимости рантайма. Это может быть npm install или bazel build.
  • Терминалы запускают фоновые процессы, пока агент работает — например, стартуют веб‑сервер или компилируют protobuf‑файлы.
Для самых продвинутых кейсов используй Dockerfile для настройки машины. Dockerfile позволяет выставить системные зависимости: поставить конкретные версии компиляторов, отладчики или сменить базовый образ ОС. Не делай COPY всего проекта — мы управляем рабочим пространством и чекаутим нужный коммит. Установку зависимостей по-прежнему выполняй в install‑скрипте. Введи все необходимые секреты для своего dev‑окружения — они хранятся зашифрованными at rest (через KMS) в нашей базе и пробрасываются в окружение фонового агента. Конфигурация машины хранится в .cursor/environment.json, его можно закоммитить в репозиторий (рекомендуется) или держать приватно. Мастер настройки проведёт тебя через создание environment.json.

​
Команды обслуживания

При настройке новой машины мы начинаем с базового окружения, затем запускаем команду install из твоего environment.json. Это та команда, которую разработчик запускает при переключении веток — чтобы поставить новые зависимости. Для большинства команда install — это npm install или bazel build. Чтобы ускорить старт машины, мы кэшируем состояние диска после выполнения install. Спроектируй её так, чтобы она могла выполняться многократно. Только состояние диска сохраняется после install — процессы, запущенные здесь, не будут жить к моменту старта агента.

​
Команды запуска

После выполнения install машина стартует, и мы выполняем команду start, а затем поднимаем все terminals. Это запускает процессы, которые должны работать во время работы агента. Команду start часто можно пропустить. Используй её, если твоё dev‑окружение зависит от Docker — положи sudo service docker start в start. terminals — для кода приложения. Эти терминалы запускаются в сессии tmux, доступной тебе и агенту. Например, во многих веб‑репозиториях в терминал ставят npm run watch.

​
Спецификация environment.json

Файл environment.json может выглядеть так: 
{
  "snapshot": "POPULATED_FROM_SETTINGS",
  "install": "npm install",
  "terminals": [
    {
      "name": "Run Next.js",
      "command": "npm run dev"
    }
  ]
}
Формально спецификация определена здесь.

​
Модели

Фоновые агенты поддерживают только модели, совместимые с Max Mode.

​
Тарифы

Узнай больше о тарифах Background Agent.

​
Безопасность

Background Agents доступны в режиме Privacy. Мы никогда не обучаем модели на твоём коде и храним его только на время работы агента. Подробнее о режиме Privacy. Что тебе стоит знать:
  1. Выдай права чтения и записи нашему приложению GitHub для репозиториев, которые хочешь редактировать. Мы используем это, чтобы клонировать репозиторий и вносить изменения.
  2. Твой код выполняется в нашей инфраструктуре AWS в изолированных ВМ и хранится на дисках ВМ, пока агент активен.
  3. У агента есть доступ в интернет.
  4. Агент автоматически запускает все команды терминала, что позволяет ему итеративно прогонять тесты. Это отличается от foreground-агента, который требует подтверждения пользователя для каждой команды. Автозапуск создаёт риск утечки данных: злоумышленники могут провести prompt injection-атаки и заставить агента загрузить код на вредоносные сайты. См. объяснение OpenAI о рисках prompt injection для background-агентов.
  5. Если режим Privacy отключён, мы собираем подсказки и окружения разработки, чтобы улучшать продукт.
  6. Если ты отключишь режим Privacy при запуске background-агента, а затем включишь его во время работы агента, агент продолжит работать с отключённым режимом Privacy до завершения.