Облачные агенты
Облачные агенты используют те же базовые принципы работы агентов, но работают в изолированных ВМ в облаке с полноценной инфраструктурой разработки, а не на вашем локальном компьютере. Инфраструктура разработки похожа на настройку на вашем ноутбуке: клонированные репозитории, установленные зависимости, секреты, команды запуска и сетевой доступ.
Эффективные инфраструктуры разработки дают агентам полный контекст по вашей кодовой базе и организации, чтобы они могли тестировать и проверять результаты своей работы.
Зачем использовать облачных агентов?
Вы можете запускать сколько угодно агентов параллельно, и для их работы не нужно, чтобы ваш локальный компьютер был подключён к интернету.
Поскольку у них есть доступ к собственной виртуальной машине, облачные агенты могут собирать, тестировать и взаимодействовать с изменённым ПО. Они также могут использовать компьютеры для управления рабочим столом и браузером. Облачные агенты поддерживают MCP-серверы, что даёт им доступ к внешним инструментам и источникам данных, таким как базы данных, API и сторонние сервисы.
Облачные агенты также могут работать в инфраструктуре для нескольких репозиториев. Используйте её, когда задача охватывает отдельные репозитории фронтенда, бэкенда, инфраструктуры или общих библиотек. Агент может проверить всё рабочее пространство, внести скоординированные изменения и открыть pull request в репозиториях, которые он изменяет.
Как получить доступ
Прежде чем кто-либо сможет запустить облачного агента из репозитория, администратор аккаунта Cursor должен подключить для аккаунта систему контроля версий. Настройте GitHub (Cloud and Enterprise Server), GitLab (Cloud and Self-Hosted), Bitbucket Cloud или Azure DevOps.
Вы можете запускать облачных агентов везде, где работаете:
- Cursor для iOS: Запускайте агентов и управляйте ими в приложении Cursor для iOS
- Cursor Web: Запускайте агентов и управляйте ими на cursor.com/agents с любого устройства
- Cursor Desktop: Выберите Cloud в раскрывающемся списке под полем ввода агента
- Slack: Используйте команду @cursor, чтобы запустить агента
- GitHub or Bitbucket: Оставьте комментарий
@cursorв GitHub PR или issue либо в Bitbucket PR, чтобы запустить агента - Linear: Используйте команду @cursor, чтобы запустить агента
- API: Используйте API, чтобы запустить агента
На Android используйте cursor.com/agents в Chrome и нажмите Установить приложение, чтобы установить Progressive Web App (PWA). Подробнее см. в Cursor для iOS: там есть информация о нативном приложении для iPhone и iPad и других вариантах для мобильных устройств.
Использование Cursor в Slack
Подробнее о настройке и использовании интеграции Slack, включая запуск агентов и получение уведомлений.
Как это работает
Подключение провайдера репозитория
Облачные агенты клонируют ваш репозиторий из GitHub, GitLab, Azure DevOps Services или Bitbucket Cloud, работают в отдельной ветке, а затем отправляют изменения в ваш репозиторий, чтобы передать работу вам.
Вам потребуются права на чтение и запись к вашему репозиторию, а также ко всем зависимым репозиториям и подмодулям.
Инфраструктуры
Возможности агентов напрямую зависят от инфраструктуры, в которой они работают. Агент, который умеет писать код, но не может запускать тесты, обращаться к сервисам или API, не способен довести задачу до конца.
Не настроить инфраструктуру разработки для ваших облачных агентов — всё равно что не дать инженерам компьютер. Поэтому настройка инфраструктуры — самый важный шаг для повышения эффективности облачных агентов. Она позволяет облачным агентам работать как инженеры: писать код, тестировать и проверять результаты, а затем выпускать ПО.
Вы можете настроить инфраструктуры с помощью настройки под управлением агента, сохранённого snapshot или Dockerfile в .cursor/environment.json. См. настройка облачного агента, чтобы начать. Сборки подготавливают каждую инфраструктуру в фоновом режиме, чтобы агенты запускались с готовыми репозиториями и зависимостями.
Дашборд облачных агентов показывает, какую инфраструктуру и сборку использовал агент, а также сведения об инфраструктуре и историю версий. На странице агента наведите курсор на имя репозитория в верхней части страницы, чтобы посмотреть, какая инфраструктура использовалась для этого запуска. Подробности конфигурации см. в разделе настройка облачного агента.
Управление средой выполнения и инфраструктурой
Cursor управляет выделением VM, изоляцией, snapshots, запуском, артефактами и ресурсами для каждого Cloud Agent. Вы можете добавлять секреты, ограничивать исходящие домены, подключаться к приватным сетям через Tailscale или аналогичный клиент и использовать приватное подключение для поддерживаемых путей доступа к системе контроля версий.
См. безопасность и сеть Cloud Agent, чтобы ознакомиться с полным набором настроек инфраструктуры и сети. Если вы решаете, переходить ли на self-hosted, см. почему большинство команд начинают с Cursor Cloud.
Модели
Облачные агенты используют тщательно подобранный набор моделей. Вы можете выбрать размер контекстного окна для поддерживаемых моделей.
Поддержка MCP
Облачные агенты могут использовать MCP (Model Context Protocol)-серверы, настроенные для вашей команды. Добавлять MCP-серверы и управлять ими можно через раскрывающееся меню MCP в cursor.com/agents.
Поддерживаются транспорты HTTP и stdio. OAuth поддерживается для MCP-серверов, которым он требуется. Подробности о настройке см. в разделе возможности облачного агента.
Облачные агенты также включают встроенный Cursor Cloud MCP для диагностики запусков, включая транскрипты, события запусков, сведения об инфраструктуре и журналы настройки.
Поддержка хуков
Облачные агенты выполняют командные хуки из .cursor/hooks.json в вашем репозитории. На тарифах Enterprise они также выполняют хуки команды и хуки, централизованно управляемые в Enterprise.
Это позволяет форматтерам, скриптам аудита и проверкам политик оставаться активными, когда работа выполняется в облаке. Поддерживаемые хуки включают хуки инструментов и файлов (preToolUse, beforeShellExecution, afterFileEdit), а также хуки жизненного цикла (beforeSubmitPrompt, subagentStart / subagentStop, preCompact, afterAgentResponse / afterAgentThought и stop).
Хуки не выполняются во время ранних исследовательских шагов в среде только для чтения; они начинают работать, как только агент получает среду с возможностью записи. Некоторые хуки привязаны к IDE (хуки Tab, workspaceOpen). Хуки пользовательского уровня из ~/.cursor/hooks.json также недоступны, поскольку у облачных ВМ нет доступа к вашему локальному домашнему каталогу.
См. Хуки: поддержка облачного агента, чтобы ознакомиться с полной матрицей поддержки и подробностями.
Артефакты и управление удалённым рабочим столом
Облачные агенты создают готовые к слиянию PR с артефактами, чтобы демонстрировать внесённые изменения. Вы также можете управлять удалённым рабочим столом агента, чтобы использовать изменённое ПО.
- Артефакты: агенты создают скриншоты, видео и логи, чтобы вы могли точно видеть, что изменилось и как агент проверил свою работу.
- Управление удалённым рабочим столом: возьмите управление рабочим столом агента на себя, чтобы самостоятельно протестировать ПО в полноценной среде разработки, не переключаясь локально на ветку. Верните управление агенту, чтобы он продолжил работу.
См. возможности облачного агента, чтобы узнать подробнее об артефактах, использовании компьютера и управлении удалённым рабочим столом.
Делитесь агентами со своей командой
Отправьте коллеге по команде URL агента, и он сможет открыть запуск, чтобы увидеть диалог, изменения в коде и артефакты, созданные агентом.
Агенты видны участникам той команды Cursor, в рамках которой они были запущены. Cursor также проверяет доступ каждого пользователя к репозиторию: чтобы открыть агента коллеги по команде, подключите свой аккаунт системы контроля версий в разделе Integrations и убедитесь, что у вас есть доступ к репозиторию, в котором работал агент. Одного членства в команде для этого недостаточно.
Просмотр доступен только в режиме чтения. Чтобы участники команды могли отправлять дополнительные сообщения и продолжать работу, администратор команды может включить командные дополнительные сообщения.
Связанные страницы
- Подробнее о возможностях облачного агента.
- Подробнее о настройке облачного агента.
- Подробнее о сборках Cloud Agent.
- Подробнее о безопасности облачного агента.
- Подробнее о токенах OIDC.
- Подробнее о настройках облачного агента.
Оплата
Облачные агенты тарифицируются по ценам API для выбранной модели. Вы можете выбрать размер контекстного окна, и большее контекстное окно может увеличить использование токенов и расходы. При первом использовании вам будет предложено установить лимит расходов.
Устранение неполадок
- Убедитесь, что вы вошли в систему и подключили аккаунт GitHub, GitLab, Azure DevOps или Bitbucket.
- Проверьте, что у вас есть необходимые права доступа к репозиторию.
- У вас должен быть платный тариф Cursor.
- Убедитесь, что вы добавили секреты в cursor.com/dashboard/cloud-agents
- Секреты привязаны к рабочей области/команде; убедитесь, что используете правильный аккаунт
- Попробуйте перезапустить облачный агент после добавления новых секретов
- Если вы её не видите, убедитесь, что у вас есть необходимые права доступа
Snapshot-ы сохраняют конфигурацию вашей базовой инфраструктуры (установленные пакеты, системные зависимости и т. д.).
Если включить файлы .env.local при создании snapshot-а, они будут сохранены. Однако для управления переменными инфраструктуры рекомендуется использовать вкладку Secrets
в Cursor Settings.
- Участник команды должен состоять в той же команде Cursor, что и вы.
- Ему нужно подключить собственный аккаунт системы контроля версий в разделе Integrations и иметь доступ к репозиторию, в котором работал Agent.
- Подробности см. в разделе Share agents with your team.
Убедитесь, что администратор рабочей области установил приложение Cursor для Slack и что у вас есть необходимые права доступа.
История названия
Ранее облачные агенты назывались фоновыми агентами.