- Подходят задания с понятным входом и результатом: добавить тест, исправить воспроизводимую ошибку, обновить документацию, подготовить небольшой интерфейс.
- Агент работает в отдельной виртуальной машине.
- В репозитории frontend исправь компонент таблицы, чтобы на экранах шириной 360 пикселей длинные значения переносились внутри ячеек.
- Cloud Agents могут работать одновременно.
- Отчёт агента — ориентир, а не доказательство исправности.
Cursor Cloud Agents выполняют задачи в изолированной облачной среде и могут работать с репозиторием, когда локальный компьютер занят другими делами. Это удобно для небольших самостоятельных функций, подготовки тестов и исправлений. Но удалённый агент не знает вашу инфраструктуру автоматически: нужно заранее настроить окружение, права на репозиторий, зависимости и критерии принятия результата.
Какие задачи стоит отдавать облачному агенту
Подходят задания с понятным входом и результатом: добавить тест, исправить воспроизводимую ошибку, обновить документацию, подготовить небольшой интерфейс. Для изменения платёжной системы, секретов или критической миграции базы требуется дополнительный контроль. Действие, которое локальному разработчику занимает полдня с большим количеством ручных решений, нельзя безопасно поручать облаку без предварительного плана.
Подготовка репозитория к облачной работе
- Подключите поддерживаемый провайдер Git к рабочему пространству, если администратор разрешил доступ.
- Выберите репозиторий и определите ветку, от которой агент создаст изменение.
- Настройте установку зависимостей и команду запуска тестов.
- Используйте тестовые переменные окружения без продуктивных секретов.
- Проверьте, что проект собирается в чистом окружении.
- Задайте ожидаемый результат, запрещённые действия и критерии проверки.
- После завершения изучите diff и отчет тестов до принятия PR.
Агент работает в отдельной виртуальной машине. Если локальный проект зависит от неописанного файла или секретной настройки ноутбука, облачная сборка может не запуститься. Решение — документировать конфигурацию проекта, а не выдавать облачному агенту доступ ко всему компьютеру разработчика.
Пример задания на Cloud Agent
В репозитории frontend исправь компонент таблицы, чтобы на экранах шириной 360 пикселей длинные значения переносились внутри ячеек. Не меняй API и зависимости. Добавь тест для длинного текста. Запусти сборку. Подготовь PR с кратким описанием изменений и приложи результат проверок.
Этот запрос имеет проверяемое поведение и ограниченную область. Если облачный агент пишет, что тест не выполняется из-за окружения, сначала исправьте конфигурацию тестовой среды, а не принимайте код без проверки.
Как разделять параллельные задачи
Cloud Agents могут работать одновременно. Лучше выделять независимые области: один агент исправляет документацию, другой — тесты отдельного модуля. Если оба меняют общие компоненты, объединение может создать конфликты и регрессии. Перед запуском назначьте отдельные ветки и понятные границы. После завершения применяйте PR последовательно с повторным запуском CI.
| Риск | Проверка |
|---|---|
| Неполная среда | Сборка из чистого клона |
| Секреты | Тестовые токены с минимальными правами |
| Конфликт веток | Разделение файлов и PR |
| Лишние правки | Ручной просмотр diff |
| Неучтённый расход | Лимиты и журнал облачных задач |
Как принимать результат
Отчёт агента — ориентир, а не доказательство исправности. Посмотрите, какие файлы изменены, какие команды запускались и что показали тесты. Проверьте отсутствие неизвестных зависимостей, изменение прав доступа и попадание секретов в лог. Для пользовательского интерфейса откройте предпросмотр и пройдите важные действия. После одобрения PR повторите тесты уже в основной ветке.
Как работает безопасность и Privacy Mode
Облачные агенты поддерживают Privacy Mode, но перед передачей корпоративного репозитория всё равно нужно проверить договорные условия, доступность по региону и разрешённые инструменты. Подключение MCP увеличивает число внешних действий; ограничивайте права каждого сервера. Для общей политики данных предусмотрена статья Cursor для бизнеса.
Отличие от Automations
Cloud Agent запускается для конкретной порученной задачи. Cursor Automations создаёт условия для автоматического старта подобных агентов по событиям и расписанию. Если требуется проверять каждый новый PR без ручной команды, используйте настройку Automations.
Сколько стоит удалённая задача
Расход зависит от модели, длительности и используемых инструментов. Сравнивайте общую стоимость нескольких попыток с количеством принятых изменений. Подробная схема расчёта есть в статье о тарифах Cursor.
Запуск первого Cloud Agent через интерфейс
Откройте Agents Window в Cursor и выберите Cloud под полем ввода либо перейдите в управление агентами через веб-интерфейс аккаунта. Перед запуском администратор должен подключить совместимый Git-провайдер и разрешить доступ к нужному репозиторию. Если репозиторий ещё не подключён, сначала настройте интеграцию, а не выдавайте агенту личные токены в тексте запроса.
- Выберите репозиторий и ветку, от которой агент должен начать работу.
- Создайте или выберите сохранённое облачное окружение в Cloud Agents dashboard.
- Подготовьте установку зависимостей, команду тестов и, если требуется, безопасные переменные окружения.
- Проверьте сборку в чистом окружении. Облачный агент работает в отдельной виртуальной машине Ubuntu, а не с несохранёнными файлами вашего компьютера.
- Сформулируйте узкую задачу и запреты, запустите Agent, затем проверьте diff и журналы тестов.
- Примите подготовленный PR только после независимой проверки, особенно если затронуты API, миграции или безопасность.
Для повторяемой настройки окружения можно использовать конфигурацию в .cursor/environment.json, а для сложной среды — Dockerfile. Проверяйте, что выбранное облачное окружение действительно использует нужную конфигурацию и Build. Если локальные правки не закоммичены, их отсутствие в удалённой ветке не означает ошибку агента: сначала перенесите необходимые изменения в доступный ему репозиторий.
Когда удобнее CLI вместо облака
Cloud Agent полезен для удалённой сборки и PR, а Cursor CLI — для задач непосредственно в собственном терминале. Для регулярного запуска по событиям предусмотрен Cursor Automations. Не настраивайте повторяющиеся запуски, пока не проверили стоимость и результат одиночного задания.
Что делать при неуспешной сборке?
Проверьте логи окружения и воспроизводимость установки зависимостей. Не принимайте PR, который удалось проверить лишь на локальном ноутбуке автора без чистой сборки.