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

Как пользоваться

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

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

Настройка

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

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

Фоновые агенты клонируют твой репозиторий с GitHub, работают в отдельной ветке и отправляют изменения обратно в репозиторий для удобной передачи. Предоставь права на чтение и запись для репозитория (а также для любых зависимых репозиториев и сабмодулей). В будущем мы добавим поддержку других провайдеров (GitLab, Bitbucket и т. д.).
Настройка списка разрешённых IP
Если в твоей организации включён список разрешённых IP в 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": "Запуск Next.js",
      "command": "npm run dev"
    }
  ]
}
Формально спецификация определена здесь.

Модели

Для фоновых агентов доступны только модели, совместимые с Max Mode.

Цены

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

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

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

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

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

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

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

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

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