Инструменты · Снапшоты
snapshot_write
Создаёт точку сохранения всех файлов проектов рабочей области, переименовывает её метку и удаляет снапшоты. Снапшот перед серией правок — главное правило безопасной работы с агентом.
Когда использовать
- Перед любой серией правок агента —
createс понятной меткой. - Метку нужно исправить —
update. - Лишний снапшот —
delete; из середины списка — сforce: true.
Соседние инструменты домена «Снапшоты»
Операции
| operation | Что делает | Нужно передать |
|---|---|---|
create | Снимок всех отслеживаемых файлов проектов. Если изменений нет — возвращает существующий снапшот с пометкой. Первый снапшот большой конфигурации, не уложившийся примерно в 15 секунд, уходит в фон: ответ 🔵 running с идентификатором задачи, прогресс — в snapshot_read list. | по желанию label |
update | Переименовывает метку. Снапшот и все более поздние получают новые идентификаторы — ответ приводит соответствие «старый → новый»; более ранние не меняются. | snapshot_id, label |
delete | Удаляет снапшот. Последний — сразу; из середины списка — только с force: true, и более поздние снапшоты получают новые идентификаторы. | snapshot_id; для середины списка — force |
Параметры
| Параметр и тип | Обязательный | Описание | По умолчанию |
|---|---|---|---|
operationстрока | да | Операция инструмента — значения и их смысл в таблице «Операции».значения: create · update · delete | — |
labelстрока | для update | Метка до 200 символов. Для create — по желанию (без неё — дата и время), для update — обязательна. | — |
snapshot_idстрока | для update, delete | Идентификатор снапшота — для update и delete. | — |
forceбулево | нет | Для delete: подтвердить удаление снапшота из середины списка — идентификаторы более поздних снапшотов изменятся. | false |
titleстрока | нет | Необязательная подпись вызова до 40 символов: клиент показывает её в шапке карточки вызова. На результат не влияет. | — |
Таблица собрана из схемы инструмента, которую получает агент при подключении.
Адреса
Адрес fqn не используется: снапшот охватывает все проекты рабочей области.
Пример вызова и ответа
{ "operation": "create", "label": "до отчёта по остаткам" }Пример ответа в подготовке Устройство ответа — на странице Формат ответов.
Отказы и ошибки
Удаление из середины без подтверждения
Ответ перечисляет зависимые снапшоты и просит force: true: их идентификаторы изменятся.
Занято
Во время фонового создания снапшота удаление и переименование отвечают отказом «занято» — дождитесь окончания по snapshot_read list.
failed · Unknown operation
Неизвестное значение operation. В ответе — fix_hint: supported: … со списком допустимых операций и секция Did you mean. Допустимо: create, update, delete.
failed · лицензия
Без действующего ключа инструмент отвечает карточкой failed с сообщением лицензия: … и подсказкой, где ввести ключ; в секции Context — список инструментов, доступных без ключа. Подробнее — Лицензия и бесплатный доступ.
Ограничения
- По умолчанию хранится до 100 снапшотов, не дольше 30 дней и не больше 1 ГБ; старые удаляются автоматически. Настройки — Window → Preferences → Кванта (Quanta) → Снапшоты.
- Правки, сделанные во время фонового создания, могут попасть в снапшот частично.
- Один набор снапшотов на рабочую область: его видят все агенты, работающие с ней.