Как пользоваться
- Background Agent Sidebar: Используй вкладку фоновых агентов в нативной боковой панели Cursor, чтобы просматривать всех фоновых агентов, связанных с твоим аккаунтом, искать существующих и запускать новых.
- Background Agent Mode: Нажми , чтобы включить режим фонового агента в интерфейсе.
Фоновым агентам требуется хранение данных в течение нескольких дней.
Настройка
Подключение к GitHub
Настройка списка разрешённых IP
Базовая настройка окружения
- Команда install запускается до старта агента и ставит зависимости рантайма. Это может быть
npm install
илиbazel build
. - Терминалы запускают фоновые процессы, пока агент работает — например, поднимают веб‑сервер или компилируют protobuf‑файлы.
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
может выглядеть так:
Модели
Цены
Безопасность
- Дай нашему GitHub‑приложению права чтения и записи для репозиториев, которые хочешь редактировать. Это нужно, чтобы клонировать репозиторий и вносить изменения.
- Твой код выполняется в нашей инфраструктуре AWS в изолированных виртуальных машинах и хранится на дисках этих VM, пока агент активен.
- У агента есть доступ к интернету.
- Агент автоматически запускает все команды терминала, чтобы итеративно прогонять тесты. В отличие от агента на переднем плане, который требует твоего подтверждения для каждой команды. Автозапуск повышает риск утечки данных: злоумышленники могут проводить атаки с внедрением подсказок (prompt injection), заставляя агента загружать код на вредоносные сайты. См. объяснение OpenAI о рисках prompt injection для фоновых агентов.
- Если режим Privacy отключён, мы собираем подсказки (prompts) и данные дев‑сред для улучшения продукта.
- Если ты отключишь режим Privacy при запуске фонового агента, а затем включишь его во время работы агента, агент продолжит работу с отключённым режимом Privacy до завершения.
Настройки дашборда
Настройки по умолчанию
- Модель по умолчанию – модель, используемая, когда запуск не указывает конкретную. Выбери любую модель, которая поддерживает 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 и любые подключённые внешние каналы.