Cursor Cloud Agents Snapshots — это зашифрованные point-in-time копии диска виртуальной машины Cloud Agent. Они ускоряют старт и resume: не нужно заново клонировать репозиторий и прогонять весь setup. Канон retention: Secrets & Network → Data retention; связь с Builds — Cloud Agent Builds.

Соседи: Cloud Agent Environment, Secrets, Background / Cloud Agents. Pillar: n8n / автоматизация.

Два типа данных Cloud Agent

Тип данных Что внутри Retention по умолчанию Удаление
Conversation history Промпты, ответы, tool calls, demo-артефакты Indefinite (Enterprise может выбрать 90 дней) Delete Agent API или team retention policy
Environment snapshots Encrypted disk image VM 90 дней inactivity (rolling) Авто по окну; on-demand delete в доке нет

Сверка: cursor.com/docs/cloud-agent/security-network (проверка 2026-09-18). Custom retention windows — early access Enterprise; hard ₽ не публикуем.

Snapshot vs Build vs Dockerfile

  • Saved snapshot / Dockerfile задаёт base machine.
  • Build стартует с этой базы, клонирует репо на default branch, гоняет install, сохраняет disk state с версией среды и commit SHA.
  • Итог Build — новый bootable snapshot, с которого стартуют агенты, automations и code reviews.

Дока Builds прямо отвечает: Builds не заменяют snapshots или Dockerfiles — они поверх них.

Как попасть в environment.json

{
  "snapshot": "snapshot-20260212-00000000-0000-0000-0000-000000000000",
  "install": "npm install"
}

ID snapshot берите со страницы Environments в dashboard. Если запрошенный snapshot нельзя использовать, Cursor падает на default base image, оставляет остальной конфиг и всё равно гоняет install — setup может «починить» среду при старте.

Что не сохраняется

Builds и snapshots хранят только диск. Docker daemon, БД, tunnel, exported shell vars после snapshot не живут. Кладите их в start / terminals или в секцию Cloud-specific внутри AGENTS.md.

Если при снятии snapshot вы включили .env.local в образ — файлы могут оказаться доступны агентам. Дока всё равно рекомендует Secrets tab как основной путь.

Retention: 90 дней rolling

  1. Snapshot живёт, пока им пользуются.
  2. Каждый start/resume с этого snapshot сдвигает expiry на +90 дней.
  3. 90 дней без использования → автоудаление, независимо от плана.
  4. Enterprise team admin может ограничить conversation history до 90 дней; snapshots при этом всё равно на rolling 90-day inactivity.

Маршрут на один вечер

  1. Сделайте agent-driven setup среды до зелёного Build (см. Environment).
  2. Зафиксируйте snapshot ID в .cursor/environment.json или положитесь на active Build в dashboard.
  3. Не кладите долгоживущие сервисы в install — только disk prep.
  4. Проверьте, что редкие среды не «протухнут» за 90 дней без ранов.
  5. Conversation cleanup — через Delete Agent API / team policy; snapshot руками не ждите.

Типичные ошибки

  • Путать snapshot с conversation history и ждать, что Delete Agent API сотрёт образ диска.
  • Считать, что snapshot = «замороженные процессы».
  • Хранить секреты только в .env.local внутри snapshot вместо Secrets tab.
  • Игнорировать fallback на default image, когда snapshot ID устарел.
  • Публиковать hard ₽ за storage snapshots — в доке отдельного прайса нет.

FAQ: Cursor Cloud Agents Snapshots

Что такое Cursor Cloud Agents Snapshots?

Environment snapshot — зашифрованная point-in-time копия диска VM Cloud Agent. Нужна, чтобы стартовать или резюмить без recloning и повторного setup. Канон: security-network + setup + builds docs.

Чем snapshot отличается от Build?

Saved snapshot или Dockerfile — база машины. Build клонирует репо, гоняет install и делает свежий bootable snapshot. Build не заменяет snapshot: он поверх него.

Сколько хранятся snapshots?

По доке: максимум 90 дней inactivity. Каждый старт/resume с snapshot продлевает окно ещё на 90 дней. Неиспользованный snapshot удаляется автоматически.

Можно ли удалить snapshot по запросу?

Delete Agent API удаляет conversation history и артефакты, но не environment snapshots. Snapshots живут по retention window, on-demand delete в доке нет.

Что сохраняет snapshot: процессы или только диск?

Только disk state. Running processes, shell exports и in-memory caches не переносятся. Сервисы поднимайте через start/terminals.

Можно ли ссылаться на snapshot в environment.json?

Да. Пример из setup: поле snapshot с ID из dashboard Environments + install команда. Если snapshot недоступен, Cursor падает на default base image и предупреждает.

Вывод

Snapshots — disk checkpoint Cloud Agent с retention 90 дней inactivity. Base для Builds, не замена Secrets и не замена start-команд. Дальше по цепочке — Cloud Agent Builds и Secrets.

Артём Денисов — эксперт Нетологии и автор курса Яндекс Практикума по промпт-инжинирингу. Сверяет retention snapshots и связь с Builds по официальным docs Cursor.

Хотите нейросети под свои задачи, а не «для всех»?

Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артём Денисов — все форматы на странице обучения. Тех-pillar — n8n для начинающих.