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

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

Доступ к фоновым агентам можно получить двумя способами:
  1. Background Agent Sidebar: Используй вкладку background agent в встроенной боковой панели Cursor, чтобы просматривать всех фоновых агентов, связанных с твоим аккаунтом, искать существующих и запускать новых.
  2. Background Agent Mode: Нажми , чтобы включить режим background agent в интерфейсе.
После отправки запроса выбери своего агента из списка, чтобы посмотреть статус и войти в машину.

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

​
Настройка

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

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

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

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

Для продвинутых случаев настрой окружение сам. Подключи экземпляр IDE к удалённой машине. Подготовь свою машину, установи инструменты и пакеты, затем сделай снимок. Настрой параметры выполнения:
  • Команда install запускается до старта агента и устанавливает зависимости рантайма. Это может быть npm install или bazel build.
  • Терминалы запускают фоновые процессы, пока агент работает — например, поднимают веб‑сервер или компилируют protobuf‑файлы.
Для самых продвинутых сценариев используй Dockerfile для настройки машины. Dockerfile позволяет задать системные зависимости: установить конкретные версии компиляторов, отладчики или сменить базовый образ ОС. Не делай COPY всего проекта — мы управляем рабочим пространством и чекаутим нужный коммит. Установку зависимостей всё равно выполняй в install‑скрипте. Введи любые необходимые секреты для своего dev‑окружения — они хранятся зашифрованными at rest (c использованием 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 Mode). Мы никогда не обучаем модели на твоём коде и храним его только на время работы агента. Подробнее о Privacy Mode. Что важно знать:
  1. Дай нашему GitHub‑приложению права на чтение и запись для репозиториев, которые хочешь редактировать. Это нужно, чтобы клонировать репозиторий и вносить изменения.
  2. Твой код выполняется в нашей инфраструктуре AWS в изолированных VM и хранится на дисках VM, пока агент активен.
  3. У агента есть доступ к интернету.
  4. Агент автоматически запускает все команды терминала, что позволяет ему прогонять тесты итеративно. Это отличается от foreground‑агента, который требует подтверждения пользователя для каждой команды. Автозапуск создаёт риск утечки данных: злоумышленники могут провести prompt‑injection‑атаку и заставить агента загрузить код на вредоносные сайты. См. объяснение OpenAI о рисках prompt injection для background‑агентов.
  5. Если Privacy Mode отключён, мы собираем промпты и параметры dev‑окружения, чтобы улучшать продукт.
  6. Если ты отключишь Privacy Mode при запуске background‑агента, а потом включишь его во время работы, агент продолжит работать с отключённым Privacy Mode до завершения.

​
Настройки дашборда

Админы рабочего пространства могут настроить дополнительные параметры на вкладке Background Agents в дашборде.

​
Настройки по умолчанию

  • Модель по умолчанию – модель, используемая, когда запуск не указывает конкретную. Выбери любую модель, которая поддерживает Max Mode.
  • Репозиторий по умолчанию – если поле пустое, агенты попросят тебя выбрать репозиторий. Укажи репозиторий здесь, чтобы пропустить этот шаг.
  • Базовая ветка – ветка, от которой агенты делают форк при создании pull request’ов. Оставь пустым, чтобы использовать ветку репозитория по умолчанию.

​
Настройки безопасности

Все параметры безопасности требуют прав администратора.
  • Ограничения для пользователей — выбери None (все участники могут запускать фоновых агентов) или Allow list. Если включён режим Allow list, ты указываешь, какие именно коллеги могут создавать агентов.
  • Team follow-ups — когда включено, любой в рабочем пространстве может добавлять последующие сообщения к агенту, которого запустил кто-то другой. Отключи, чтобы ограничить такие сообщения владельцем агента и админами.
  • Display agent summary — управляет тем, показывает ли Cursor изображения сравнений файлов (file diff) и фрагменты кода агента. Отключи это, если не хочешь, чтобы пути к файлам или код отображались в боковой панели.
  • Display agent summary in external channels — расширяет предыдущий переключатель на Slack или любой подключённый внешний канал.
Изменения сохраняются мгновенно и сразу применяются к новым агентам.